リクエストの認証: クエリパラメータの使用 (AWS 署名バージョン 4)

認証の概要 (認証方法 を参照) で説明されているように、クエリ文字列パラメータを使用して認証情報を指定できます。リクエストを完全に URL で表現したい場合、クエリパラメータを使用してリクエストを認証するのが便利です。このメソッドは、URL の事前署名とも呼ばれます。

署名付き URL のユースケースシナリオでは、Amazon S3 リソースへの一時的なアクセスを許可できます。例えば、署名付き URL をウェブサイトに埋め込んだり、コマンドラインクライアント (Curl など) で使用してオブジェクトをダウンロードしたりすることができます。

署名付き URL の例を次に示します。

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>  

例の URL では、以下の点に注意してください。

次の表では、認証情報を提供する URL 内のクエリパラメータについて説明します。

<your-access-key-id>/<date>/<AWS リージョン>/<AWS-service>/aws4_request

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

署名の計算

次の図は、署名計算プロセスを示しています。

次の表では、図に示されている関数について説明します。これらの関数のコードを実装する必要があります。

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();
      }

署名プロセスの詳細 (正規リクエストの作成、署名する文字列、署名計算の詳細) については、「Authorization ヘッダーの署名計算: 単一チャンクでのペイロードの転送 (AWS 署名バージョン 4)」を参照してください。このプロセスは一般的には同じですが、署名付き URL での CanonicalRequest の作成方法は、次のように異なります。

例

examplebucket バケットにオブジェクト test.txt があるとします。署名付き URL を作成して、このオブジェクトを 24 時間 (86,400 秒間) 他のユーザーと共有したいと考えています。

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>

次のステップでは、まず署名の計算を行い、次に署名付き URL の構築について説明します。この例では、さらに次を前提としています。

この例をテストケースとして使用して、お客様のコードで計算された署名を検証できます。ただし、同じバケット名、オブジェクトキー、タイムスタンプ、および次の認証情報の例を使用する必要があります。

例 2

以下は、X-Amz-Security-Token パラメータを含む署名付き URL を示す例です (前の例とは無関係です)。

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>