驗證請求：使用查詢參數AWS （簽章第 4 版）

如身分驗證概觀中所述 （請參閱身分驗證方法)，您可以使用查詢字串參數提供身分驗證資訊。當您想要完全在 URL 中表達請求時，使用查詢參數來驗證請求非常有用。此方法也稱為預先簽署 URL。

預先簽章 URLs 的使用案例是，您可以授予暫時存取 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();
      }

如需簽署程序的詳細資訊 （建立正式請求、要簽署的字串和簽章計算的詳細資訊），請參閱 授權標頭的簽章計算：在單一區塊中傳輸承載AWS （簽章第 4 版）。程序通常相同，但在預先簽章的 URL 中建立 CanonicalRequest 會有所不同，如下所示：

範例

假設您的儲存examplebucket貯體test.txt中有物件。您想要透過建立預先簽章的 URL，與其他人共用此物件 24 小時 (86400 秒）。

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>