Erstellen Sie eine signierte AWS API Anfrage

• HTTPMethod — Die HTTP Methode, wieGET, PUTHEAD, undDELETE.

• CanonicalUri — Die URI -kodierte Version der absoluten PfadkomponenteURI, beginnend mit dem/, was auf den Domainnamen folgt, bis zum Ende der Zeichenfolge oder bis zum Fragezeichen (?), wenn Sie Parameter für die Abfragezeichenfolge haben. Wenn der absolute Pfad leer ist, verwenden Sie einen Schrägstrich (). / URIIm folgenden Beispiel,/amzn-s3-demo-bucket/myphoto.jpg, ist der absolute Pfad, und Sie kodieren den nicht / im absoluten Pfad:

  http://s3.amazonaws.com/amzn-s3-demo-bucket/myphoto.jpg

• CanonicalQueryString — Die Parameter der URI -kodierten Abfragezeichenfolge. Sie URI -kodieren jeden Namen und Wert einzeln. Sie müssen die Parameter in der kanonischen Abfragezeichenfolge außerdem alphabetisch nach Schlüsselnamen sortieren. Die Sortierung erfolgt nach der Codierung. Die Abfragezeichenfolge im folgenden URI Beispiel lautet:

  http://s3.amazonaws.com/amzn-s3-demo-bucket?prefix=somePrefix&marker=someMarker&max-keys=2

  Die kanonische Abfragezeichenfolge lautet wie folgt (zur besseren Lesbarkeit wurden diesem Beispiel Zeilenumbrüche hinzugefügt):

  UriEncode("marker")+"="+UriEncode("someMarker")+"&"+
  UriEncode("max-keys")+"="+UriEncode("20") + "&" +
  UriEncode("prefix")+"="+UriEncode("somePrefix")

  Wenn eine Anforderung auf eine Unterressource abzielt, ist der entsprechende Abfrageparameterwert eine leere Zeichenfolge ()"". Im Folgenden wird beispielsweise die ACL Unterressource im Bucket URI identifiziert: amzn-s3-demo-bucket

  http://s3.amazonaws.com/amzn-s3-demo-bucket?acl

  In diesem Fall CanonicalQueryString wäre das:

  UriEncode("acl") + "=" + ""

  Wenn URI das keine enthält?, enthält die Anfrage keine Abfragezeichenfolge, und Sie setzen die kanonische Abfragezeichenfolge auf eine leere Zeichenfolge ()"". Sie müssen trotzdem das Zeilenumbruchzeichen () angeben. "\n"

• CanonicalHeaders — Eine Liste von Anforderungsheadern mit ihren Werten. Einzelne Headernamen- und Wertepaare werden durch das Zeilenumbruchzeichen () "\n" getrennt. Das Folgende ist ein Beispiel für ein CanonicalHeader:

  Lowercase(<HeaderName1>)+":"+Trim(<value>)+"\n"
  Lowercase(<HeaderName2>)+":"+Trim(<value>)+"\n"
  ...
  Lowercase(<HeaderNameN>)+":"+Trim(<value>)+"\n"

  CanonicalHeaders Die Liste muss Folgendes enthalten:

  • HTTPhostKopfzeile.

  • Wenn der Content-Type Header in der Anfrage vorhanden ist, müssen Sie ihn zur CanonicalHeaders Liste.

  • Alle x-amz-*-Header, die Sie in Ihre Anfrage aufnehmen möchten, müssen ebenfalls hinzugefügt werden. Wenn Sie beispielsweise temporäre Sicherheitsanmeldeinformationen verwenden, müssen Sie x-amz-security-token in Ihre Anfrage einschließen. Sie müssen diesen Header zur Liste von hinzufügen CanonicalHeaders.

  Anmerkung

  Der x-amz-content-sha256 Header ist für Amazon S3 AWS S3-Anfragen erforderlich. Es stellt einen Hash der Anforderungsnutzlast bereit. Wenn keine Nutzdaten vorhanden sind, müssen Sie den Hash einer leeren Zeichenfolge bereitstellen.

  Jeder Header-Name muss:

  • Kleinbuchstaben verwenden.

  • in alphabetischer Reihenfolge erscheinen.

  • gefolgt von einem Doppelpunkt (:).

  Bei Werten müssen Sie:

  • alle führenden oder nachgestellten Leerzeichen entfernen.

  • aufeinanderfolgende Leerzeichen in ein einzelnes Leerzeichen umwandeln.

  • die Werte für einen mehrwertigen Header durch Kommas trennen.

  • Sie müssen den Host-Header (HTTP/1.1) oder den:authority-Header (HTTP/2) sowie alle x-amz-* Header in die Signatur aufnehmen. Sie können optional andere Standard-Header in die Signatur aufnehmen, z. B. content-type.

  Die in diesem Beispiel verwendeten Lowercase()- und Trim()-Funktionen werden im vorangehenden Abschnitt beschrieben.

  Im Folgenden finden Sie ein Beispiel für eine CanonicalHeaders-Zeichenfolge. Die Header-Namen sind in Kleinbuchstaben geschrieben und sortiert.

  host:s3.amazonaws.com
  x-amz-content-sha256:e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855
  x-amz-date:20130708T220855Z

  Anmerkung

  Für die Berechnung einer Autorisierungssignatur sind nur der Host und etwaige x-amz-*-Header erforderlich. Um jedoch Datenmanipulationen vorzubeugen, sollten Sie erwägen, alle Header in die Signaturberechnung einzubeziehen.

• SignedHeaders — Eine alphabetisch sortierte, durch Semikolons getrennte Liste kleingeschriebener Request-Header-Namen. Bei den Anforderungs-Headern in der Liste handelt es sich um dieselben Header, die Sie in die Zeichenfolge CanonicalHeaders eingeschlossen haben. Für das vorherige Beispiel ist der Wert von SignedHeaders wäre wie folgt:

  host;x-amz-content-sha256;x-amz-date

• HashedPayload — Eine Zeichenfolge, die unter Verwendung der Nutzdaten im Hauptteil der HTTP Anfrage als Eingabe für eine Hash-Funktion erstellt wurde. Diese Zeichenfolge verwendet Hexadezimalzeichen in Kleinbuchstaben.

  Hex(SHA256Hash(<payload>>))

  Wenn die Anfrage keine Nutzlast enthält, berechnen Sie einen Hash aus der leeren Zeichenfolge. Wenn Sie beispielsweise ein Objekt mithilfe einer GET Anfrage abrufen, enthält die Nutzlast nichts.

  Hex(SHA256Hash(""))

  Anmerkung

  Fügen Sie für Amazon S3 die Literalzeichenfolge ein, UNSIGNED-PAYLOAD wenn Sie eine kanonische Anfrage erstellen, und legen Sie beim Senden der Anfrage denselben Wert wie den x-amz-content-sha256 Header-Wert fest.

  Hex(SHA256Hash("UNSIGNED-PAYLOAD"))

• Algorithm — Der Algorithmus, der verwendet wurde, um den Hash der kanonischen Anfrage zu erstellen. Für SHA -256 ist der Algorithmus. AWS4-HMAC-SHA256

• RequestDateTime — Das Datum und die Uhrzeit, die im Bereich der Anmeldeinformationen verwendet werden. Dieser Wert ist die aktuelle UTC Uhrzeit im Format ISO 8601 (z. B.20130524T000000Z).

• CredentialScope — Der Gültigkeitsbereich der Anmeldeinformationen, der die resultierende Signatur auf die angegebene Region und den angegebenen Dienst beschränkt. Die Zeichenfolge hat das folgende Format: YYYYMMDD/region/service/aws4_request.

• HashedCanonicalRequest — Der Hash der kanonischen Anfrage, berechnet im vorherigen Schritt.

Erforderliche Eingabe

• Key, eine Zeichenfolge, die Ihren geheimen Zugriffsschlüssel enthält.

• Date, eine Zeichenfolge, die das im Bereich der Anmeldeinformationen verwendete Datum im Format YYYYMMDDenthält.

• Region, eine Zeichenfolge, die den Regionalcode enthält (z. B.us-east-1).

  Eine Liste der Regionszeichenfolgen finden Sie unter Regionale Endpunkte in der Allgemeine AWS-Referenz.

• Service, eine Zeichenfolge, die den Servicecode enthält (z. B.ec2).

• Die zu signierende Zeichenfolge, die Sie im vorherigen Schritt erstellt haben.