Que sont les extensions ?

Vous consultez la documentation d'Apigee Edge.
Accédez à la documentation sur Apigee X.
info

Vous pouvez utiliser des extensions pour intégrer des ressources externes dans vos proxys d'API. Vous pouvez par exemple 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 des extensions

Lors de l'exécution, une extension sert d'intermédiaire et traite 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.

  1. Une requête client atteint un proxy d'API, et son flux de requêtes suit les règles du proxy.
  2. Le flux de requêtes atteint une règle de rappel d'extension dans le proxy, qui est configuré pour transmettre des données à une extension déployée dans l'environnement. Les données incluent les valeurs nécessaires pour envoyer une requête à la ressource externe que l'extension représente.
  3. L'extension envoie une requête à la ressource externe, puis reçoit une réponse.
  4. L'extension renvoie sa réponse à la règle d'appel d'extension, où elle est gérée par le code proxy.
  5. Le flux de requêtes continue à travers 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 fonction d'une ressource externe particulière. 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 de l'organisation Apigee Edge configure et déploie l'extension. Il le configure avec des valeurs spécifiques aux besoins de l'entreprise. Cette configuration crée une instance d'extension destinée à être utilisée par le développeur du proxy d'API. Par exemple, il peut configurer une extension pour accéder à un bucket particulier dans Google Cloud Storage, y compris les identifiants d'authentification requis.
  • Un développeur de proxy d'API utilise une extension configurée dans un proxy d'API en ajoutant une règle Extension Callout au proxy. La configuration de la stratégie spécifie :
    • l'extension configurée à utiliser.
    • les actions d'extension (appelées "appels de fonction" à l'extension) à appeler.
    • les paramètres d'action à transmettre avec l'appel d'action. Lors 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

Pour en savoir plus sur les extensions, consultez les articles suivants: