Authentification des demandes : utilisation des paramètres de requête (AWS Signature (version 4)

Comme décrit dans la présentation de l'authentification (voirMéthodes d'authentification), vous pouvez fournir des informations d'authentification à l'aide de paramètres de chaîne de requête. L'utilisation de paramètres de requête pour authentifier les demandes est utile lorsque vous souhaitez exprimer une demande entièrement dans une URL. Cette méthode est également appelée présignature d'une URL.

Un scénario d'utilisation pour les URL présignées est que vous pouvez accorder un accès temporaire à vos ressources Amazon S3. Par exemple, vous pouvez intégrer une URL présignée sur votre site Web ou l'utiliser dans un client de ligne de commande (tel que Curl) pour télécharger des objets.

Voici un exemple d'URL présignée.

https://examplebucket.s3.amazonaws.com/test.txt
?X-Amz-Algorithm=AWS4-HMAC-SHA256
&X-Amz-Credential=<your-access-key-id>/20130721/us-east-1/s3/aws4_request
&X-Amz-Date=20130721T201207Z
&X-Amz-Expires=86400
&X-Amz-SignedHeaders=host
&X-Amz-Signature=<signature-value>  

Dans l'exemple d'URL, notez ce qui suit :

Le tableau suivant décrit les paramètres de requête de l'URL qui fournissent des informations d'authentification.

<your-access-key-id>/<date>/<Région AWS>/<AWS-service>/aws4_request

AKIAIOSFODNN7EXAMPLE/20130721/us-east-1/s3/aws4_request

Calculer une signature

Le schéma suivant illustre le processus de calcul de la signature.

Le tableau suivant décrit les fonctions présentées dans le schéma. Vous devez implémenter du code pour ces fonctions.

public static String UriEncode(CharSequence input, boolean encodeSlash) {
          StringBuilder result = new StringBuilder();
          for (int i = 0; i < input.length(); i++) {
              char ch = input.charAt(i);
              if ((ch >= 'A' && ch <= 'Z') || (ch >= 'a' && ch <= 'z') || (ch >= '0' && ch <= '9') || ch == '_' || ch == '-' || ch == '~' || ch == '.') {
                  result.append(ch);
              } else if (ch == '/') {
                  result.append(encodeSlash ? "%2F" : ch);
              } else {
                  result.append(toHexUTF8(ch));
              }
          }
          return result.toString();
      }

Pour plus d'informations sur le processus de signature (détails sur la création d'une demande canonique, chaîne à signer et calculs de signature), consultezCalculs de signature pour l'en-tête d'autorisation : transfert de la charge utile en un seul bloc (AWS Signature (version 4). Le processus est généralement le même, sauf que la création de CanonicalRequest dans une URL présignée diffère comme suit :

Un exemple

Supposons que vous ayez un objet test.txt dans votre examplebucket seau. Vous souhaitez partager cet objet avec d'autres personnes pendant 24 heures (86 400 secondes) en créant une URL présignée.

https://examplebucket.s3.amazonaws.com/test.txt
?X-Amz-Algorithm=AWS4-HMAC-SHA256
&X-Amz-Credential=AKIAIOSFODNN7EXAMPLE%2F20130524%2Fus-east-1%2Fs3%2Faws4_request
&X-Amz-Date=20130524T000000Z&X-Amz-Expires=86400&X-Amz-SignedHeaders=host
&X-Amz-Signature=<signature-value>

Les étapes suivantes illustrent d'abord les calculs de signature, puis la construction de l'URL présignée. L'exemple fait les hypothèses supplémentaires suivantes :

Vous pouvez utiliser cet exemple comme scénario de test pour vérifier la signature calculée par votre code ; toutefois, vous devez utiliser le même nom de compartiment, la même clé d'objet, le même horodatage et les exemples d'informations d'identification suivants :

Exemple 2

L'exemple suivant (sans rapport avec l'exemple précédent) montre une URL présignée avec le X-Amz-Security-Token paramètre.

https://examplebucket.s3.us-east-1.amazonaws.com/test.txt
?X-Amz-Algorithm=AWS4-HMAC-SHA256
&X-Amz-Credential=AKIAIOSFODNN7EXAMPLE%2F20130524%2Fus-east-1%2Fs3%2Faws4_request
&X-Amz-Date=20200524T000000Z&X-Amz-Expires=86400&X-Amz-SignedHeaders=host
&X-Amz-Security-Token=IQoJb3JpZ2luX2VjEMv%2F%2F%2F%2F%2F%2F%2F%2F%2F%2FwEaCXVzLWVhc3QtMSJGMEQCIBSUbVdj9YGs2g0HkHsOHFdkwOozjARSKHL987NhhOC8AiBPepRU1obMvIbGU0T%2BWphFPgK%2Fqpxaf5Snvm5M57XFkCqlAgjz%2F%2F%2F%2F%2F%2F%2F%2F%2F%2F8BEAAaDDQ3MjM4NTU0NDY2MCIM83pULBe5%2F%2BNm1GZBKvkBVslSaJVgwSef7SsoZCJlfJ56weYl3QCwEGr2F4BmCZZyFpmWEYzWnhNK1AnHMj5nkfKlKBx30XAT5PZGVrmq4Vkn9ewlXQy1Iu3QJRi9Tdod8Ef9%2FyajTaUGh76%2BF5u5a4O115jwultOQiKomVwO318CO4l8lv%2F3HhMOkpdanMXn%2B4PY8lvM8RgnzSu90jOUpGXEOAo%2F6G8OqlMim3%2BZmaQmasn4VYRvESEd7O72QGZ3%2BvDnDVnss0lSYjlv8PP7IujnvhZRnj0WoeOyMe1lL0wTG%2Fa9usH5hE52w%2FYUJccOn0OaZuyROuVsRV4Q70sbWQhUvYUt%2B0tUMKzm8vsFOp4BaNZFqobbjtb36Y92v%2Bx5kY6i0s8QE886jJtUWMP5ldMziClGx3p0mN5dzsYlM3GyiJ%2FO1mWkPQDwg3mtSpOA9oeeuAMPTA7qMqy9RNuTKBDSx9EW27wvPzBum3SJhEfxv48euadKgrIX3Z79ruQFSQOc9LUrDjR%2B4SoWAJqK%2BGX8Q3vPSjsLxhqhEMWd6U4TXcM7ku3gxMbzqfT8NDg%3D
&X-Amz-Signature=<signature-value>