Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
È possibile CloudFront configurare l'aggiunta di intestazioni HTTP specifiche alle richieste CloudFront ricevute dai visualizzatori e inoltrate alla funzione origin o edge. I valori di queste intestazioni HTTP sono basati sulle caratteristiche del visualizzatore o della richiesta del visualizzatore. Le intestazioni forniscono informazioni sul tipo di dispositivo del visualizzatore, l'indirizzo IP, la posizione geografica, il protocollo di richiesta (HTTP o HTTPS), la versione HTTP, i dettagli della connessione TLS, l'impronta digitale e l'impronta digitale. JA3
Con queste intestazioni, l'origine o la funzione edge può ricevere informazioni sul visualizzatore senza la necessità da parte dell'utente di scrivere il proprio codice per determinare tali informazioni. Se la tua origine restituisce risposte diverse in base alle informazioni contenute in queste intestazioni, puoi includerle nella chiave della cache in modo che CloudFront memorizzi le risposte separatamente. Ad esempio, l'origine potrebbe rispondere con contenuti in una lingua specifica in base al paese in cui si trova il visualizzatore o con contenuti personalizzati per un tipo di dispositivo specifico. L'origine potrebbe anche scrivere queste intestazioni nei file di registro, che è possibile utilizzare per determinare le informazioni su dove si trovano i visualizzatori, quali tipi di dispositivi utilizzano e altro ancora.
Se si desidera includere intestazioni nella chiave della cache, utilizzare una policy della cache. Per ulteriori informazioni, consulta Controlla la chiave della cache con una policy e Comprendi la chiave della cache.
Per ricevere queste intestazioni alla tua origine, ma non includerle nella chiave cache, utilizzare una policy di richiesta di origine. Per ulteriori informazioni, consulta Controlla le richieste di origine con una policy.
Argomenti
Intestazioni del tipo di dispositivo
È possibile aggiungere le seguenti intestazioni per determinare il tipo di dispositivo del visualizzatore. In base al valore dell'User-Agentintestazione, CloudFront imposta il valore di queste intestazioni su o. true false Se il dispositivo ricade in più di una categoria, allora più di un valore potrebbe essere true. Ad esempio, per alcuni tablet, CloudFront imposta entrambi CloudFront-Is-Mobile-Viewer e CloudFront-Is-Tablet-Viewer su. true
-
CloudFront-Is-Android-Viewer— Impostato sutruewhen CloudFront determina che il visualizzatore è un dispositivo con sistema operativo Android. -
CloudFront-Is-Desktop-Viewer— Impostato sutruequando CloudFront determina che il visualizzatore è un dispositivo desktop. -
CloudFront-Is-IOS-Viewer— Impostato sutruequando CloudFront determina che il visualizzatore è un dispositivo con un sistema operativo mobile Apple, come iPhone, iPod touch e alcuni dispositivi iPad. -
CloudFront-Is-Mobile-Viewer— Impostato sutruequando CloudFront determina che lo spettatore è un dispositivo mobile. -
CloudFront-Is-SmartTV-Viewer— Impostato sutruequando CloudFront determina che lo spettatore è una smart TV. -
CloudFront-Is-Tablet-Viewer— Impostato sutruequando CloudFront determina che lo spettatore è un tablet.
Intestazioni relative alla posizione del visualizzatore
Puoi aggiungere le seguenti intestazioni per determinare la posizione dello spettatore. CloudFront determina i valori per queste intestazioni in base all'indirizzo IP del visualizzatore. Per i caratteri non ASCII nei valori di queste intestazioni, il carattere viene CloudFront codificato in percentuale secondo la sezione 1.2 di RFC 3986.
-
CloudFront-Viewer-Address- Contiene l'indirizzo IP del visualizzatore e la porta di origine della richiesta. Ad esempio, un valore di intestazione di198.51.100.10:46532significa che l'indirizzo IP del visualizzatore è 198.51.100.10 e la porta di origine della richiesta è 46532. -
CloudFront-Viewer-ASN- Contiene il numero di sistema autonomo (ASN) del visualizzatore.Nota
È possibile aggiungere
CloudFront-Viewer-AddresseCloudFront-Viewer-ASNin una policy di richiesta di origine, ma non in una policy della cache. -
CloudFront-Viewer-Country- Contiene il codice paese di due lettere per il Paese del visualizzatore. Per un elenco dei codici paese, vedere ISO 3166-1 alpha-2. -
CloudFront-Viewer-City- Contiene il nome della città del visualizzatore.
Quando aggiungi le seguenti intestazioni, le CloudFront applica a tutte le richieste tranne quelle che provengono dalla rete: AWS
-
CloudFront-Viewer-Country-Name- Contiene il nome del Paese del visualizzatore. -
CloudFront-Viewer-Country-Region- Contiene un codice (fino a tre caratteri) che rappresenta la regione del visualizzatore. La regione è la suddivisione di primo livello (la più ampia o meno specifica) del codice ISO 3166-2. -
CloudFront-Viewer-Country-Region-Name- Contiene il nome della regione del visualizzatore. La regione è la suddivisione di primo livello (la più ampia o meno specifica) del codice ISO 3166-2. -
CloudFront-Viewer-Latitude- Contiene la latitudine approssimativa del visualizzatore. -
CloudFront-Viewer-Longitude- Contiene la longitudine approssimativa del visualizzatore. -
CloudFront-Viewer-Metro-Code- Contiene il codice metro del visualizzatore. Questo è presente solo quando il visualizzatore è negli Stati Uniti. -
CloudFront-Viewer-Postal-Code- Contiene il codice postale del visualizzatore. -
CloudFront-Viewer-Time-ZoneContiene il fuso orario del visualizzatore, in formato database del fuso orario IANA(ad esempio, America/Los_Angeles).
Nota
CloudFront-Viewer-CityCloudFront-Viewer-Metro-Code, e CloudFront-Viewer-Postal-Code potrebbe non essere disponibile per tutti gli indirizzi IP. Alcuni indirizzi IP non possono essere geolocalizzati con una specificità sufficiente per ottenere tali informazioni.
Intestazioni per determinare la struttura dell'intestazione del visualizzatore
È possibile aggiungere le seguenti intestazioni per identificare il visualizzatore in base alle intestazioni che invia. Ad esempio, browser diversi possono inviare le intestazioni HTTP in un determinato ordine. Se il browser specificato nell'intestazione User-Agent non corrisponde all'ordine di intestazione previsto per quel browser, è possibile rifiutare la richiesta. Inoltre, se il valore CloudFront-Viewer-Header-Count non corrisponde al numero di intestazioni in CloudFront-Viewer-Header-Order, è possibile rifiutare la richiesta.
-
CloudFront-Viewer-Header-Order: contiene i nomi delle intestazioni del visualizzatore nell'ordine richiesto, separati dai due punti. Ad esempio:CloudFront-Viewer-Header-Order: Host:User-Agent:Accept:Accept-Encoding. Le intestazioni oltre il limite di 7.680 caratteri vengono troncate. -
CloudFront-Viewer-Header-Count: contiene il numero totale delle intestazioni del visualizzatore.
Intestazioni relative a TLS
Puoi aggiungere le seguenti intestazioni per determinare l'impronta digitale, l' JA3 impronta digitale e i dettagli della connessione TLS del visualizzatore: JA4
-
CloudFront-Viewer-JA3-Fingerprint— Contiene l'JA3 impronta digitale dello spettatore. L' JA3 impronta digitale può aiutare a determinare se la richiesta proviene da un client noto, se si tratta di malware o di un bot dannoso o di un'applicazione prevista (nella lista consentita). -
CloudFront-Viewer-JA4-Fingerprint— Contiene l' JA4impronta digitale del visualizzatore. Analogamente all' JA3 impronta digitale, l'JA4 impronta digitalepuò aiutarti a determinare se la richiesta proviene da un client noto, se si tratta di malware o di un bot dannoso o di un'applicazione prevista (nell'elenco consentito). È possibile utilizzare l'impronta digitale per creare un database di attori noti, buoni e cattivi, da utilizzare durante l'ispezione delle richieste HTTP. È quindi possibile controllare il valore dell'intestazione sui server Web delle applicazioni o in Lambda @Edge and CloudFront Functions per confrontare il valore dell'intestazione con un elenco di impronte digitali di malware note per bloccare i client dannosi. -
CloudFront-Viewer-TLS— Contiene la SSL/TLS version, the cipher, and information about the SSL/TLS stretta di mano utilizzata per la connessione tra il visualizzatore e. CloudFront Il valore dell'intestazione è nel seguente formato:SSL/TLS_version:cipher:handshake_informationPer
handshake_information-
fullHandshake— È stato eseguito un handshake completo per la sessione SSL/TLS. -
sessionResumed— Una precedente sessione SSL/TLS è stata ripresa. -
connectionReused— Una precedente connessione SSL/TLS è stata riutilizzata.
Di seguito sono riportati alcuni valori di esempio per questa intestazione:
TLSv1.3:TLS_AES_128_GCM_SHA256:sessionResumedTLSv1.2:ECDHE-ECDSA-AES128-GCM-SHA256:connectionReusedTLSv1.1:ECDHE-RSA-AES128-SHA256:fullHandshakeTLSv1:ECDHE-RSA-AES256-SHA:fullHandshakePer l'elenco completo delle possibili versioni e cifrature SSL/TLS che possono essere presenti in questo valore di intestazione, consulta Protocolli e cifrari supportati tra visualizzatori e CloudFront.
-
Note
-
Le JA4 impronte digitali JA3 e derivano dal pacchetto
Client HelloSSL/TLS. Sono presenti solo per le richieste HTTPS.
Altre CloudFront intestazioni
Puoi aggiungere le seguenti intestazioni per determinare l'URI della richiesta originale del visualizzatore, i parametri e i valori della stringa di richiesta originale, il protocollo e la versione:
-
CloudFront-Error-Args— Contiene l'URI della richiesta originale ricevuto dal visualizzatore. -
CloudFront-Error-Uri— Contiene i parametri e i valori della stringa di interrogazione della richiesta originale. -
CloudFront-Forwarded-Proto- Contiene il protocollo della richiesta del visualizzatore (HTTP o HTTPS). -
CloudFront-Viewer-Http-Version- Contiene la versione HTTP della richiesta del visualizzatore.
