Aggiungi intestazioni CloudFront di richiesta - Amazon CloudFront
Intestazioni per determinare il tipo di dispositivo del visualizzatoreIntestazioni per determinare la posizione del visualizzatoreIntestazioni per determinare la struttura dell'intestazione del visualizzatoreAltre CloudFront intestazioni

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à.

Aggiungi intestazioni CloudFront di richiesta

È possibile configurare CloudFront l'aggiunta di HTTP intestazioni specifiche alle richieste CloudFront ricevute dai visualizzatori e inoltrate alla funzione di origine o periferica. I valori di queste HTTP intestazioni si basano sulle caratteristiche del visualizzatore o sulla richiesta del visualizzatore. Le intestazioni forniscono informazioni sul tipo di dispositivo del visualizzatore, l'indirizzo IP, la posizione geografica, il protocollo di richiesta (HTTPoHTTPS), la HTTP versione, i dettagli della TLS connessione, l'impronta digitale e l'JA3impronta digitale. JA4

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.

Intestazioni per determinare il tipo di dispositivo del visualizzatore

È 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 su true when CloudFront determina che il visualizzatore è un dispositivo con sistema operativo Android.

  • CloudFront-Is-Desktop-Viewer— Impostato su true quando CloudFront determina che il visualizzatore è un dispositivo desktop.

  • CloudFront-Is-IOS-Viewer— Impostato su true when CloudFront determina che lo spettatore è un dispositivo con un sistema operativo mobile AppleiPhone, ad esempio iPod touch e alcuni iPad dispositivi.

  • CloudFront-Is-Mobile-Viewer— Impostato su true quando CloudFront determina che lo spettatore è un dispositivo mobile.

  • CloudFront-Is-SmartTV-Viewer— Impostato su true quando CloudFront determina che lo spettatore è una smart TV.

  • CloudFront-Is-Tablet-Viewer— Impostato su true quando CloudFront determina che lo spettatore è un tablet.

Intestazioni per determinare la posizione del visualizzatore

È possibile 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 valori diversi dai ASCII caratteri di queste intestazioni, la CloudFront percentuale codifica il carattere in base alla sezione 1.2 di 3986. RFC

  • CloudFront-Viewer-Address - Contiene l'indirizzo IP del visualizzatore e la porta di origine della richiesta. Ad esempio, un valore di intestazione di 198.51.100.10:46532 significa 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-Address e CloudFront-Viewer-ASN in 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 dei paesi, vedere ISO3166-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

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 HTTP intestazioni 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.

Altre CloudFront intestazioni

Puoi aggiungere le seguenti intestazioni per determinare la richiesta originale del visualizzatore, i parametri e i valori della stringa di query della richiesta originaleURI, il protocollo, la versione, l'JA3impronta digitale e i dettagli della connessione: TLS

  • CloudFront-Error-Args— Contiene la richiesta originale URI ricevuta 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 (HTTPoHTTPS) del visualizzatore.

  • CloudFront-Viewer-Http-Version— Contiene la HTTP versione della richiesta del visualizzatore.

  • CloudFront-Viewer-JA3-Fingerprint— Contiene l'JA3impronta digitale del visualizzatore. L'JA3impronta 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). Questa intestazione si basa sul TLS Client Hello pacchettoSSL/del visualizzatore ed è presente solo per le richieste. HTTPS

    Nota

    È possibile aggiungere CloudFront-Viewer-JA3-Fingerprint in una policy della richiesta di origine, ma non in una policy della cache.

  • CloudFront-Viewer-TLS— Contiene la SSL/TLS version, the cipher, and information about the SSL/TLS stretta di mano che è stata utilizzata per la connessione tra il visualizzatore e. CloudFront Il valore dell'intestazione è nel seguente formato:

    SSL/TLS_version:cipher:handshake_information

    Per handshake_information, l'intestazione può contenere uno dei seguenti valori:

    • fullHandshake— È stata eseguita una stretta di mano completa per la sessione SSL TLS /.

    • sessionResumed— È stata ripresa una TLS sessioneSSL/precedente.

    • connectionReused— Una TLS connessioneSSL/precedente è stata riutilizzata.

    Di seguito sono riportati alcuni valori di esempio per questa intestazione:

    TLSv1.3:TLS_AES_128_GCM_SHA256:sessionResumed
    TLSv1.2:ECDHE-ECDSA-AES128-GCM-SHA256:connectionReused
    TLSv1.1:ECDHE-RSA-AES128-SHA256:fullHandshake
    TLSv1:ECDHE-RSA-AES256-SHA:fullHandshake

    Per l'elenco completo delle possibili TLS versioni e cifrari diSSL/che possono essere presenti in questo valore di intestazione, vedi. Protocolli e cifrari supportati tra visualizzatori e CloudFront

    Nota

    È possibile aggiungere CloudFront-Viewer-TLS in una policy della richiesta di origine, ma non in una policy della cache.