O Apigee Adapter for Envoy é um gateway de API gerido pelo Apigee que usa o
Envoy para encaminhar o tráfego
da API. O Envoy é um proxy de serviço e de limite de código aberto popular concebido para aplicações nativas da nuvem. Pode executar o Apigee Adapter for Envoy nas instalações ou num ambiente de várias nuvens.
Com o Apigee Adapter for Envoy, tem uma aplicação de gateway de API relativamente pequena
em execução perto das suas aplicações de back-end. O Apigee Adapter for Envoy depende do Apigee para:
Autenticação e autorização da API (com chaves da API e OAuth)
Gestão de quotas
Análise da API
Ver vídeos:
Este vídeo oferece uma vista geral e uma demonstração do Apigee Adapter for Envoy do Google Cloud.
Este vídeo descreve a utilização do adaptador Apigee para Envoy com a malha de serviços.
Opções de instalação
Pode usar o adaptador Apigee para o Envoy no seguinte contexto:
A figura seguinte mostra a arquitetura de alto nível do Apigee Adapter for Envoy.
Esta arquitetura consiste em componentes do plano de gestão implementados na Google Cloud Platform (GCP)
e componentes do plano de dados executados remotamente no local ou num ambiente de fornecedor de nuvem. O plano de dados inclui o proxy Envoy e o serviço remoto do Apigee. A função de cada componente
é descrita após a figura.
Uma app de consumidor ou cliente acede a um ponto final da API exposto pelo proxy Envoy.
O proxy Envoy transmite o contexto de segurança (através de cabeçalhos HTTP) ao serviço remoto do Apigee. O serviço remoto do Apigee atua como um ponto de decisão de políticas (PDP) e aconselha o Envoy a permitir ou negar o acesso ao consumidor da API para o pedido.
Se a chamada for permitida, o proxy Envoy encaminha o pedido para o back-end.
O serviço remoto do Apigee sonda de forma assíncrona o plano de gestão e transfere o proxy, o produto da API e
outras configurações necessárias para funcionar.
Por que motivo devo usar o adaptador do Apigee para o Envoy?
Aproximar o componente de gestão de APIs das aplicações de destino de back-end pode reduzir a latência da rede. Embora possa instalar o Apigee hybrid no local num centro de dados privado, uma implementação completa do
Apigee hybrid é necessariamente grande e complexa para suportar o conjunto completo de funcionalidades e as funcionalidades
com grande volume de dados, como a gestão de chaves, a rentabilização e as estatísticas. Isto significa que a implementação do Apigee hybrid
no local em cada centro de dados nem sempre é desejável.
Vantagens da utilização do Apigee Adapter for Envoy:
Latência reduzida do tráfego da API para serviços executados nas proximidades.
Utilização do conjunto completo de métricas, painéis de controlo e APIs do Apigee Analytics.
Mantém o tráfego da API dentro dos limites aprovados pela empresa para fins de segurança ou conformidade.
A comunicação assíncrona com o Apigee permite a captura de dados de tráfego da API e o envio para o Apigee sem afetar a latência.
O adaptador pode tolerar interrupções temporárias de comunicação com o plano de gestão. No entanto, ao longo do tempo, uma interrupção pode levar à perda de funcionalidade. O adaptador requer
comunicação com o plano de gestão para:
Gerar tokens OAuth
Validar chaves de API (é necessária uma ligação para a primeira validação, após a qual é colocada em cache)
Aplicar quotas
Enviar dados de estatísticas para o plano de gestão
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Informações incorretas ou exemplo de código","incorrectInformationOrSampleCode","thumb-down"],["Não contém as informações/amostras de que eu preciso","missingTheInformationSamplesINeed","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-08-21 UTC."],[[["\u003cp\u003eApigee Adapter for Envoy is an Apigee-managed API gateway that uses Envoy to proxy API traffic, suitable for on-premises or multi-cloud environments.\u003c/p\u003e\n"],["\u003cp\u003eThis adapter provides API authentication, authorization, and quota management, relying on Apigee for these core functionalities.\u003c/p\u003e\n"],["\u003cp\u003eDeploying Apigee Adapter for Envoy near backend applications minimizes network latency for API traffic and keeps traffic within enterprise-approved boundaries.\u003c/p\u003e\n"],["\u003cp\u003eThe adapter uses asynchronous communication with Apigee for analytics and tolerates temporary connection interruptions, though persistent issues may result in functionality loss.\u003c/p\u003e\n"],["\u003cp\u003eThe architecture involves management plane components on GCP and data plane components remotely, with the data plane using Envoy proxy and Apigee Remote Service to control access to APIs.\u003c/p\u003e\n"]]],[],null,["# Apigee Adapter for Envoy overview\n\n*This page\napplies to **Apigee** and **Apigee hybrid**.*\n\n\n*View [Apigee Edge](https://docs.apigee.com/api-platform/get-started/what-apigee-edge) documentation.*\n\nWhat is Apigee Adapter for Envoy?\n---------------------------------\n\n\nApigee Adapter for Envoy is an Apigee-managed API gateway that uses\n[Envoy](https://www.envoyproxy.io/docs/envoy/latest/intro/what_is_envoy) to proxy API\ntraffic. Envoy is a popular, open source edge and service proxy designed for cloud-native\napplications. You can run Apigee Adapter for Envoy on premises or in a multi-cloud environment.\n\nWith Apigee Adapter for Envoy, you get a relatively small footprint API gateway application\nrunning close to your backend applications. Apigee Adapter for Envoy relies on Apigee for:\n\n- API authentication and authorization (with API keys and OAuth)\n- Quota management\n- API analytics\n\n\n**Watch videos:** \nThis video offers an overview and demo of Google Cloud's Apigee Adapter for Envoy. \nThis video describes using the Apigee Adapter for Envoy with Service Mesh.\n\nInstallation options\n--------------------\n\n\nYou can use the Apigee Adapter for Envoy in the following context:\n\n- As a service deployed to the Istio service mesh integrated with Apigee hybrid. See [Using Apigee Adapter for Envoy with Apigee hybrid](/apigee/docs/api-platform/envoy-adapter/v1.3.x/example-hybrid).\n\nApigee Adapter for Envoy\n------------------------\n\n\nThe following figure shows the high level architecture for Apigee Adapter for Envoy.\nThis architecture consists of management plane components deployed on Google Cloud Platform (GCP)\nand data plane components running remotely on premises or in a cloud provider environment. The\ndata plane includes the Envoy proxy and Apigee Remote Service. The role of each component\nis described following the figure.\n\n1. A consumer or client app accesses an API endpoint exposed by the Envoy proxy.\n2. The Envoy proxy passes the security context (using HTTP headers) to the Apigee Remote Service. The Apigee Remote Service acts as a policy decision point (PDP) and advises Envoy to allow or deny access to the API consumer for the request.\n3. If the call is allowed, the Envoy proxy forwards the request to the backend.\n4. The Apigee Remote Service asynchronously polls the management plane and downloads proxy, API product, and other configuration that it needs to operate.\n\nWhy use Apigee Adapter for Envoy?\n---------------------------------\n\nMoving the API management component close to backend target applications can reduce network\nlatency. While you can install Apigee hybrid on-premises in a private data center, a full deployment of\nApigee hybrid is necessarily large and complex to support its full feature-set and data-heavy\nfeatures like key management, monetization, and analytics. This means that deploying Apigee hybrid\non premises in each data-center is not always desirable.\n\nBenefits of using Apigee Adapter for Envoy include:\n\n- Reduced latency of API traffic for services that run in close proximity.\n\n- Use of the full suite of Apigee Analytics metrics, dashboards, and APIs.\n- Keeps API traffic within the enterprise-approved boundaries for security or compliance purposes.\n- Asynchronous communication with Apigee allows API traffic data to be captured and sent to Apigee without affecting latency.\n- The adapter can tolerate temporary communication interruptions with the management plane. Over time, however, an interruption can lead to loss of functionality. The adapter requires communication with the management plane for:\n - Generating OAuth tokens\n - Verifying API keys (connection is required for the first verification, after which it is cached)\n - Enforcing quotas\n - Sending analytics data to the management plane\n\nNext step\n---------\n\n[Install Apigee Adapter for Envoy](/apigee/docs/api-platform/envoy-adapter/v1.3.x/getting-started)"]]
