Einrichten signierter Cookies mit einer vordefinierten Richtlinie

Um ein signiertes Cookie mit einer vordefinierten Richtlinie einzurichten, führen Sie die folgenden Schritte aus. Zum Erstellen einer Signatur vgl. Erstellen einer Signatur für ein signiertes Cookie, das eine vordefinierte Richtlinie verwendet.

So richten Sie ein signiertes Cookies mit einer vordefinierten Richtlinie ein

1. Wenn Sie .NET oder Java verwenden, um signierte Cookies zu erstellen, und den privaten Schlüssel für Ihr Schlüsselpaar noch nicht vom PEM-Standardformat in ein mit .NET oder Java kompatibles Format neu formatiert haben, holen Sie diesen Schritt jetzt nach. Weitere Informationen finden Sie unter Neuformatierung des privaten Schlüssels (nur .NET und Java).

2. Programmieren Sie Ihre Anwendung so, dass drei Set-Cookie-Header an genehmigte Viewer gesendet werden. Sie benötigen drei Set-Cookie-Header, weil jeder Set-Cookie-Header nur ein Name-Wert-Paar enthalten kann und ein CloudFront -signiertes Cookie drei Name-Wert-Paare erfordert. Die Name-Wert-Paare sind: CloudFront-Expires, CloudFront-Signature und CloudFront-Key-Pair-Id. Die Werte müssen auf dem Viewer vorhanden sein, bevor ein Benutzer die erste Anfrage für eine Datei stellt, bei der der Zugriff kontrolliert werden soll.

   Anmerkung

   Im Allgemeinen empfehlen wir, die Attribute Expires und Max-Age auszuschließen. Der Ausschluss der Attribute bewirkt, dass der Browser das Cookie löscht, wenn der Benutzer den Browser schließt. Dies verringert das Risiko, dass ein Benutzer unbefugten Zugriff auf Ihre Inhalte erhält. Weitere Informationen finden Sie unter Verhindern der missbräuchlichen Verwendung von signierten Cookies.

   Bei den Namen der Cookie-Attribute muss die Groß- und Kleinschreibung beachtet werden.

   Zeilenumbrüche werden nur hinzugefügt, damit die Attribute besser lesbar sind.

   Set-Cookie: 
   CloudFront-Expires=date and time in Unix time format (in seconds) and Coordinated Universal Time (UTC); 
   Domain=optional domain name; 
   Path=/optional directory path; 
   Secure; 
   HttpOnly
   
   Set-Cookie: 
   CloudFront-Signature=hashed and signed version of the policy statement; 
   Domain=optional domain name; 
   Path=/optional directory path; 
   Secure; 
   HttpOnly
   
   Set-Cookie: 
   CloudFront-Key-Pair-Id=public key ID for the CloudFront public key whose corresponding private key you're using to generate the signature; 
   Domain=optional domain name; 
   Path=/optional directory path; 
   Secure; 
   HttpOnly

   (Optional) Domain

   Der Domänenname für die angeforderte Datei. Wenn Sie kein Domain-Attribut angeben, ist der Standardwert der Domänenname in der URL und dieser gilt nur für die angegebenen Domänennamen, nicht für Unterdomänen. Wenn Sie ein Domain-Attribut angeben, gilt dieses auch für Unterdomänen. Ein vorangestellter Punkt im Domänennamen (z. B. Domain=.example.com) ist optional. Wenn Sie ein Domain-Attribut angeben, müssen darüber hinaus der Domänenname in der URL und der Wert des Domain-Attributs übereinstimmen.

   Sie können den Domänennamen angeben, den Ihrer Verteilung CloudFront zugewiesen hat, z. B. d111111abcdef8.cloudfront.net, aber Sie können *.cloudfront.net nicht für den Domänennamen angeben.

   Wenn Sie einen alternativen Domänennamen wie beispielsweise example.com in URLs verwenden möchten, müssen Sie den alternativen Domänennamen zu Ihrer Verteilung hinzufügen, unabhängig davon, ob Sie das Domain-Attribut angeben. Weitere Informationen finden Sie unter Alternative Domänennamen (CNAMEs) im Thema Werte, die Sie beim Erstellen oder Aktualisieren einer Verteilung angeben.

   (Optional) Path

   Der Pfad für die angeforderte Datei. Wenn Sie kein Path-Attribut angeben, ist der Standardwert der Pfad in der URL.

   Secure

   Macht es erforderlich, dass der Viewer Cookies vor dem Senden einer Anfrage verschlüsselt. Wir empfehlen, den -Set-CookieHeader über eine HTTPS-Verbindung zu senden, um sicherzustellen, dass die Cookie-Attribute vor man-in-the-middle Angriffen geschützt sind.

   HttpOnly

   Macht es erforderlich, dass der Viewer das Cookie nur in HTTP- oder HTTPS-Anfragen sendet.

   CloudFront-Expires

   Geben Sie das Ablaufdatum und die Ablaufzeit im Unix-Zeitformat (in Sekunden) und in koordinierter Weltzeit (UTC) an. Beispielsweise wird der 1. Januar 2013, 10:00 Uhr UTC in 1357034400 im Unix-Zeitformat umgewandelt. Um die Epochen-Uhrzeit zu verwenden, geben Sie eine 32-Bit-Ganzzahl für ein Datum an, das nicht nach 2147483647 (19. Januar 2038 um 03:14:07 UTC) liegt. Weitere Informationen zu UTC finden Sie unter RFC 3339, Datum und Uhrzeit im Internet: Zeitstempel, https://tools.ietf.org/html/rfc3339.

   CloudFront-Signature

   Eine gehashte, signierte und Base64-codierte Version einer JSON-Richtlinienanweisung. Weitere Informationen finden Sie unter Erstellen einer Signatur für ein signiertes Cookie, das eine vordefinierte Richtlinie verwendet.

   CloudFront-Key-Pair-Id

   Die ID für einen CloudFront öffentlichen Schlüssel, z. B. K2JCJMDEHXQW5F. Die ID des öffentlichen Schlüssels gibt an CloudFront , welcher öffentliche Schlüssel zur Validierung der signierten URL verwendet werden soll. CloudFront führt einen Vergleich der Informationen in der Signatur mit den Informationen in der Richtlinienanweisung durch, um zu überprüfen, ob die URL nicht manipuliert wurde.

   Dieser öffentliche Schlüssel muss zu einer Schlüsselgruppe gehören, die ein vertrauenswürdiger Aussteller in der Verteilung ist. Weitere Informationen finden Sie unter Festlegen der Aussteller, die signierte URLs und signierte Cookies erstellen können.

Das folgende Beispiel zeigt Set-Cookie-Header für ein signiertes Cookie bei Verwendung des mit Ihrer Verteilung verknüpften Domänennamens in den URLs für Ihre Dateien:

Set-Cookie: CloudFront-Expires=1426500000; Domain=d111111abcdef8.cloudfront.net; Path=/images/*; Secure; HttpOnly
Set-Cookie: CloudFront-Signature=yXrSIgyQoeE4FBI4eMKF6ho~CA8_; Domain=d111111abcdef8.cloudfront.net; Path=/images/*; Secure; HttpOnly
Set-Cookie: CloudFront-Key-Pair-Id=K2JCJMDEHXQW5F; Domain=d111111abcdef8.cloudfront.net; Path=/images/*; Secure; HttpOnly

Das folgende Beispiel zeigt Set-Cookie-Header für ein signiertes Cookie bei Verwendung des alternativen Domänennamens example.org in den URLs für Ihre Dateien:

Set-Cookie: CloudFront-Expires=1426500000; Domain=example.org; Path=/images/*; Secure; HttpOnly
Set-Cookie: CloudFront-Signature=yXrSIgyQoeE4FBI4eMKF6ho~CA8_; Domain=example.org; Path=/images/*; Secure; HttpOnly
Set-Cookie: CloudFront-Key-Pair-Id=K2JCJMDEHXQW5F; Domain=example.org; Path=/images/*; Secure; HttpOnly

Wenn Sie einen alternativen Domänennamen wie beispielsweise example.com in URLs verwenden möchten, müssen Sie den alternativen Domänennamen zu Ihrer Verteilung hinzufügen, unabhängig davon, ob Sie das Domain-Attribut angeben. Weitere Informationen finden Sie unter Alternative Domänennamen (CNAMEs) im Thema Werte, die Sie beim Erstellen oder Aktualisieren einer Verteilung angeben.

Erstellen einer Signatur für ein signiertes Cookie, das eine vordefinierte Richtlinie verwendet

Um die Signatur für ein signiertes Cookie zu erstellen, das eine vordefinierte Richtlinie verwendet, gehen Sie wie folgt vor:

1. Erstellen Sie eine Richtlinienanweisung. Siehe Erstellen einer Richtlinienanweisung für ein signiertes Cookie, das eine vordefinierte Richtlinie verwendet.

2. Signieren Sie die Richtlinienanweisung, um eine Signatur zu erstellen. Siehe Signieren der Richtlinienanweisung zum Erstellen einer Signatur für ein signiertes Cookie, das eine vordefinierte Richtlinie verwendet.

Erstellen einer Richtlinienanweisung für ein signiertes Cookie, das eine vordefinierte Richtlinie verwendet

Wenn Sie ein signiertes Cookie einrichten, das eine vordefinierte Richtlinie verwendet, ist das CloudFront-Signature-Attribut eine gehashte und signierte Version einer Richtlinienanweisung. Bei signierten Cookies, die eine vordefinierte Richtlinie verwenden, fügen Sie die Richtlinienanweisung nicht in den Set-Cookie-Header ein, wie Sie es bei signierten Cookies tun, die eine benutzerdefinierte Richtlinie verwenden. Führen Sie die folgenden Schritte aus, um die Richtlinienanweisung zu erstellen.

So erstellen Sie eine Richtlinienanweisung für ein signiertes Cookie, das eine vordefinierte Richtlinie verwendet

1. Erstellen Sie die Richtlinienanweisung unter Verwendung des folgenden JSON-Formats und der UTF-8-Zeichencodierung. Fügen Sie alle Satzzeichen und andere Literalwerte genau wie angegeben ein. Informationen zu den Parametern Resource und DateLessThan finden Sie unter Werte, die Sie in der Richtlinienanweisung für eine vordefinierte Richtlinie für signierte Cookies angeben.

   {
       "Statement": [
           {
               "Resource": "base URL or stream name",
               "Condition": {
                   "DateLessThan": {
                       "AWS:EpochTime": ending date and time in Unix time format and UTC
                   }
               }
           }
       ]
   }

2. Entfernen Sie alle Leerzeichen (einschließlich Tabulatoren und Zeilenumbruchzeichen) aus der Richtlinienanweisung. Möglicherweise müssen Sie in der Zeichenfolge im Anwendungscode Escape-Zeichen einfügen.

Werte, die Sie in der Richtlinienanweisung für eine vordefinierte Richtlinie für signierte Cookies angeben

Beim Erstellen einer Richtlinienanweisung für eine vordefinierte Richtlinie geben Sie die folgenden Werte an:

Ressource

Die Basis-URL einschließlich Ihrer Abfragezeichenfolgen, sofern vorhanden, zum Beispiel:

https://d111111abcdef8.cloudfront.net/images/horizon.jpg?size=large&license=yes

Sie können nur einen Wert für Resource angeben.

Beachten Sie Folgendes:

• Protokoll – Der Wert muss mit http:// oder https:// beginnen.

• Abfragezeichenfolgeparameter – Wenn Sie über keine Abfragezeichenfolgeparameter verfügen, lassen Sie das Fragezeichen weg.

• Alternative Domänennamen – Wenn Sie einen alternativen Domänennamen (CNAME) in der URL angeben, müssen Sie diesen alternativen Domänennamen angeben, wenn Sie auf Ihrer Webseite oder in Ihrer Anwendung auf die Datei verweisen. Geben Sie nicht die Amazon S3-URL für Datei an.

DateLessThan

Das Ablaufdatum und die Ablaufzeit für die URL im Unix-Zeitformat (in Sekunden) und in koordinierter Weltzeit (UTC). Setzen Sie den Wert nicht in Anführungszeichen.

Beispielsweise wird der 16. März 2015, 10:00 Uhr UTC in 1426500000 im Unix-Zeitformat umgewandelt.

Dieser Wert muss mit dem Wert des CloudFront-Expires-Attributs im Set-Cookie-Header übereinstimmen. Setzen Sie den Wert nicht in Anführungszeichen.

Weitere Informationen finden Sie unter Wann CloudFront überprüft das Ablaufdatum und die Ablaufzeit in einem signierten Cookie?.

Beispiel-Richtlinienanweisung für eine vordefinierte Richtlinie

Wenn Sie die folgende Beispiel-Richtlinienanweisung in einem signierten Cookie verwenden, kann ein Benutzer bis zum 16. März 2015, 10:00 Uhr UTC, auf die Datei https://d111111abcdef8.cloudfront.net/horizon.jpg zugreifen:

{
    "Statement": [
        {
            "Resource": "https://d111111abcdef8.cloudfront.net/horizon.jpg?size=large&license=yes",
            "Condition": {
                "DateLessThan": {
                    "AWS:EpochTime": 1426500000
                }
            }
        }
    ]
}

Signieren der Richtlinienanweisung zum Erstellen einer Signatur für ein signiertes Cookie, das eine vordefinierte Richtlinie verwendet

Um den Wert für das CloudFront-Signature-Attribut in einem Set-Cookie-Header zu erstellen, müssen Sie die in So erstellen Sie eine Richtlinienanweisung für ein signiertes Cookie, das eine vordefinierte Richtlinie verwendet erstellte Richtlinienanweisung hashen und signieren.

Weitere Informationen und Beispiele für das Hashing, Signieren und Codieren der Richtlinienanweisung finden Sie in den folgenden Themen:

• Verwenden von Linux-Befehlen und von OpenSSL für die base64-Codierung und die Verschlüsselung

• Code-Beispiele für das Erstellen einer Signatur für eine signierte URL

So erstellen Sie eine Signatur für ein signiertes Cookie mit einer vordefinierten Richtlinie

1. Verwenden Sie die SHA-1-Hash-Funktion und RSA, um die im Verfahren So erstellen Sie eine Richtlinienanweisung für ein signiertes Cookie, das eine vordefinierte Richtlinie verwendet erstellte Richtlinienanweisung zu hashen und zu signieren. Verwenden Sie die Version der Richtlinienanweisung, die keine Leerzeichen mehr enthält.

   Verwenden Sie für den privaten Schlüssel, der für die Hash-Funktion erforderlich ist, einen privaten Schlüssel, dessen öffentlicher Schlüssel sich in einer aktiven vertrauenswürdigen Schlüsselgruppe für die Verteilung befindet.

   Anmerkung

   Die Methode, die Sie zum Hashen und Signieren der Richtlinienanweisung verwenden, ist abhängig von Ihrer Programmiersprache und Plattform. Einen Beispiel-Code finden Sie unter Code-Beispiele für das Erstellen einer Signatur für eine signierte URL.

2. Entfernen Sie alle Leerzeichen (einschließlich Tabulatoren und Zeilenumbruchzeichen) aus der gehashten und signierten Zeichenfolge.

3. Nehmen Sie eine Base64-Codierung der Zeichenfolge mithilfe von MIME-Base64-Codierung vor. Weitere Informationen finden Sie in Abschnitt 6.8, Base64 Content-Transfer-Encoding in RFC 2045, MIME (Multipurpose Internet Mail Extensions) Part One: Format of Internet Message Bodies.

4. Ersetzen Sie Zeichen, die in einer URL-Abfragezeichenfolge nicht gültig sind, durch gültige Zeichen. In der folgenden Tabelle sind ungültige und gültige Zeichen aufgelistet.

   Ersetzen Sie diese ungültigen Zeichen	Durch diese gültigen Zeichen
   +	- (Bindestrich)
   =	_ (Unterstrich)
   /	~ (Tilde)

5. Fügen Sie den resultierenden Wert im Set-Cookie-Header für das CloudFront-Signature-Name-Wert-Paar ein. Kehren Sie anschließend zu So richten Sie ein signiertes Cookies mit einer vordefinierten Richtlinie ein zurück und fügen Sie den Set-Cookie-Header für CloudFront-Key-Pair-Id hinzu.