O que são extensões?

Você está vendo a documentação do Apigee Edge.
Acesse a documentação da Apigee X. informações

Você pode usar extensões para integrar recursos externos aos seus proxies de API. Por exemplo, é possível integrar serviços do Google Cloud Platform, como o Google Cloud Storage. No tempo de execução, um proxy de API usa a extensão para trocar solicitações e respostas com o recurso externo.

Framework de ambiente de execução da extensão

No ambiente de execução, uma extensão atua como um intermediário no processamento de solicitações e respostas entre um proxy de API e um recurso externo.

Esta é uma visão geral de como o processamento por uma extensão funciona no tempo de execução.

  1. Uma solicitação do cliente chega a um proxy de API e o fluxo de solicitação segue pelas políticas do proxy.
  2. O fluxo de solicitação chega a uma política de extensão de frase de destaque no proxy que está configurada para transmitir dados a uma extensão implantada no ambiente. Os dados incluem valores que serão necessários para enviar uma solicitação ao recurso externo que a extensão representa.
  3. A extensão envia uma solicitação para o recurso externo e recebe uma resposta.
  4. A extensão transmite a resposta de volta para a política "Extension callout", em que ela é processada pelo código proxy.
  5. O fluxo de solicitações continua pelo proxy até que ele retorne uma resposta ao cliente.

Como trabalhar com extensões

Cada extensão é desenvolvida e configurada com um recurso externo específico em mente. Para usar uma extensão, um administrador do Apigee Edge e um desenvolvedor de proxy de API precisam seguir estas etapas gerais:

  • Um administrador da organização do Apigee Edge configura e implanta a extensão. Eles a configuram com valores específicos para as necessidades da empresa. Esta configuração cria uma instância de extensão focada para uso pelo desenvolvedor do proxy de API. Por exemplo, eles podem configurar uma extensão para acessar um bucket específico no Google Cloud Storage, incluindo as credenciais de autenticação necessárias.
  • Um desenvolvedor de proxy de API usa uma extensão configurada em um proxy de API adicionando uma política de extensão de frase de destaque ao proxy. A configuração da política especifica:
    • qual extensão configurada será usada.
    • as ações da extensão (pense nelas como chamadas de função para a extensão) a serem invocadas.
    • os parâmetros de ação a serem transmitidos com a chamada de ação. No ambiente de execução, a política usa a extensão para acessar o recurso externo como parte do fluxo do proxy.

Documentação sobre extensões

Os tópicos a seguir fornecem mais informações sobre as extensões: