Attributi supportati

Quando configuri le estensioni utilizzando plug-in o callout per i servizi di backend basati su ext-proc, puoi specificare gli attributi di richiesta e connessione da inoltrare a questi servizi. Questa pagina descrive gli attributi supportati e specifica quali sono disponibili per ogni tipo di estensione.

Configurando le estensioni per inoltrare attributi specifici, puoi ottenere quanto segue:

  • Prendere decisioni di routing dinamico.
  • Arricchire le intestazioni delle richieste con le informazioni del client.
  • Implementare policy di sicurezza personalizzate in base alla località del client o ai parametri TLS.
  • Generare log personalizzati dettagliati.

Puoi specificare gli attributi con il campo forwardAttributes nella configurazione YAML per le estensioni di plug-in e callout. Ad esempio, per le estensioni del traffico, consulta Configurare un'estensione del traffico.

La specifica degli attributi con forwardAttributes è supportata per le estensioni di autorizzazione, edge, route e traffico. Puoi implementare forwardAttributes utilizzando plug-in Wasm o callout (con il ext_proc protocollo) sui seguenti prodotti:

  • Bilanciatori del carico delle applicazioni esterni regionali
  • Bilanciatori del carico delle applicazioni interni regionali
  • Bilanciatori del carico delle applicazioni esterni globali
  • Bilanciatori del carico delle applicazioni interni tra regioni

La tabella seguente elenca gli attributi e le estensioni supportati:

Attributo Descrizione Estensioni
request.origin Il valore dell'intestazione dell'origine in una richiesta per i casi d'uso di condivisione delle risorse tra origini (CORS). traffico
request.method Il metodo di richiesta HTTP, ad esempio GET o POST. autorizzazione, edge, route, traffico
request.mcp_method Il metodo di richiesta HTTP, ad esempio GET o POST. autorizzazione
request.host Un equivalente pratico di request.headers['host']. autorizzazione, edge, route, traffico
request.path Il percorso dell'URL HTTP richiesto. autorizzazione, edge, route, traffico
request.query La query URL HTTP, nel formato name1=value&name2=value2, come appare nella prima riga della richiesta HTTP. Non viene eseguita alcuna decodifica. autorizzazione, edge, route, traffico
request.scheme Lo schema URL HTTP, ad esempio HTTP o HTTPS. I valori di questo attributo sono in minuscolo. autorizzazione, edge, route, traffico
request.backend_service_name Il servizio di backend al quale viene inoltrata la richiesta. autorizzazione, traffico
request.backend_service_project_number Quando si utilizza un VPC condiviso, indica il numero di progetto del servizio backend a cui viene inoltrata la richiesta. autorizzazione, traffico
request.mcp_param Il parametro MCP. autorizzazione
request.user_agent_family Il tipo di browser del client, derivato dai valori dell'intestazione User-Agent. Questi valori si riferiscono alla stringa di testo non elaborata che i client HTTP in entrata (come browser web, app mobile o strumenti automatici) inviano nell'intestazione della richiesta HTTP standard User-Agent. edge, traffico (solo per i bilanciatori del carico delle applicazioni esterni globali e regionali)
request.device_request_type Il tipo di dispositivo del client. I valori possibili per questo attributo possono essere APPLE, APPLEWEBKIT, BLACKBERRY, DOCOMO, GECKO, GOOGLE, KHTML, KOREAN, MICROSOFT, MSIE, NETFRONT, NOKIA, OBIGO, OPERA, OPENWAVE, OTHER, POLARIS, SEMC, SMIT, TELECA o USER_DEFINED. edge, traffico (solo per i bilanciatori del carico delle applicazioni esterni globali e regionali)
response.cdn_cache_id Il codice località e l'ID dell'istanza della cache utilizzata per gestire la richiesta. Si tratta dello stesso valore inserito nel campo jsonPayload.cacheId dei log delle richieste di Cloud CDN. traffico (solo per i bilanciatori del carico delle applicazioni esterni globali)
response.cdn_cache_status Lo stato attuale dell'istanza della cache utilizzata per gestire la richiesta. I valori possibili per questo attributo possono essere hit, miss, revalidated, stale, uncacheable o disabled. traffico (solo per i bilanciatori del carico delle applicazioni esterni globali)
source.ip L'indirizzo IP del client. edge, route, traffico
source.port La porta di origine del client. edge, route, traffico
source.client_region Il paese o la regione associati all'indirizzo IP del client. Il valore è un codice regione Unicode CLDR, ad esempio US o