Création d'une AWS API demande signée

• HTTPMethod — La HTTP méthode, telle que GETPUT,HEAD, etDELETE.

• CanonicalUri URI— La version codée du composant de chemin absoluURI, en commençant par le / qui suit le nom de domaine et jusqu'à la fin de la chaîne ou jusqu'au point d'interrogation (?) si vous avez des paramètres de chaîne de requête. Si le chemin absolu est vide, utilisez une barre oblique (/). URIDans l'exemple suivant,/amzn-s3-demo-bucket/myphoto.jpg, est le chemin absolu et vous ne le codez pas / dans le chemin absolu :

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

• CanonicalQueryString — Les paramètres de chaîne de requête URI codés. Vous URI encodez chaque nom et chaque valeur individuellement. Vous devez également trier les paramètres de la chaîne de requête canonique par ordre alphabétique par nom de clé. Le tri s'effectue après l'encodage. Dans l'URIexemple suivant, la chaîne de requête est la suivante :

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

  La chaîne de requête canonique est la suivante (des sauts de ligne sont ajoutés à cet exemple pour faciliter la lecture) :

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

  Lorsqu'une demande cible une sous-ressource, la valeur du paramètre de requête correspondante sera une chaîne vide (""). Par exemple, ce qui suit URI identifie la ACL sous-ressource du amzn-s3-demo-bucket bucket :

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

  Dans ce cas, il s' CanonicalQueryString agirait de :

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

  S'il URI n'inclut pas un?, il n'y a pas de chaîne de requête dans la demande et vous définissez la chaîne de requête canonique sur une chaîne vide (""). Vous devrez toujours inclure le caractère de nouvelle ligne ("\n").

• CanonicalHeaders — Liste des en-têtes de requêtes avec leurs valeurs. Les paires de nom d'en-tête et de valeur individuelles sont séparées par le caractère de nouvelle ligne ("\n"). Voici un exemple de CanonicalHeader :

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

  CanonicalHeaders la liste doit inclure les éléments suivants :

  • HTTPhosten-tête.

  • Si l'Content-Typeen-tête est présent dans la demande, vous devez l'ajouter au CanonicalHeaders liste.

  • Les en-têtes x-amz-* que vous prévoyez d'inclure dans votre demande doivent également être ajoutés. Par exemple, si vous utilisez des informations d'identification de sécurité temporaires, vous devez inclure x-amz-security-token dans votre demande. Vous devez ajouter cet en-tête dans la liste des CanonicalHeaders.

  Note

  L'x-amz-content-sha256en-tête est obligatoire pour les AWS requêtes Amazon S3. Il fournit un hachage de la charge utile de la requête. S'il n'y a pas de charge utile, vous devez fournir le hachage d'une chaîne vide.

  Chaque nom d'en-tête doit :

  • utiliser des caractères minuscules ;

  • apparaître par ordre alphabétique ;

  • être suivi de deux points (:).

  Pour les valeurs, vous devez :

  • supprimer toutes les espaces de début ou de fin ;

  • convertir des espaces séquentielles en une espace unique ;

  • séparez les valeurs d'un en-tête à valeurs multiples par des virgules.

  • Vous devez inclure l'en-tête de l'hôte (HTTP/1.1) ou l'en-tête:authority (HTTP/2), ainsi que tous x-amz-* les en-têtes de la signature. Vous pouvez éventuellement inclure d'autres en-têtes standard dans la signature, tels que content-type.

  Les fonctions Lowercase() et Trim() utilisées dans cet exemple sont décrites dans la section précédente.

  L'exemple suivant est une chaîne CanonicalHeaders. Les noms d'en-tête sont en minuscules et sont triés.

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

  Note

  Aux fins du calcul d'une signature d'autorisation, seuls l'hôte et les en-têtes x-amz-* sont obligatoires. Toutefois, afin d'éviter toute altération des données, vous devez envisager d'inclure tous les en-têtes dans le calcul de la signature.

• SignedHeaders — Une liste triée par ordre alphabétique et séparée par des points-virgules de noms d'en-têtes de demande en minuscules. Les en-têtes de demande de la liste sont les mêmes que ceux que vous avez inclus dans la chaîne CanonicalHeaders. Dans l'exemple précédent, la valeur de SignedHeaders serait le suivant :

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

• HashedPayload — Chaîne créée à l'aide de la charge utile contenue dans le corps de la HTTP demande comme entrée d'une fonction de hachage. Cette chaîne utilise des caractères hexadécimaux minuscules.

  Hex(SHA256Hash(<payload>>))

  Si la demande ne contient aucune charge utile, vous calculez un hachage de la chaîne vide. Par exemple, lorsque vous récupérez un objet à l'aide d'une GET demande, il n'y a rien dans la charge utile.

  Hex(SHA256Hash(""))

  Note

  Pour Amazon S3, incluez la chaîne littérale UNSIGNED-PAYLOAD lors de la création d'une demande canonique et définissez la même valeur que la valeur d'x-amz-content-sha256en-tête lors de l'envoi de la demande.

  Hex(SHA256Hash("UNSIGNED-PAYLOAD"))

• Algorithm — Algorithme utilisé pour créer le hachage de la demande canonique. Pour SHA -256, l'algorithme estAWS4-HMAC-SHA256.

• RequestDateTime — Date et heure utilisées dans le champ d'application des informations d'identification. Cette valeur correspond à l'UTCheure actuelle au format ISO 8601 (par exemple,20130524T000000Z).

• CredentialScope — L'étendue des informations d'identification, qui limite la signature résultante à la région et au service spécifiés. Le format de la chaîne est le suivant : YYYYMMDD/region/service/aws4_requête.

• HashedCanonicalRequest — Le hachage de la demande canonique, calculé à l'étape précédente.

Entrée obligatoire

• Key, une chaîne qui contient votre clé d'accès secrète.

• Date, une chaîne qui contient la date utilisée dans le champ d'application des informations d'identification, au format YYYYMMDD.

• Region, une chaîne qui contient le code de région (par exemple,us-east-1).

  Pour obtenir la liste des chaînes de régions, consultez la section Points de terminaison régionaux dans le Références générales AWS.

• Service, une chaîne qui contient le code du service (par exemple,ec2).

• Chaîne de connexion que vous avez créée à l'étape précédente.