Aller au contenu
Cabinet d'expertise en transformation technologique · ARDIANE Group Innover, sécuriser, réussir

Lexique

API gateway : définition de la passerelle d'API, fonctions et limites

Domaine

Ingénierie

L'essentiel

Une API gateway, ou passerelle d'API, est le composant placé devant un ensemble de services pour offrir à leurs clients un point d'entrée unique : elle reçoit chaque appel, l'achemine vers le service concerné et peut assurer des fonctions communes, comme l'authentification ou la limitation de débit. La notion vient de l'usage et de patrons d'architecture publiés.

Sommaire de la page

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.

FAQ

Questions fréquentes

Une autre question ? Posez-la-nous

Qu'est-ce qu'une API gateway ?

Une API gateway, ou passerelle d'API, est un composant logiciel placé entre des applications clientes et les services qu'elles appellent. Les clients s'adressent à elle seule : elle reçoit leurs appels, les achemine vers le service concerné et peut assurer des fonctions communes, comme l'authentification ou la limitation de débit. La notion relève de l'usage : elle est décrite par des patrons d'architecture publiés et par des documentations d'éditeurs.

Quelle différence entre une API gateway et un reverse proxy ?

Un reverse proxy, ou proxy inverse, est un serveur intermédiaire qui reçoit les requêtes à la place des serveurs d'application. La documentation d'architecture de Microsoft Azure présente l'API gateway comme un composant qui agit en proxy inverse, peut assurer des tâches transverses comme l'authentification ou la limitation de débit, et peut agréger plusieurs appels. La même page cite des proxys inverses tels que NGINX et HAProxy parmi les moyens de réaliser une passerelle.

Que désigne le modèle backends for frontends ?

Le modèle backends for frontends est une variante du patron API gateway décrite sur le site microservices.io. Une passerelle distincte y est définie pour chaque type de client, par exemple une pour l'application web, une pour l'application mobile et une pour les applications de tiers. Chaque passerelle expose l'API adaptée à son client.

Un service mesh remplace-t-il une API gateway ?

L'API gateway et le service mesh visent des trafics différents. L'API gateway reçoit les appels qui viennent des clients et entrent dans l'application. Le service mesh, ou maillage de services, est une couche d'infrastructure, faite de proxys réseau, qui gère les échanges entre les services eux-mêmes. Les deux peuvent se combiner, et un maillage peut fournir sa propre passerelle d'entrée.

Un projet à faire aboutir ?

Un premier échange suffit pour situer votre enjeu, identifier les bons interlocuteurs et vous dire franchement ce que nous pouvons apporter.