Qu'est-ce que les systèmes de gestion des API

Pourquoi sont-ils nécessaires et quelles fonctions ils remplissent.

Bonjour à tous! Je m'appelle Anton et je suis ingénieur au sein de l'équipe responsable du développement des services informatiques centralisés utilisés par les équipes produits de X5 Retail Group.

Dans cet article, je parlerai des systèmes de la classe API Management et en particulier d'APIM Gravitee ( https://www.gravitee.io ), ce qu'est cette classe de systèmes, comment ils sont utilisés pour répondre aux besoins des équipes de développement. L'article ne plonge pas dans les aspects techniques, mais il peut être utile pour les architectes et les gestionnaires qui envisagent d'essayer d'utiliser cette classe de systèmes, mais ne savent pas s'ils conviennent à leurs tâches, ainsi que pour les développeurs qui pourraient découvrez de nouveaux outils pour un travail pratique avec l'API.

Qu'est-ce que les systèmes de gestion des API

Définition

API Management - - (API), , , , . 

, API Management - , , , API .

"API Management" , API , , . , , , API.

?

, API . ? - . "". API, : , .. API, , , . API : , , , / IP. , JSON , DevOps rate limit, DoS , : Service Discovery, Load Balancing, Blue/Green Canary deploy. 

API Management (. . 1):

1. Management Core: , , , , API Gateways API, CORS, Failover, Healthcheck, API .

   
   
   
   
   

2. Web/Development Portal: UI, , API, healthcheck , , API.

   
   
   
   
   

3. API Gateways: , , , healthcheck Backend API.

   
   
   
   
   

4. Backend API: - .

   
   
   
   
   

5. Databases: API Management, API, API Gateways, backend, healthcheck, API Management.

   
   
   
   
   

API Management

:

• : .

  
  
  
  
  

• :  , , Keycloak.

  
  
  
  
  

• : API.

  
  
  
  
  

• API: / .

  
  
  
  
  

• : / API.

  
  
  
  
  

:

• Latency: / .

  
  
  
  
  

• TCO: , , nginx . 

  
  
  
  
  

API Gateways

API Gateways ( ), (. . 2). API Gateways /, . API Gateways , / . API Gateways , . API Gateways, , (L7) OSI.

 API Gateways

API Gateways:

• Local API Gateways  .

  
  
  
  
  

• DMZ API Gateways  .

  
  
  
  
  

, , . . - .

Gravitee

X5 Retail Group APIM Gravitee (https://www.gravitee.io). – API DMZ.

:

• 23

  
  
  
  
  

• 69 API Gateways

  
  
  
  
  

• 400

  
  
  
  
  

• 350 RPS

  
  
  
  
  

• 30 000 000+

  
  
  
  
  

, APIM Gravitee.

1. Identity provider: :

   
   
   
   
   

1. MongoDB ( , );

   
   
   
   
   

2. In-memory ( admin);

   
   
   
   
   

3. LDAP / Active Directory;

   
   
   
   
   

4. OpenID Connect IdP (Azure AD, Google);

   
   
   
   
   

2. Fetchers: API :

   
   
   
   
   

2. File (Swagger, OpenAPI);

   
   
   
   
   

3. HTTP;

   
   
   
   
   

4. GIT;

   
   
   
   
   

3. Policies: , . . -, - . :

   
   
   
   
   

3. API Key - API-;

   
   
   
   
   

4. Rate-limiting - backend;

   
   
   
   
   

5. Transform Headers/Transform Query Parameters - ;

   
   
   
   
   

6. etc.

   
   
   
   
   

Gravitee Gateway 30 . . , "", . 

4. Reporters: . :

   
   
   
   
   

4. Reporter file;

   
   
   
   
   

5. Elasticsearch;

   
   
   
   
   

6. Accesslog;

   
   
   
   
   

, :

4. / — , , , api-;

   
   
   
   
   

5. — , , , - ..;

   
   
   
   
   

6. — , , ;

   
   
   
   
   

5. Repositories: - API, , , . :

   
   
   
   
   

5. MongoDB ( );

   
   
   
   
   

6. Redis;

   
   
   
   
   

7. Elasticsearch;

   
   
   
   
   

8. PostgreSQL ( JDBC );

   
   
   
   
   

6. Resources: , :

   
   
   
   
   

6. OAuth2 ( OAuth2 );

   
   
   
   
   

7. Cache ( );

   
   
   
   
   

8. LDAP ( LDAP );

   
   
   
   
   

7. Services: , :

   
   
   
   
   

7. Sync ( );

   
   
   
   
   

8. local-registry ( API json . , API - rest API ( json API, .));

   
   
   
   
   

9. health-check ( );

   
   
   
   
   

10. monitor ( , os / process / jvm, );

    
    
    
    
    

8. Notifiers: . , , Slack.

   
   
   
   
   

8. Email;

   
   
   
   
   

9. Alerts: , Notifier.

   
   
   
   
   

9. Vertx;

   
   
   
   
   

: https://github.com/gravitee-io, Java, .

API

API :

1. API

   
   
   
   
   

2. 
   
   
   
   

3. API

   
   
   
   
   

API

API , API

, :

1. !

   
   
   
   
   

2. swagger .

   
   
   
   
   

3. Git/URL
   
   
   
   .

   
   
   
   
   

, "->"

API 5

API, , , API .

:

Simple mode backend api, : https://backend-server/backend-api/

Advanced mode   backend api, tenant sharding tags.

tenant - Elasticsearch .

sharding tags - , API Gateways

Plan

Plan - , , Gateway.

Name -  

Security type -  : Keyless(public), API Key, JWT, OAuth2

Description -

Rate limit - - /

Quota -  - ///

Path authorization -

API.

API

swagger.json

API.

" API ", " API"

CREATE API .

 

API . API , - "keyless". , .

:

1. Tags (. . 3)

   
   
   
   
   

2. (. . 4)

3. Rate Quota (. . 5)

4. , (. . 6)

, , Management API, . , , . , , ,  APIM Gravitee  . , , .