Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
# CloudFront Anforderungsheader hinzufügen
[Sie können so konfigurieren CloudFront , dass den Anfragen, die von Zuschauern CloudFront empfangen werden, spezifische HTTP-Header hinzugefügt und an Ihre Origin- oder Edge-Funktion weitergeleitet werden.](edge-functions.md) Die Werte dieser HTTP-Header basieren auf den Eigenschaften des Viewers oder der Viewer-Anforderung. Die Header enthalten Informationen über den Gerätetyp, die IP-Adresse, den geografischen Standort, das Anforderungsprotokoll (HTTP oder HTTPS), die HTTP-Version, die TLS-Verbindungsdetails, den Fingerabdruck und den [JA3 Fingerabdruck](https://github.com/salesforce/ja3) des Betrachters. JA4 Sie können das Cache-Verhalten Ihrer Distribution auch so konfigurieren, dass WebSocket Header weitergeleitet werden. Weitere Informationen finden Sie unter [WebSockets Mit CloudFront Distributionen verwenden](distribution-working-with.websockets.md).
Mit diesen Headern kann Ihr Ursprung oder Ihre Edge-Funktion Informationen über den Viewer abrufen, sodass Sie keinen eigenen Code schreiben müssen, um diese Informationen zu ermitteln. Wenn Ihr Origin auf der Grundlage der Informationen in diesen Headern unterschiedliche Antworten zurückgibt, können Sie diese in den *Cache-Schlüssel* aufnehmen, sodass die Antworten separat CloudFront zwischengespeichert werden. Beispielsweise könnte der Ursprung basierend auf dem Land, in dem sich der Viewer befindet, mit Inhalten in einer spezifischen Sprache antworten oder er könnte mit Inhalten antworten, die auf einen spezifischen Gerätetyp zugeschnitten sind. Der Ursprung könnte diese Header auch in Protokolldateien schreiben, mit denen Sie Informationen über die Standorte und Gerätetypen der Viewer und vieles mehr ermitteln können.
Um diese Header in den Cache-Schlüssel einzufügen, verwenden Sie eine *Cache-Richtlinie*. Weitere Informationen erhalten Sie unter [Steuern des Cache-Schlüssels mit einer Richtlinie](controlling-the-cache-key.md) und [Grundlegendes zum Cache-Schlüssel](understanding-the-cache-key.md).
Wenn Sie Header am Ursprung empfangen, diese aber nicht in den Cache-Schlüssel einschließen möchten, verwenden Sie eine *Ursprungsanforderungsrichtlinie*. Weitere Informationen finden Sie unter [Steuern von Ursprungsanforderungen anhand einer Richtlinie](controlling-origin-requests.md).
**Topics**
+ [Gerätetyp-Header](#cloudfront-headers-device-type)
+ [Viewer-Standort-Header](#cloudfront-headers-viewer-location)
+ [Header zur Bestimmung der Header-Struktur des Viewers](#cloudfront-headers-viewer-headers)
+ [TLS-bezogene Header](#tls-related-versions)
+ [Andere Header CloudFront](#cloudfront-headers-other)
## Gerätetyp-Header
Mit den folgenden Headern können Sie den Gerätetyp des Viewers ermitteln. CloudFront Legt den Wert dieser `User-Agent` Header basierend auf dem Wert des Headers auf oder fest. `true` `false` Wenn ein Gerät in mehr als eine Kategorie fällt, können mehrere Werte `true` sein. CloudFront Legt z. B. bei einigen Tablet-Geräten `CloudFront-Is-Mobile-Viewer` sowohl als auch `CloudFront-Is-Tablet-Viewer` auf `true` fest.
+ `CloudFront-Is-Android-Viewer`— `true` Wird auf „Wenn“ gesetzt, wird CloudFront bestimmt, dass es sich bei dem Viewer um ein Gerät mit dem Betriebssystem Android handelt.
+ `CloudFront-Is-Desktop-Viewer`— Auf „`true`Wenn“ eingestellt, wird CloudFront bestimmt, dass es sich bei dem Viewer um ein Desktop-Gerät handelt.
+ `CloudFront-Is-IOS-Viewer`— Auf „`true`Wenn“ gesetzt, wird CloudFront bestimmt, dass es sich beim Viewer um ein Gerät mit einem mobilen Apple-Betriebssystem wie iPhone, iPod touch und einigen iPad-Geräten handelt.
+ `CloudFront-Is-Mobile-Viewer`— Auf „`true`Wenn“ eingestellt, wird CloudFront bestimmt, dass es sich bei dem Betrachter um ein Mobilgerät handelt.
+ `CloudFront-Is-SmartTV-Viewer`— Auf „`true`Wenn“ eingestellt, wird CloudFront bestimmt, dass es sich bei dem Zuschauer um ein Smart-TV handelt.
+ `CloudFront-Is-Tablet-Viewer`— Auf „`true`Wenn“ eingestellt, wird CloudFront bestimmt, dass es sich bei dem Zuschauer um ein Tablet handelt.
## Viewer-Standort-Header
Sie können die folgenden Header hinzufügen, um den Standort des Betrachters zu bestimmen. CloudFront bestimmt die Werte für diese Header auf der Grundlage der IP-Adresse des Betrachters. [Bei Nicht-ASCII-Zeichen in den Werten dieser Header wird das Zeichen gemäß Abschnitt 1.2 von RFC CloudFront 3986 mit Prozent codiert.](https://tools.ietf.org/html/rfc3986#section-2.1)
+ `CloudFront-Viewer-Address` – Enthält die IP-Adresse des Viewers und den Quell-Port der Anforderung. Der Header-Wert `198.51.100.10:46532` bedeutet beispielsweise, dass die IP-Adresse des Viewers 198.51.100.10 lautet und der Quell-Port der Anforderung 46532 ist.
+ `CloudFront-Viewer-ASN` – Enthält die autonome Systemnummer (ASN) des Viewers.
**Anmerkung**
`CloudFront-Viewer-Address` und `CloudFront-Viewer-ASN` können in einer Ursprungsanforderungsrichtlinie, aber nicht in einer Cache-Richtlinie hinzugefügt werden.
+ `CloudFront-Viewer-Country` – Enthält den zweistelligen Ländercode für das Land des Viewers. Die Liste der Ländercodes finden Sie unter [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2).
+ `CloudFront-Viewer-City` – Enthält den Namen der Stadt des Viewers.
*Wenn Sie die folgenden Header hinzufügen, werden sie auf alle Anfragen CloudFront angewendet, mit Ausnahme derjenigen, die aus dem Netzwerk stammen:* AWS
+ `CloudFront-Viewer-Country-Name` – Enthält den Namen des Landes des Viewers.
+ `CloudFront-Viewer-Country-Region` – Enthält einen Code (bis zu drei Zeichen), der die Region des Viewers darstellt. Die Region ist die Unterteilung der ersten Ebene (die breiteste oder am wenigsten spezifische) des Codes [ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2).
+ `CloudFront-Viewer-Country-Region-Name` – Enthält den Namen der Region des Viewers. Die Region ist die Unterteilung der ersten Ebene (die breiteste oder am wenigsten spezifische) des Codes [ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2).
+ `CloudFront-Viewer-Latitude` – Enthält den ungefähren Breitengrad des Viewers.
+ `CloudFront-Viewer-Longitude` – Enthält den ungefähren Längengrad des Viewers.
+ `CloudFront-Viewer-Metro-Code` – Enthält den Metro-Code des Viewers. Dieser wird nur verwendet, wenn sich der Viewer in den Vereinigten Staaten befindet.
+ `CloudFront-Viewer-Postal-Code` – Enthält die Postleitzahl des Viewers.
+ `CloudFront-Viewer-Time-Zone` Enthält die Zeitzone des Viewers im [IANA-Zeitzonen-Datenbankformat](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones) (z. B. `America/Los_Angeles`).
**Anmerkung**
`CloudFront-Viewer-City`, `CloudFront-Viewer-Metro-Code` und `CloudFront-Viewer-Postal-Code` sind möglicherweise nicht für jede IP-Adresse verfügbar. Einige IP-Adressen können nicht mit ausreichender Genauigkeit geolokalisiert werden, um diese Informationen zu erhalten.
## Header zur Bestimmung der Header-Struktur des Viewers
Sie können jetzt die folgenden Header hinzufügen, um den Viewer leichter anhand der gesendeten Header identifizieren zu können. So können beispielsweise verschiedene Browser HTTP-Header in einer bestimmten Reihenfolge senden. Wenn der im `User-Agent`-Header angegebene Browser nicht mit der erwarteten Header-Reihenfolge dieses Browsers übereinstimmt, können Sie die Anforderung ablehnen. Auch wenn der `CloudFront-Viewer-Header-Count`-Wert nicht mit der Anzahl der Header in `CloudFront-Viewer-Header-Order` übereinstimmt, können Sie die Anforderung ablehnen.
+ `CloudFront-Viewer-Header-Order` – Enthält die Header-Namen des Viewers in der angeforderten Reihenfolge, getrennt durch einen Doppelpunkt. Beispiel: `CloudFront-Viewer-Header-Order: Host:User-Agent:Accept:Accept-Encoding`. Header, die das Zeichenlimit von 7 680 überschreiten, werden abgeschnitten.
+ `CloudFront-Viewer-Header-Count` – Enthält die Gesamtzahl der Header des Viewers.
## TLS-bezogene Header
Sie können die folgenden Header hinzufügen, um den Fingerabdruck, den JA3 Fingerabdruck und die TLS-Verbindungsdetails JA4 des Betrachters zu ermitteln:
+ `CloudFront-Viewer-JA3-Fingerprint`— Enthält den [JA3 Fingerabdruck](https://github.com/salesforce/ja3) des Betrachters. Anhand des JA3 Fingerabdrucks können Sie feststellen, ob die Anfrage von einem bekannten Client stammt, ob es sich dabei um Malware oder einen böswilligen Bot oder um eine erwartete Anwendung handelt (auf der Zulassungsliste).
+ `CloudFront-Viewer-JA4-Fingerprint`— Enthält den JA4 Fingerabdruck des Betrachters. Ähnlich wie beim JA3 Fingerabdruck können Sie anhand des [JA4 Fingerabdrucks](https://github.com/FoxIO-LLC/ja4) feststellen, ob die Anfrage von einem bekannten Client stammt, ob es sich dabei um Malware oder einen böswilligen Bot oder um eine erwartete Anwendung handelt (auf der Zulassungsliste). Sie können den Fingerprint verwenden, um eine Datenbank mit bekannten guten und schlechten Akteuren zu erstellen, die Sie bei der Überprüfung von HTTP-Anforderungen verwenden können. Anschließend können Sie den Header-Wert auf Ihren Anwendungs-Webservern oder in Ihren [Lambda @Edge](lambda-at-the-edge.md) und [CloudFront Functions](cloudfront-functions.md) überprüfen, um den Header-Wert mit einer Liste bekannter Malware-Fingerabdrücke zu vergleichen, um böswillige Clients zu blockieren.
+ `CloudFront-Viewer-TLS`— Enthält die SSL/TLS Version, die Chiffre und Informationen über den SSL/TLS Handshake, der für die Verbindung zwischen dem Betrachter und verwendet wurde. CloudFront Der Header-Wert weist das folgende Format auf:
```
{{SSL/TLS_version}}:{{cipher}}:{{handshake_information}}
```
Der `{{handshake_information}}`-Header kann einen der folgenden Werte enthalten:
+ `fullHandshake`— Für die Sitzung wurde ein vollständiger Handshake durchgeführt. SSL/TLS
+ `sessionResumed`— Eine vorherige SSL/TLS Sitzung wurde wieder aufgenommen.
+ `connectionReused`— Eine vorherige SSL/TLS Verbindung wurde wiederverwendet.
Im Folgenden finden Sie einige Beispielwerte für diesen Header:
```
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
```
Eine vollständige Liste der möglichen SSL/TLS Versionen und Chiffren, die in diesem Header-Wert enthalten sein können, finden Sie unter. [Unterstützte Protokolle und Chiffren zwischen Zuschauern und CloudFront](secure-connections-supported-viewer-protocols-ciphers.md)
**Hinweise**
Die JA4 Fingerabdrücke JA3 und die Fingerabdrücke werden aus dem Paket abgeleitet. SSL/TLS `Client Hello` Sie sind nur für HTTPS-Anforderungen vorhanden.
Dese TLS-bezogenen Header können Sie zu einer [Ursprungsanforderungsrichtlinie](controlling-origin-requests.md) hinzufügen, aber nicht zu einer [Cache-Richtlinie.](controlling-the-cache-key.md)
## Andere Header CloudFront
Sie können die folgenden Header hinzufügen, um den ursprünglichen Anforderungs-URI, die Abfragezeichenfolgeparameter und Werte der ursprünglichen Anforderung, das Protokoll und die Version zu ermitteln:
+ `CloudFront-Error-Uri` – enthält den ursprünglichen Anforderung-URI, der vom Viewer empfangen wurde.
+ `CloudFront-Error-Args` – enthält die Abfragezeichenfolgeparameter und Werte der ursprünglichen Anforderung.
+ `CloudFront-Forwarded-Proto` – Enthält das Protokoll der Anforderung des Viewers (HTTP oder HTTPS).
+ `CloudFront-Viewer-Http-Version` – Enthält die HTTP-Version der Anforderung des Viewers.