署名付き AWS API リクエストを作成する

• HTTPMethod – GET、PUT、HEAD、DELETE などの HTTP メソッド。

• CanonicalUri – 絶対パスコンポーネント URI の URI エンコード版 (ドメイン名の後の / から始まり、文字列の末尾まで、またはクエリ文字列パラメータがある場合は疑問符文字 (?) まで)。絶対パスが空値の場合は、フォワードスラッシュ文字 (/) を使用します。以下の例の URI (/amzn-s3-demo-bucket/myphoto.jpg) は絶対パスであるため、絶対パス内の / をエンコードしないでください。

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

• CanonicalQueryString – URI エンコードされたクエリ文字列パラメータ。それぞれの名前と値を個別に URI エンコードします。また、正規クエリ文字列内のパラメータをキー名のアルファベット順にソートする必要があります。ソートはエンコード後に行われます。次のサンプル URI のクエリ文字列は次のとおりです。

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

  正規クエリ文字列は次のとおりです (この例では、読みやすいように改行が追加されています)。

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

  リクエストがサブリソースをターゲットにしている場合、対応するクエリパラメータ値は空の文字列 ("") になります。例えば、次の URI は amzn-s3-demo-bucket バケット上の ACL サブリソースを特定してします。

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

  この場合、CanonicalQueryString は以下のようになります。

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

  URI に ? が含まれていない場合は、リクエストにクエリ文字列が存在しないため、正規クエリ文字列を空の文字列 ("") に設定します。この場合も、改行文字 ("\n") を含める必要があります。

• CanonicalHeaders – リクエストヘッダーとその値のリスト。個々のヘッダー名と値のペアは改行文字 ("\n") で区切られます。以下は正規ヘッダーの例です。

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

  CanonicalHeaders リストには以下が含まれている必要があります。

  • HTTP host ヘッダー。

  • Content-Type ヘッダーがリクエスト内に存在する場合は、それを CanonicalHeaders リストに追加する必要があります。

  • リクエストに含める予定の x-amz-* ヘッダーも追加する必要があります。例えば、一時的なセキュリティ認証情報を使用している場合は、リクエストに x-amz-security-token を含める必要があります。このヘッダーを CanonicalHeaders リストに追加する必要があります。

  注記

  x-amz-content-sha256 ヘッダーは Amazon S3 AWS リクエストに必要です。これにより、リクエストペイロードのハッシュが指定されます。ペイロードがない場合は、空の文字列のハッシュを指定する必要があります。

  各ヘッダー名は次の条件を満たす必要があります。

  • 小文字が使用されていること。

  • アルファベット順に表示されていること。

  • 後にコロン (:) が指定されていること。

  値については、次の操作を行う必要があります。

  • 先頭または末尾のスペースをすべて削除する。

  • 連続するスペースを 1 つのスペースに変換する。

  • 複数値ヘッダーの値をカンマで区切る。

  • host ヘッダー (HTTP/1.1) または :authority  ヘッダー (HTTP/2)、および任意の x-amz-* ヘッダーを署名に含める必要があります。署名には、content-type のような他の標準ヘッダーを指定することもできます。

  この例で使用されている関数 Lowercase() と Trim() は、前のセクションで説明されています。

  以下は CanonicalHeaders 文字列の例です。ヘッダー名は小文字で、ソートされています。

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

  注記

  認可署名を計算する目的では、ホストと x-amz-* ヘッダーだけが必要です。ただし、データの改ざんを防ぐために、すべてのヘッダーを署名計算に含めることを検討する必要があります。

• SignedHeaders – アルファベット順にソートされ、セミコロンで区切られた小文字のリクエストヘッダー名のリスト。リスト内のリクエストヘッダーは、CanonicalHeaders 文字列に含めたヘッダーと同じです。前の例の場合、SignedHeaders の値は次のようになります。

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

• HashedPayload — HTTP リクエスト本文のペイロードをハッシュ関数への入力として使用して作成された文字列。この文字列には小文字の 16 進数文字を使用します。

  Hex(SHA256Hash(<payload>>))

  リクエストにペイロードがない場合は、空の文字列のハッシュを計算します。例えば、GET リクエストを使用してオブジェクトを取得する場合、ペイロードには何もありません。

  Hex(SHA256Hash(""))

  注記

  Amazon S3 の場合、正規リクエストを作成するときにはリテラル文字列 UNSIGNED-PAYLOAD を含め、リクエストを送信するときには x-amz-content-sha256 ヘッダー値と同じ値を設定します。

  Hex(SHA256Hash("UNSIGNED-PAYLOAD"))

• Algorithm — 正規リクエストのハッシュを作成するために使用されるアルゴリズム。SHA-256 では、アルゴリズムは AWS4-HMAC-SHA256 です。

• RequestDateTime — 認証情報のスコープで使用される日付と時刻。この値は、ISO 8601 形式の現在の UTC 時刻です (例: 20130524T000000Z)。

• CredentialScope - 認証情報スコープ。これにより、結果として生成した署名が、指定されたリージョンとサービスに制限されます。文字列の形式は YYYYMMDD/region/service/aws4_request です。

• HashedCanonicalRequest - 前のステップで計算した正規リクエストのハッシュ。

入力必須

• Key、シークレットアクセスキーが含まれている文字列。

• Date、認証情報スコープで使用される日付が含まれている YYYYMMDD 形式の文字列。

• Region、リージョンコードが含まれている文字列 (例えば、us-east-1)。

  リージョン文字列のリストについては、「AWS 全般のリファレンス」の「リージョンとエンドポイント」を参照してください。

• Service、サービスコードが含まれている文字列 (例えば、ec2)。

• 上記の手順で作成したトピックを選択します。