L'elaboratore di estensioni Apigee consente ai clienti Apigee di aggiungere funzionalità di gestione delle API a prodotti e servizi Google Cloud o servizi esterni esposti utilizzando Cloud Load Balancing.
I clienti Apigee che utilizzano Extension Processor possono scegliere tra una gamma di norme Apigee che
applicano funzionalità di gestione delle API a qualsiasi prodotto o servizio esposto utilizzando un bilanciamento del carico. Google Cloud
Con Extension Processor puoi:
Accesso sicuro ai Google Cloud workload.
Scegli tra un'ampia gamma di criteri Apigee da applicare al traffico del bilanciatore del carico, tra cui VerifyApiKey,
OAuthV2,
e VerifyJWS.
Applica l'applicazione della quota al traffico di rete.
Questa funzionalità consente ai fornitori di API di imporre limiti al numero di chiamate API effettuate ai servizi di backend in un periodo di tempo specificato. Ad esempio, puoi utilizzare il criterio Quota per limitare le chiamate a una richiesta al minuto o a 10.000 richieste al mese.
Gestisci l'inserimento del token Google per autenticare le richieste.
Utilizzando Extension Processor e il criterio AssignMessage,
puoi inserire un token di accesso Google o un token ID Google
nelle intestazioni delle richieste client per gestire l'accesso a servizi e prodotti di backend autenticati da Google.
Oltre a supportare i casi d'uso descritti in precedenza, l'Extension Processor offre tutti i vantaggi delle funzionalità Apigee integrate, ad esempio:
Sicurezza: Advanced API Security monitora e analizza continuamente il traffico API per identificare le richieste API sospette e fornisce strumenti per bloccare o segnalare queste richieste.
Monetizzazione: genera entrate ogni volta che le tue API vengono utilizzate aggiungendo piani tariffari ai prodotti API personalizzati che crei in Apigee.
Tracciabilità: il sistema di tracciamento distribuito di Apigee ti consente di monitorare le richieste nei sistemi distribuiti
in più applicazioni, servizi, database e proxy.
Business intelligence: Apigee API Analytics raccoglie la grande quantità di informazioni che fluiscono attraverso il bilanciamento del carico, fornendo
la visualizzazione dei dati nell'interfaccia utente o la possibilità di scaricare i dati per l'analisi offline.
Come funziona Apigee Extension Processor
Il processore di estensioni Apigee è un'estensione del traffico (un tipo di estensione di servizio) che consente di utilizzare Cloud Load Balancing
per inviare callout ad Apigee dal percorso di elaborazione dei dati del bilanciatore del carico delle applicazioni. Una volta configurati il bilanciatore del carico delle applicazioni e l'estensione del servizio, il traffico che passa attraverso il bilanciatore del carico delle applicazioni attiverà chiamate ai proxy Apigee utilizzando l'estensione del servizio, come mostrato nella figura seguente:
Figura 1: infrastruttura e flusso di dati per il processore di estensioni Apigee.
Il diagramma illustra i componenti richiesti della configurazione del processore di estensioni Apigee:
Un bilanciatore del carico delle applicazioni con un servizio di backend configurato con un gruppo di endpoint di rete (NEG) che copre tutti i backend dell'applicazione.
Un'istanza Apigee con un ambiente dedicato per Extension Processor e la proprietà apigee-service-extension-enabled impostata su true.
Un'estensione del traffico (un tipo di estensione di servizio) configurata per utilizzare un endpoint Private Service Connect (PSC) per connettersi al piano di runtime di Apigee.
Un proxy API Apigee in esecuzione in un ambiente speciale. Il proxy viene utilizzato per applicare le funzionalità di gestione delle API al traffico del bilanciatore del carico.
Extension Processor supporta l'utilizzo di proxy no-target e Server-sent event (SSE)-enabled.
Come mostrato nel diagramma di flusso:
1: il client invia una richiesta al bilanciatore del carico delle applicazioni.
2: il bilanciatore del carico delle applicazioni esamina il traffico e chiama l'estensione del servizio.
3: L'implementazione dell'estensione di servizio nel processore di messaggi Apigee applica eventuali
norme di gestione delle API pertinenti e restituisce la richiesta, con eventuali modifiche, al bilanciatore del carico delle applicazioni.
4: il bilanciatore del carico delle applicazioni completa l'elaborazione e inoltra la richiesta al servizio di backend. Un'elaborazione simile
si verifica per il percorso di risposta dal servizio di backend al bilanciatore del carico delle applicazioni e al client.
Il processore di estensioni Apigee presenta le seguenti limitazioni note:
L'Extension Processor viene applicato a livello di bilanciatore del carico. Tutto il traffico che passa attraverso il
bilanciatore del carico viene elaborato dallo stesso proxy, senza distinzione di percorso di base o URL.
Il traffico tramite il processore delle estensioni è soggetto alle stesse quote di Cloud Load Balancing.
I limiti e le quote pertinenti includono quanto segue:
Numero massimo di estensioni del traffico per bilanciatore del carico: 1
Numero massimo di estensioni di traffico per progetto: 100
Numero massimo di catene di estensioni per progetto: 5
Si applicano limiti aggiuntivi a ambienti, gruppi di ambienti e proxy API quando utilizzi
l'Extension Processor:
È possibile collegare un massimo di un ambiente al gruppo di ambienti utilizzato
per configurare il processore di estensioni.
L'ambiente utilizzato durante la configurazione del processore di estensioni può avere un massimo di 50 proxy API
di cui è stato eseguito il deployment.
Tutti i proxy API di cui è stato eseguito il deployment nell'ambiente dedicato per l'Extension Processor devono essere dello
stesso tipo di proxy. I proxy API devono essere tutti proxy API standard o tutti proxy API estensibili.
I proxy API standard ed estensibili non possono essere combinati nell'ambiente del processore di estensioni.
Oltre ai costi associati ai piani di abbonamento Apigee o di pagamento a consumo,
quando utilizzi Apigee Extension Processor potrebbero essere applicati i seguenti costi di networking:
[[["Facile da capire","easyToUnderstand","thumb-up"],["Il problema è stato risolto","solvedMyProblem","thumb-up"],["Altra","otherUp","thumb-up"]],[["Difficile da capire","hardToUnderstand","thumb-down"],["Informazioni o codice di esempio errati","incorrectInformationOrSampleCode","thumb-down"],["Mancano le informazioni o gli esempi di cui ho bisogno","missingTheInformationSamplesINeed","thumb-down"],["Problema di traduzione","translationIssue","thumb-down"],["Altra","otherDown","thumb-down"]],["Ultimo aggiornamento 2025-09-05 UTC."],[],[],null,["# Apigee Extension Processor 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\nThe Apigee Extension Processor lets Apigee customers add API management capabilities to Google Cloud products and services, or external services, exposed using Cloud Load Balancing.\n\n\u003cbr /\u003e\n\nTo get started using the Apigee Extension Processor, see the [Apigee Extension Processor quickstart](/apigee/docs/api-platform/service-extensions/extension-processor-quickstart).\n\nUse cases for the Apigee Extension Processor\n--------------------------------------------\n\nApigee customers using the Extension Processor can select from a range of Apigee policies that\napply API management capabilities to any products or services exposed using a Google Cloud load balancer.\n\nWith the Extension Processor, you can:\n\n- **Secure access to Google Cloud workloads.**\n\n Choose from a wide range of Apigee policies to apply to your load balancer traffic, including [VerifyApiKey](/apigee/docs/api-platform/reference/policies/verify-api-key-policy),\n [OAuthV2](/apigee/docs/api-platform/reference/policies/oauthv2-policy),\n and [VerifyJWS](/apigee/docs/api-platform/reference/policies/verify-jws-policy).\n- **Apply quota enforcement to network traffic.**\n\n This capability lets API providers enforce limits on the number of API calls made to backend services over a\n specified time period. For example, you can use the [Quota](/apigee/docs/api-platform/reference/policies/quota-policy) policy to limit calls to 1 request per minute, or to 10,000 requests per month.\n- **Manage Google token injection for authenticating requests.**\n\n Using the Extension Processor and the [AssignMessage](/apigee/docs/api-platform/reference/policies/assign-message-policy) policy,\n you can inject a [Google access token](/docs/authentication/token-types#access) or [Google ID token](/docs/authentication/token-types#id)\n into client request headers to manage access to GOogle-authenticated backend services and products.\n- **Support native protocols.**\n\n The Extension Processor unlocks support for native protocols such as [gRPC bi-directional streaming](https://grpc.io/docs/what-is-grpc/core-concepts/#service-definition),\n [server-sent events (SSE)](/apigee/docs/api-platform/develop/server-sent-events), and [HTTP/3](/load-balancing/docs/https#QUIC).\n\nBenefits\n--------\n\nIn addition to supporting the use cases described earlier, the Extension Processor provides all the benefits of built-in Apigee features, such as:\n\n- **Security**: Advanced API Security continually monitors and analyzes your API traffic to identify suspicious API requests and provides tools to block or flag those requests.\n- **Monetization**: Generate revenue whenever your APIs are used by adding rate plans to customized API products you create within Apigee.\n- **Traceability**: Apigee's distributed tracing system lets you track requests in distributed systems across multiple applications, services, and databases, and proxies.\n- **Business intelligence**: Apigee API Analytics collects the wealth of information flowing through your load balancer, providing data visualization in the UI or the ability to download data for offline analysis.\n\nHow Apigee Extension Processor works\n------------------------------------\n\nThe Apigee Extension Processor is a traffic extension (a type of [service extension](/service-extensions/docs/lb-extensions-overview)) that lets you use Cloud Load Balancing\nto send callouts to Apigee from the data processing path of the application load balancer. Once the application load balancer\nand service extension are configured, traffic flowing through the application load balancer will trigger calls to\nApigee proxies using the service extension, as shown in the following figure:\n\n**Figure 1**: Infrastructure and dataflow for the Apigee Extension Processor.\n\nThe diagram outlines the required components of the Apigee Extension Processor configuration:\n\n- An Application Load Balancer with a backend service configured with a Network Endpoint Group (NEG) covering all application backends.\n- An Apigee instance with a dedicated environment for the Extension Processor and the property `apigee-service-extension-enabled` set to `true`.\n- A [traffic extension](/service-extensions/docs/configure-traffic-extensions) (a type of service extension) configured to use a Private Service Connect (PSC) endpoint to connect to the Apigee runtime plane.\n- A [no-target Apigee API proxy](/apigee/docs/api-platform/fundamentals/build-simple-api-proxy) running in a special environment. The proxy is used to apply API management capabilities to the load balancer traffic.\n\n\u003cbr /\u003e\n\nAs shown in the flow diagram:\n\n- **1**: The client sends a request to the Application Load Balancer.\n- **2**: The Application Load Balancer reviews the traffic and calls out to the Service Extension.\n- **3**: The Service Extension implementation in the Apigee message processor applies any relevant API management policies and returns the request, with any modifications, to the Application Load Balancer.\n- **4**: The Application Load Balancer completes processing and forwards the request to the backend service. Similar processing occurs for the response path from the backend service to the Application Load Balancer and to the client.\n\nFor more information, see [Cloud Load Balancing extensions](/service-extensions/docs/overview#integration-lb-callouts).\n\nLimitations\n-----------\n\nThe Apigee Extension Processor has the following known limitations:\n\n- The Extension Processor is applied at the load balancer level. All traffic passing through the load balancer is processed by the same proxy, with no base path or URL distinction.\n- Traffic through the Extension Processor is subject to the same quotas as the Cloud Load Balancing. Relevant limits and quotas include the following:\n\n - Maximum number of traffic extensions per load balancer: 1\n - Maximum traffic extensions per project: 100\n - Maximum extension chains per project: 5\n - Maximum extensions per resource: 3\n\n For more information, see [Quotas and limits](/load-balancing/docs/quotas).\n- Additional limits apply to environments, environment groups, and API proxies when using the Extension Processor:\n - A maximum of **one** environment can be attached to the environment group used to configure the Extension Processor.\n - The environment used when configuring the Extension Processor can have a maximum of **50** API proxies deployed.\n - The API proxies deployed in the dedicated environment for the Extension Processor must all be of the same [*proxy type*](/apigee/docs/api-platform/fundamentals/understanding-apis-and-api-proxies#proxy-types). The API proxies must be either all **standard** API proxies or all **extensible** API proxies. Standard and extensible API proxies can't be mixed in the Extension Processor environment.\n\n For more information, see [Create an Apigee environment](/apigee/docs/api-platform/service-extensions/extension-processor-quickstart#create-apigee-environment).\n\n For more information on Apigee limits generally, see [Limits](/apigee/docs/api-platform/reference/limits).\n- The following Apigee policies are not supported for use with the Extension Processor:\n - [Publish message](/apigee/docs/api-platform/reference/policies/publish-message-policy)\n - [ExternalCallout](/apigee/docs/api-platform/reference/policies/external-callout-policy)\n - [IntegrationCallout](/apigee/docs/api-platform/reference/policies/integration-callout-policy)\n - [ServiceCallout](/apigee/docs/api-platform/reference/policies/service-callout-policy)\n - [SetIntegrationRequest](/apigee/docs/api-platform/reference/policies/set-integration-request-policy)\n - [MessageLogging](/apigee/docs/api-platform/reference/policies/message-logging-policy)\n - [GenerateJWT](/apigee/docs/api-platform/reference/policies/generate-jwt-policy)\n\nPricing\n-------\n\nIn addition to costs associated with your Apigee Subscription or Pay-as-you-go pricing plans,\nthe following networking costs may apply when using Apigee Extension Processor:\n\n- [Service Extensions pricing](/service-extensions/pricing)\n- [Backend service pricing](https://cloud.google.com/vpc/network-pricing#lb)\n- [Private Service Connect charges](https://cloud.google.com/vpc/network-pricing#psc-consumer-data-processing)\n\nWhat's next\n-----------\n\n- Learn how to [Get started with the Apigee Extension Processor](/apigee/docs/api-platform/service-extensions/extension-processor-quickstart).\n- Learn more about working with [Service Extensions](/service-extensions/docs/overview).\n- Explore how Apigee Extension Processor works with the [Apigee APIM Operator for Kubernetes](/apigee/docs/api-platform/apigee-kubernetes/apigee-apim-operator-overview)."]]
