O que são extensões?

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

É possível usar extensões para integrar recursos externos aos proxies de API. Por exemplo, você pode 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ão

No tempo de 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 funciona por uma extensão no tempo de execução.

  1. Uma solicitação do cliente chega a um proxy de API e o fluxo de solicitação prossegue pelas políticas do proxy.
  2. O fluxo de solicitação atinge uma política de chamada de extensão no proxy 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 que a extensão representa.
  3. A extensão envia uma solicitação ao recurso externo e recebe uma resposta.
  4. A extensão transmite a resposta de volta à política de chamada de extensão, em que ela é processada pelo código do proxy.
  5. O fluxo de solicitação 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. Ele a configura com valores específicos para as necessidades da empresa. Essa configuração cria uma instância de extensão focada no uso pelo desenvolvedor de proxy de API. Por exemplo, ele pode 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 de 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

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