Vous consultez la documentation d'Apigee Edge.
Consultez la
documentation Apigee X. en savoir plus
Vous pouvez utiliser des extensions pour intégrer des ressources externes dans vos proxys d'API. Par exemple, vous pouvez intégrer des services Google Cloud Platform tels que Google Cloud Storage. Lors de l'exécution, un proxy d'API utilise l'extension pour échanger des requêtes et des réponses avec la ressource externe.
Framework d'exécution de l'extension
Au moment de l'exécution, une extension joue le rôle d'intermédiaire en traitant les requêtes et les réponses entre un proxy d'API et une ressource externe.
Voici un aperçu du fonctionnement du traitement via une extension au moment de l'exécution.
- Une demande client atteint un proxy d'API et son flux de requêtes passe par les règles du proxy.
- Le flux de requêtes atteint une stratégie d'appel d'extension dans le proxy configurée pour transmettre les données à une extension déployée dans l'environnement. Les données incluent des valeurs qui seront nécessaires pour envoyer une requête à la ressource externe représentée par l'extension.
- L'extension envoie une requête à la ressource externe, puis reçoit une réponse.
- L'extension renvoie sa réponse à la stratégie d'appel d'extension, où elle est gérée par un code de proxy.
- Le flux de requêtes se poursuit via le proxy jusqu'à ce qu'il renvoie une réponse au client.
Utiliser les extensions
Chaque extension est développée et configurée en tenant compte d'une ressource externe spécifique. Pour utiliser une extension, un administrateur Apigee Edge et un développeur de proxy d'API doivent suivre ces étapes générales:
- Un administrateur d'organisation Apigee Edge configure et déploie l'extension. Ils le configurent avec des valeurs spécifiques aux besoins de l'entreprise. Cette configuration crée une instance d'extension destinée au développeur du proxy d'API. Par exemple, ils peuvent configurer une extension pour accéder à un bucket particulier dans Google Cloud Storage, y compris les identifiants d'authentification requis.
- Un développeur proxy d'API utilise une extension configurée dans un proxy d'API en ajoutant une règle d'appel d'extension au proxy. La configuration de cette règle spécifie les éléments suivants :
- l'extension configurée à utiliser.
- les actions d'extension (considérez-les comme des appels de fonction à l'extension) à invoquer.
- les paramètres d'action à transmettre avec l'appel d'action. Au moment de l'exécution, la règle utilise l'extension pour accéder à la ressource externe dans le cadre du flux du proxy.
Documentation sur les extensions
Les articles suivants fournissent plus d'informations sur les extensions:
- Pour une présentation pratique des extensions, consultez le Tutoriel: Ajouter et utiliser une extension.
- Pour plus d'informations sur les extensions incluses dans Apigee Edge, consultez la section Présentation de la documentation de référence sur les extensions.
- Pour obtenir des informations sur l'API de gestion que vous pouvez utiliser pour ajouter, supprimer et déployer des extensions, consultez API Extensions.