¿Qué son las extensiones?

Estás consultando la documentación de Apigee Edge.
Consulta la documentación de Apigee X.
Información

Puedes usar extensiones para integrar recursos externos en tus proxies de API. Por ejemplo, podrías integrar servicios de Google Cloud Platform, como Google Cloud Storage. En el tiempo de ejecución, un proxy de API utiliza la extensión para intercambiar solicitudes y respuestas con el recurso externo.

Framework de entorno de ejecución de extensiones

En el tiempo de ejecución, una extensión actúa como un intermediario: procesa solicitudes y respuestas entre un proxy de API y un recurso externo.

Esta es una descripción general de cómo funciona el procesamiento a través de una extensión en el tiempo de ejecución.

  1. Una solicitud de cliente alcanza un proxy de API y su flujo de solicitudes procede mediante las políticas del proxy.
  2. El flujo de solicitudes alcanza una política Extension Featured en el proxy configurado para pasar datos a una extensión implementada en el entorno. Los datos incluyen valores que se necesitarán para enviar una solicitud al recurso externo que representa la extensión.
  3. La extensión envía una solicitud al recurso externo y, luego, recibe una respuesta.
  4. La extensión pasa su respuesta a la política Extension Highlight, donde se controla mediante código proxy.
  5. El flujo de solicitud continúa a través del proxy hasta que muestra una respuesta al cliente.

Cómo trabajar con extensiones

Cada extensión se desarrolla y configura teniendo en cuenta un recurso externo particular. Para usar una extensión, un administrador de Apigee Edge y un desarrollador de proxy de API siguen estos pasos de alto nivel:

  • Un administrador de la organización de Apigee Edge configura y, luego, implementa la extensión. Lo configuran con valores específicos de las necesidades del negocio. Esta configuración crea una instancia de extensión enfocada para que la use el desarrollador de proxy de API. Por ejemplo, pueden configurar una extensión para acceder a un bucket específico en Google Cloud Storage, incluidas las credenciales de autenticación requeridas.
  • Un desarrollador de proxy de API usa una extensión configurada en un proxy de API. Para ello, agrega una política Extension Featured al proxy. La configuración de la política especifica lo siguiente:
    • qué extensión configuró para usar.
    • las acciones de extensión (que son llamadas de función a la extensión) que se invocarán.
    • los parámetros de acción que se deben pasar con la llamada a la acción. Durante el tiempo de ejecución, la política usa la extensión para acceder al recurso externo como parte del flujo del proxy.

Documentación sobre las extensiones

Los siguientes temas proporcionan más información sobre las extensiones: