Définition de l’API gateway
Une API gateway, en français passerelle d’API, est un composant logiciel placé entre des applications clientes et les services qu’elles appellent. Les clients ne connaissent qu’elle : elle reçoit leurs appels et les transmet aux services concernés. La notion relève de l’usage : elle se lit dans des patrons d’architecture publiés et dans des documentations d’éditeurs.
Sur le site microservices.io, Chris Richardson rattache le patron « API gateway » à l’architecture microservices et le décrit comme un point d’entrée unique pour tous les clients : la passerelle relaie certaines demandes vers un service et répond à d’autres en interrogeant plusieurs services. Le centre d’architecture de Microsoft Azure en donne une lecture voisine : un point d’entrée centralisé, qui agit en proxy inverse et peut assurer des tâches transverses.
Ce que la passerelle épargne aux clients et aux services
Sans passerelle, chaque client s’adresse à chaque service. La page de Microsoft en relève les conséquences : un code client plus complexe, lié au découpage interne de l’application, des allers-retours réseau multipliés pour une même opération, et l’authentification ou le chiffrement à traiter dans chaque service exposé.
La page de microservices.io ajoute que le découpage en services peut changer et gagne à rester caché des clients. Lors d’une refonte par étapes, une passerelle peut tenir le rôle de la façade de routage que présente notre page sur la modernisation applicative.
Routage, agrégation, délestage : les fonctions d’une API gateway
La documentation de Microsoft range les usages en trois patrons, traduits ici.
- Le routage (gateway routing) : la passerelle dirige chaque requête vers le service voulu, d’après son contenu applicatif (couche 7).
- L’agrégation (gateway aggregation) : le client envoie une seule requête, la passerelle appelle plusieurs services et assemble leurs réponses.
- Le délestage (gateway offloading) : des fonctions transverses sont assurées une fois pour tous les services, par exemple la terminaison TLS, le TLS mutuel, l’authentification, la limitation de débit ou la journalisation.
API gateway, proxy inverse, répartiteur de charge, service mesh, API management : ne pas confondre
Ces termes relèvent de l’usage, et leurs périmètres se recouvrent d’un produit à l’autre.
| Notion | Ce qu’elle désigne | Rapport avec la passerelle |
|---|---|---|
| Proxy inverse (reverse proxy) | Un serveur intermédiaire qui reçoit les requêtes à la place des serveurs d’application, tel que NGINX ou HAProxy | La passerelle en est un, spécialisé dans les API |
| Répartiteur de charge | La distribution des requêtes entre les instances d’un même service | Selon le produit, la passerelle l’assure ou s’appuie sur un répartiteur voisin |
| Service mesh (maillage de services) | Une couche de proxys réseau qui gère les échanges entre services, comme Istio ou Linkerd | La passerelle traite les appels venus des clients, le maillage les échanges internes |
| API management | La discipline et l’outillage du cycle de vie des API | La passerelle en est le composant d’exécution |
Inventaire, portail développeur et politique de versions sont décrits dans la fiche API management.
Les limites d’un passage obligé
La page de microservices.io retient deux inconvénients : un composant de plus à développer, à déployer et à exploiter, et un temps de réponse allongé par un saut réseau supplémentaire. La position de la passerelle peut en créer un troisième : tous les appels la traversent, et son indisponibilité peut couper l’accès à l’ensemble des services. La même page prévoit qu’elle appelle les services au travers d’un circuit breaker.
Exemple : l’espace client d’un assureur
Imaginons un assureur habitation dont l’espace client existe en site web et en application mobile. Contrats, sinistres et paiements sont servis par trois services distincts. L’application mobile appelle une seule adresse, celle de la passerelle. Celle-ci vérifie le jeton d’accès, applique le quota d’appels fixé pour l’application, puis route la demande. Pour l’écran d’accueil, elle interroge les trois services et renvoie une réponse assemblée.
Si le service des sinistres est scindé en deux, seules les règles de routage changent : l’application mobile n’a pas à être republiée.
Où placer une passerelle, combien en déployer, quelles règles de gestion tenir hors d’elle : ces décisions relèvent de l’architecture SI, dont la page détaille les règles d’intégration.