建立已簽署 AWS API的請求

• HTTPMethod – HTTP方法，例如 GET、HEAD、 PUT和 DELETE。

• 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"） 分隔。以下是 的範例 CanonicalHeader：

  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.

  注意

  Amazon S3 AWS 請求需要x-amz-content-sha256標頭。其提供請求承載的雜湊。如果沒有承載，您必須提供空字串的雜湊。

  每個標頭名稱必須：

  • 使用小寫字元。

  • 依字母順序顯示。

  • 後面接著冒號 （:）。

  對於值，您必須：

  • 修剪任何前置或結尾空格。

  • 將連續空格轉換為單一空格。

  • 使用逗號分隔多值標頭的值。

  • 您必須在簽章中包含主機標頭 （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請求內文中的承載建立的字串，作為雜湊函數的輸入。此字串使用小寫十六進位字元。

  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 – 憑證範圍中使用的日期和時間。此值是 8601 格式的目前UTC時間 ISO （例如 20130524T000000Z）。

• CredentialScope – 憑證範圍，將產生的簽章限制為指定的區域和服務。字串具有下列格式：YYYYMMDD/region/service/aws4_request。

• HashedCanonicalRequest – 標準請求的雜湊，在上一個步驟中計算。

需要輸入

• Key，一個字串，其中包含您的秘密存取金鑰。

• Date，此字串包含憑證範圍中使用的日期，格式為 YYYYMMDD。

• Region，包含區域代碼的字串 （例如 us-east-1）。

  如需區域字串的清單，請參閱 中的區域端點AWS 一般參考。

• Service，包含服務代碼的字串 （例如 ec2）。

• 在之前步驟中建立的登入字串。