---
title: "Utiliser Apache APISIX et Authing pour mettre en œuvre une gestion centralisée de l'authentification - API7.ai"
description: "Introduction à Apache APISIX \nApache APISIX est une solution API dynamique, en temps réel et haute performance..."
url: "https://api7.ai/fr/blog/apisix-authing-integration"
---
[Blog](https://api7.ai/fr/blog)
[Products](https://api7.ai/fr/category/products)[Technology](https://api7.ai/fr/category/technology)[Ecosystem](https://api7.ai/fr/category/ecosystem)[Case Study](https://api7.ai/fr/category/usercase)[Team & Community](https://api7.ai/fr/category/community)
Search
⌘ + K
[Blog](https://api7.ai/blog)
Ecosystem
# Utiliser Apache APISIX et Authing pour mettre en œuvre une gestion centralisée de l'authentification
API7.ai
January 4, 2022
[Ecosystem](https://api7.ai/category/ecosystem)
## Introduction
### À propos d'Apache APISIX
[Apache APISIX](https://github.com/apache/apisix) est une passerelle API dynamique, en temps réel et haute performance qui offre des fonctionnalités riches de gestion du trafic telles que l'équilibrage de charge, le routage dynamique, les déploiements canaris, la gestion des pannes de service, l'authentification, l'observabilité, etc. Apache APISIX prend en charge non seulement les changements dynamiques de plugins et le branchement à chaud, mais dispose également de nombreux plugins utiles. Le plugin OpenID Connect pour Apache APISIX, avec son support du protocole OpenID Connect, permet aux utilisateurs d'utiliser ce plugin pour permettre à Apache APISIX d'interagir avec les services Authing et d'être déployé comme une passerelle d'authentification centralisée dans l'entreprise.
### À propos d'Authing
[Authing](https://www.authing.cn/) est le premier produit cloud d'identité centré sur les développeurs en Chine, intégrant tous les protocoles d'identité mainstream et fournissant des services complets et sécurisés de gestion de l'authentification et de l'accès pour les entreprises et les développeurs. Avec "API First" comme pierre angulaire du produit, toutes les fonctions courantes dans le domaine de l'identité sont encapsulées de manière modulaire, et toutes les capacités sont exposées aux développeurs via un SDK en langage de programmation full-scene. Parallèlement, les utilisateurs peuvent utiliser de manière flexible les API RESTful ouvertes d'Authing pour étendre les fonctionnalités afin de répondre aux besoins de gestion de l'identité des différentes entreprises dans différents scénarios métiers.
## Qu'est-ce que l'authentification centralisée
### Mode d'authentification traditionnel
Dans le mode d'authentification traditionnel, chaque service d'application back-end doit développer des fonctions séparées pour prendre en charge la fonction d'authentification, comme interagir avec le fournisseur d'identité et obtenir les informations d'identité de l'utilisateur.
### Mode d'authentification centralisée
Contrairement au mode d'authentification traditionnel, le mode d'authentification centralisée extrait l'authentification de l'utilisateur du service d'application. Prenons Apache APISIX comme exemple, le processus d'authentification centralisée est illustré dans la figure ci-dessus : d'abord, l'utilisateur initie une requête, puis la passerelle frontale est responsable du processus d'authentification de l'utilisateur, en interagissant avec le fournisseur d'identité et en envoyant une demande d'autorisation au fournisseur d'identité. Le fournisseur d'identité renvoie les informations de l'utilisateur. Après que la passerelle a terminé l'identification de l'utilisateur, elle transmet les informations d'identité de l'utilisateur à l'application back-end sous forme d'en-tête de requête.
### Avantages du mode d'authentification centralisée
Par rapport au mode d'authentification traditionnel, le mode d'authentification centralisée présente les avantages suivants.
1. Simplifie le processus de développement des applications, réduit la charge de travail de développement et les coûts de maintenance, et évite le développement répété de la logique d'authentification pour chaque application.
2. Améliore la sécurité des activités, le mode d'authentification centralisée au niveau de la passerelle peut intercepter les requêtes non authentifiées à temps pour protéger les applications back-end.
En même temps, combiné avec les puissantes fonctions de gestion de l'authentification d'Authing, les fonctions suivantes peuvent être réalisées.
1. Gestion du cycle de vie des services d'authentification via la console, y compris la création, l'activation, la désactivation, etc.
2. Surveillance visuelle en temps réel des applications, y compris : le nombre de requêtes d'interface, la latence des appels d'interface et les informations d'erreur d'interface, ainsi que des notifications d'alarme en temps réel.
3. Journalisation centralisée pour visualiser facilement les connexions, déconnexions des utilisateurs et les informations sur les ajustements et modifications de l'application.
Plus de détails peuvent être trouvés dans [Authing Access Gateway](https://www.authing.cn/gateway-integration).
## Comment implémenter l'authentification centralisée avec Apache APISIX et Authing
### Étape 1 : Configurer Authing
1. Connectez-vous à votre compte Authing, sélectionnez "Build your own app" et remplissez le nom de l'application et l'adresse d'authentification. Si vous n'avez pas de compte Authing, veuillez visiter [Authing](https://www.authing.cn/), cliquez sur "Login/Register" dans le coin supérieur droit pour enregistrer un compte Authing. 
2. Cliquez sur "Create" pour créer une application Authing. 
3. Pendant le processus d'authentification, Authing rejettera les URL de rappel autres que celles configurées. Comme il s'agit d'un test local, l'URL de rappel de connexion et l'URL de rappel de déconnexion sont toutes deux définies sur l'adresse d'accès APISIX . 
4. Créer un utilisateur (optionnel). Sur la page de la liste des utilisateurs, créez un utilisateur avec le compte et le mot de passe user1/user1, et vous pouvez définir si l'accès à l'application est autorisé dans la page "User Information - Authorization Management" (par défaut, l'accès est autorisé). 
5. Visitez la page de l'application pour la configuration suivante, qui est nécessaire lors de la configuration du plugin OpenID Connect d'Apache APISIX.
1. App ID : ID client OAuth, c'est-à-dire l'ID de l'application, correspondant à `client_id` et `{YOUR_CLIENT_ID}` ci-dessous.
2. App secret : Clé secrète client OAuth, c'est-à-dire la clé de l'application. Correspond à `client_secret` et `{YOUR_CLIENT_SECRET}` ci-dessous.
3. Service\_discovery\_address : L'adresse de découverte du service de l'application. Correspond à `{YOUR_DISCOVERY}` ci-dessous. 
### Étape 2 : Installer Apache APISIX
Vous pouvez installer Apache APISIX de plusieurs manières, y compris via des packages sources, Docker, Helm Chart, etc.
#### Installer les dépendances
L'environnement d'exécution d'Apache APISIX nécessite des dépendances sur NGINX et etcd.
Avant d'installer Apache APISIX, veuillez installer les dépendances en fonction du système d'exploitation que vous utilisez. Nous fournissons les instructions d'installation des dépendances pour CentOS7, Fedora 31 et 32, Ubuntu 16.04 et 18.04, Debian 9 et 10, et macOS. Veuillez vous référer à [Install Dependencies](https://apisix.apache.org/docs/apisix/install-dependencies/) pour plus de détails.
#### Installation via package RPM (CentOS 7)
Cette méthode d'installation est adaptée à CentOS 7 ; veuillez exécuter la commande suivante pour installer Apache APISIX.
```
sudo yum install -y https://github.com/apache/apisix/releases/download/2.7/apisix-2.7-0.x86_64.rpm
```
#### Installation via Docker
Veuillez vous référer à [Installing Apache APISIX with Docker](https://hub.docker.com/r/apache/apisix).
#### Installation via Helm Chart
Veuillez vous référer à [Installing Apache APISIX with Helm Chart](https://github.com/apache/apisix-helm-chart).
#### Installation via package source
1. Créez un répertoire nommé `apisix-2.7`.
```
mkdir apisix-2.7
```
2. Téléchargez le package source de la version Apache APISIX.
```
wget https://downloads.apache.org/apisix/2.7/apache-apisix-2.7-src.tgz
```
Vous pouvez également télécharger le package source de la version Apache APISIX depuis le site web d'Apache APISIX. La [Page de téléchargement du site officiel d'Apache APISIX](https://apisix.apache.org/downloads/) fournit également des packages sources pour Apache APISIX, APISIX Dashboard, et APISIX Ingress Controller.
3. Décompressez le package source de la version Apache APISIX.
```
tar zxvf apache-apisix-2.7-src.tgz -C apisix-2.7
```
4. Installez les bibliothèques Lua nécessaires à l'exécution.
```
# Passez au répertoire apisix-2.7
cd apisix-2.7
# Créez les dépendances
make deps
```
#### Initialisation des dépendances
Exécutez la commande suivante pour initialiser le fichier de configuration NGINX et etcd.
```
# initialisez le fichier de configuration NGINX et etcd
make init
```
### Étape 3 : Démarrer Apache APISIX et configurer la route
1. Exécutez la commande suivante pour démarrer Apache APISIX.
```
apisix start
```
2. Créez des routes et configurez le plugin OpenID Connect. La liste de configuration d'OpenID Connect est la suivante.
| Champ | Valeur par défaut | Description |
| ---------------------------------------- | --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- |
| client\_id | N/A | ID client OAuth |
| client\_secret | N/A | Clé secrète client OAuth |
| discovery | N/A | Points de terminaison de découverte de service pour les fournisseurs d'identité |
| scope | openid | Portée des ressources à accéder |
| relm | apisix | Spécifie les informations d'authentification de l'en-tête de réponse WWW-Authenticate |
| bearer\_only | false | Indique si le jeton dans l'en-tête de la requête doit être vérifié |
| logout\_path | /logout | URI de déconnexion |
| redirect\_uri | request\_uri | L'URI vers laquelle le fournisseur d'identité redirige, par défaut l'adresse de la requête |
| timeout | 3 | Temps d'expiration de la requête en secondes |
| ssl\_verify | false | Indique si le certificat SSL du fournisseur d'identité doit être vérifié |
| introspection\_endpoint | N/A | L'URL du point de terminaison d'authentification du jeton du fournisseur d'identité, qui sera extrait de la réponse de découverte si laissé vide. |
| introspection\_endpoint\_auth\_method | client\_secret\_basic | Nom de la méthode d'authentification pour l'introspection du jeton |
| public\_key | N/A | Clé publique pour l'authentification du jeton |
| token\_signing\_alg\_values\_expected | N/A | Algorithme pour les jetons d'authentification |
| set\_access\_token\_header | true | Indique si le jeton d'accès doit être porté dans l'en-tête de la requête |
| access\_token\_in\_authorization\_header | false | Le jeton d'accès est placé dans l'en-tête Authorization lorsque true, et dans l'en-tête X-Access-Token lorsque false. |
| set\_id\_token\_header | false | Indique si le jeton ID doit être porté dans l'en-tête X-ID-Token de la requête |
| set\_userinfo\_header | false | Indique si les informations de l'utilisateur doivent être portées dans l'en-tête X-Userinfo de la requête |
L'exemple de code suivant crée une route via l'API Admin d'Apache APISIX, en définissant le serveur amont de la route sur [httpbin.org](http://httpbin.org/). `httpbin.org` est un service back-end simple pour recevoir et répondre aux requêtes, la page `get` de `httpbin.org` sera utilisée ci-dessous, référez-vous à [http bin get](http://httpbin.org/#/HTTP_Methods/get_get).
Pour les éléments de configuration spécifiques, veuillez vous référer à [Apache APISIX OpenID Connect Plugin](https://apisix.apache.org/zh/docs/apisix/plugins/openid-connect/).
```
curl -XPOST 127.0.0.1:9080/apisix/admin/routes -H "X-Api-Key: edd1c9f034335f136f87ad84b625c8f1" -d '{
"uri":"/*",
"plugins":{
"openid-connect":{
"client_id":"{YOUR_CLIENT_ID}",
"client_secret":"{YOUR_CLIENT_SECRET}",
"discovery":"https://{YOUR_DISCOVERY}",
"scope":"openid profile",
"bearer_only":false,
"realm":"apisix",
"introspection_endpoint_auth_method":"client_secret_post",
"redirect_uri":"http://127.0.0.1:9080/"
}
},
"upstream":{
"type":"roundrobin",
"nodes":{
"httpbin.org:80":1
}
}
}'
```
### Étape 4 : Accéder à Apache APISIX
1. Visitez "" et la page est redirigée vers la page de connexion d'Authing car le plugin OpenID Connect est déjà activé (cette page peut être personnalisée dans la console Authing sous "Applications - Branding"). 
2. Entrez le mot de passe du compte utilisateur enregistré avec Authing, ou l'utilisateur user1/user1 créé à l'étape 1, et cliquez sur "Login" pour vous connecter au compte Authing.
3. Après une connexion réussie, vous pouvez accéder avec succès à la page get dans httpbin.org. La page httpbin.org/get renverra les données de la requête comme suit.
```
...
"X-Access-Token": "eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCIsImtpZCI6InFqeU55aVdVd2NhbUFxdEdVRUNCeFNsTWxQSWtTR2N1NmkyZzhEUk1OSGsifQ.eyJqdGkiOiJjTy16a0pCS0NSRFlHR2kyWkJhY0oiLCJzdWIiOiI2MWM5OGFmOTg0MjI4YWU0OTYyMDU4NTIiLCJpYXQiOjE2NDA1OTg4NTgsImV4cCI6MTY0MTgwODQ1OCwic2NvcGUiOiJvcGVuaWQgcHJvZmlsZSIsImlzcyI6Imh0dHBzOi8vYXBpc2l4LmF1dGhpbmcuY24vb2lkYyIsImF1ZCI6IjYxYzk4M2M0YjI4NzdkNDg2OWRkOGFjYiJ9.l2V8vDWcCObB1LjIhKs2ARG4J7WuB-0c-bnYZG2GP2zcpl6PMAPcId2B76CaXCU58ajGcfRmOlWJ67UaHrfWKv8IM4vcYN1gwhKdokSyrhEM31gQE-MzNEsEbPaVIGXdpR1N2JnAJK5-tKIjopDAXSwArfO6fQKTpjLhCi3COIA169WGRR4CKCwNzzpFAYP2ilNc18D_HRTBLS6UjxZSNUtWE5dbx7uBjblhwIwn5e1fxiEQcknVK8Dxf8NUliFECvr02HX2hNvmuCECkvA_mZYlshAeqidK8tSEXirAWsWS5jlXFqLiBJkhSHFrbxRyqeOSfJCJR_YcCwk9AzgZGg",
"X-Id-Token": "eyJhdF9oYXNoIjoiRl8tRjZaUVgtWVRDNEh0TldmcHJmUSIsImJpcnRoZGF0ZSI6bnVsbCwiZmFtaWx5X25hbWUiOm51bGwsImdlbmRlciI6IlUiLCJnaXZlbl9uYW1lIjpudWxsLCJpc3MiOiJodHRwczpcL1wvYXBpc2l4LmF1dGhpbmcuY25cL29pZGMiLCJwaWN0dXJlIjoiaHR0cHM6XC9cL2ZpbGVzLmF1dGhpbmcuY29cL2F1dGhpbmctY29uc29sZVwvZGVmYXVsdC11c2VyLWF2YXRhci5wbmciLCJwcmVmZXJyZWRfdXNlcm5hbWUiOm51bGwsInVwZGF0ZWRfYXQiOiIyMDIxLTEyLTI3VDA5OjU0OjE3Ljc3M1oiLCJ3ZWJzaXRlIjpudWxsLCJ6b25laW5mbyI6bnVsbCwibmFtZSI6bnVsbCwiaWF0IjoxNjQwNTk4ODU4LCJuaWNrbmFtZSI6bnVsbCwibm9uY2UiOiJmMTlmZjhjODM5NzdmZjNlMDczMzZmMzg3Y2QxM2EzMSIsIm1pZGRsZV9uYW1lIjpudWxsLCJleHAiOjE2NDE4MDg0NTgsInN1YiI6IjYxYzk4YWY5ODQyMjhhZTQ5NjIwNTg1MiIsImxvY2FsZSI6bnVsbCwiYXVkIjoiNjFjOTgzYzRiMjg3N2Q0ODY5ZGQ4YWNiIiwicHJvZmlsZSI6bnVsbH0=",
"X-Userinfo": "eyJ3ZWJzaXRlIjpudWxsLCJ6b25laW5mbyI6bnVsbCwibmFtZSI6bnVsbCwicHJvZmlsZSI6bnVsbCwibmlja25hbWUiOm51bGwsInN1YiI6IjYxYzk4YWY5ODQyMjhhZTQ5NjIwNTg1MiIsImxvY2FsZSI6bnVsbCwiYmlydGhkYXRlIjpudWxsLCJmYW1pbHlfbmFtZSI6bnVsbCwiZ2VuZGVyIjoiVSIsImdpdmVuX25hbWUiOm51bGwsIm1pZGRsZV9uYW1lIjpudWxsLCJwaWN0dXJlIjoiaHR0cHM6XC9cL2ZpbGVzLmF1dGhpbmcuY29cL2F1dGhpbmctY29uc29sZVwvZGVmYXVsdC11c2VyLWF2YXRhci5wbmciLCJwcmVmZXJyZWRfdXNlcm5hbWUiOm51bGwsInVwZGF0ZWRfYXQiOiIyMDIxLTEyLTI3VDA5OjU0OjE3Ljc3M1oifQ=="
...
```
**X-Access-Token** : Apache APISIX place le jeton d'accès obtenu du fournisseur d'identité dans l'en-tête de requête `X-Access-Token`, optionnellement dans l'en-tête Authorization via `access_token_in_authorization_header` dans la configuration du plugin.
**X-Id-Token** : Apache APISIX place le jeton ID obtenu du fournisseur d'identité dans l'en-tête de requête X-Id-Token après encodage base64, qui peut être activé ou désactivé par `set_id_token_header` dans la configuration du plugin.
**X-Userinfo** : Apache APISIX place les informations de l'utilisateur obtenues du fournisseur d'identité dans X-Userinfo après les avoir encodées en base64. Vous pouvez choisir d'activer ou de désactiver cette fonctionnalité en utilisant `set_userinfo_header` dans la configuration du plugin.
Comme vous pouvez le voir, Apache APISIX portera les en-têtes de requête `X-Access-Token`, `X-Id-Token` et `X-Userinfo` vers le serveur amont. Le serveur amont peut analyser ces en-têtes pour obtenir les informations d'identité de l'utilisateur et les métadonnées de l'utilisateur.
4. Dans la section "Audit Log - User Behavior Log" de la console Authing, vous pouvez observer les informations de connexion de user1. 
## Résumé
Cet article décrit les étapes détaillées pour interfacer Apache APISIX avec Authing.
Apache APISIX ne se contente pas de maintenir ses propres performances élevées, mais accorde également une grande importance à la construction de son écosystème open source. Actuellement, Apache APISIX dispose de plus de 10 plugins liés à l'authentification et à l'autorisation, prenant en charge l'interfaçage avec les services d'authentification et d'autorisation mainstream dans l'industrie.
Si vous avez besoin d'interfacer avec d'autres autorités d'authentification, visitez le [GitHub](https://github.com/apache/apisix/issues) d'Apache APISIX et laissez vos suggestions via issue ; ou abonnez-vous à la [liste de diffusion](https://apisix.apache.org/zh/docs/general/subscribe-guide) d'Apache APISIX pour exprimer vos pensées par e-mail.
Tags:
[APISIX Basics](https://api7.ai/tags/apisix-basics)
[Authing](https://api7.ai/tags/authing)
[Authentication & Authorization](https://api7.ai/tags/authentication-&-authorization)
Share article link
Share
Related Posts
[](https://api7.ai/blog/waf-and-api-gateway-integration)
## [Protéger vos API dans la nature : Une plongée approfondie dans l'intégration de WAF et API Gateway](https://api7.ai/blog/waf-and-api-gateway-integration)
[](https://api7.ai/blog/configure-tls-for-apisix)
## [mTLS partout : Comment configurer TLS pour APISIX](https://api7.ai/blog/configure-tls-for-apisix)
Table of Contents
- [Introduction](#introduction)
- [À propos d'Apache APISIX](#%C3%A0-propos-dapache-apisix)
- [À propos d'Authing](#%C3%A0-propos-dauthing)
- [Qu'est-ce que l'authentification centralisée](#quest-ce-que-lauthentification-centralis%C3%A9e)
- [Mode d'authentification traditionnel](#mode-dauthentification-traditionnel)
- [Mode d'authentification centralisée](#mode-dauthentification-centralis%C3%A9e)
- [Avantages du mode d'authentification centralisée](#avantages-du-mode-dauthentification-centralis%C3%A9e)
- [Comment implémenter l'authentification centralisée avec Apache APISIX et Authing](#comment-impl%C3%A9menter-lauthentification-centralis%C3%A9e-avec-apache-apisix-et-authing)
- [Étape 1 : Configurer Authing](#%C3%A9tape-1--configurer-authing)
- [Étape 2 : Installer Apache APISIX](#%C3%A9tape-2--installer-apache-apisix)
- [Étape 3 : Démarrer Apache APISIX et configurer la route](#%C3%A9tape-3--d%C3%A9marrer-apache-apisix-et-configurer-la-route)
- [Étape 4 : Accéder à Apache APISIX](#%C3%A9tape-4--acc%C3%A9der-%C3%A0-apache-apisix)
- [Résumé](#r%C3%A9sum%C3%A9)
## Related Posts
[](https://api7.ai/fr/blog/how-to-use-apisix-auth-with-okta)
Ecosystem
September 7, 2021
#### [Comment utiliser Apache APISIX Auth avec Okta](https://api7.ai/fr/blog/how-to-use-apisix-auth-with-okta)
Utilisation du plugin OpenID Connect d'Apache APISIX pour l'authentification centralisée des identités.
[APISIX Basics](https://api7.ai/tags/apisix-basics)
[Authentication & Authorization](https://api7.ai/tags/authentication-&-authorization)
[Okta](https://api7.ai/tags/okta)
[](https://api7.ai/fr/blog/how-to-use-apisix-auth-with-okta-2)
Ecosystem
September 7, 2021
#### [Utilisation du plugin OpenID Connect d'Apache APISIX pour l'authentification centralisée des identités](https://api7.ai/fr/blog/how-to-use-apisix-auth-with-okta-2)
L'utilisation du plugin OpenID Connect d'Apache APISIX pour configurer l'authentification Okta est...
[APISIX Basics](https://api7.ai/tags/apisix-basics)
[Authentication & Authorization](https://api7.ai/tags/authentication-&-authorization)
[Plugin](https://api7.ai/tags/plugin)
[](https://api7.ai/fr/blog/apache-apisix-and-node-red)
Ecosystem
March 6, 2024
#### [Débloquer des solutions sur mesure : exploiter Apache APISIX et Node-RED en harmonie](https://api7.ai/fr/blog/apache-apisix-and-node-red)
La combinaison d'APISIX et de Node-Red permet de mettre en œuvre visuellement un processus complet de gestion des requêtes sans avoir à réécrire du code complexe ou des plugins.
[Node-Red](https://api7.ai/tags/node-red)
[APISIX Basics](https://api7.ai/tags/apisix-basics)