O que são extensões?

Você está visualizando a documentação do Apigee Edge.
Acesse a documentação da Apigee X. info

É possível 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 execução de extensões

No momento da execução, uma extensão atua como intermediária, processando solicitações e respostas entre um proxy de API e um recurso externo.

Confira uma visão geral de como o processamento por uma extensão funciona no momento da 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ções chega a uma política de chamada de extensão no proxy que foi configurado para transmitir dados a uma extensão implantada no ambiente. Os dados incluem valores necessários para enviar uma solicitação ao recurso externo representado pela extensão.
  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 à política de Extension Callout, onde ela é processada pelo código proxy.
  5. O fluxo de solicitações continua pelo proxy até retornar 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 seguem estas etapas gerais:

  • Um administrador da organização do Apigee Edge configura e implanta a extensão. Eles configuram o modelo com valores específicos para as necessidades da empresa. Essa configuração cria uma instância de extensão focada para uso pelo desenvolvedor do proxy da 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 chamada de extensão ao proxy. A configuração da política especifica
    • qual extensão configurada usar.
    • 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 tempo 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

Confira mais informações sobre extensões nos tópicos a seguir: