使用 AWS STS 和 AWS 區域使用 AssumeRole 請求憑證使用 AssumeRoleWithWebIdentity 請求憑證使用 AssumeRoleWithSAML 請求憑證使用 GetFederationToken 請求憑證使用 GetSessionToken 請求憑證

請求臨時安全憑證

若要請求暫時性安全憑證，您可以在 AWS Security Token Service API 使用 AWS STS (AWS) 操作。這些包含可建立並提供信任的使用者暫時安全憑證，控制對於 AWS 資源存取的操作。如需有關 AWS STS 的詳細資訊，請參閱 IAM 中的暫時安全憑證。若要了解可用來在擔任角色時請求暫時性安全憑證的不同方法，請參閱擔任角色的方法。

若要呼叫 API 操作，您可以使用其中一個 AWS 軟體開發套件。適用於多種程式設計語言和環境的軟體開發套件，包括 Java、.NET、Python、Ruby、Android 和 iOS。開發套件會負責的工作諸如以密碼演算法簽署請求，必要時重試請求，以及處理錯誤回應。您也可以使用 AWS STS Query API，這在 AWS Security Token Service API 參考中會加以說明。最後，兩個命令列工具都支援 AWS STS 命令：AWS Command Line Interface 以及 AWS Tools for Windows PowerShell。

AWS STS API 操作會建立使用暫時安全憑證的全新工作階段，這些憑證包含存取金鑰對和工作階段權杖。存取金鑰對包含存取金鑰 ID 和秘密金鑰。使用者 (或使用者執行的應用程式) 可以使用這些憑證來存取您的資源。您可以建立角色工作階段，以及透過編寫程式的方式，使用 AWS STS API 操作傳遞工作階段政策和工作階段標籤。所產生工作階段許可會是角色的以身分為基礎的政策和工作階段政策的交集。如需有關工作階段政策的詳細資訊，請參閱工作階段政策。如需有關工作階段標籤的詳細資訊，請參閱在 AWS STS 中傳遞工作階段標籤。

注意

AWS STS API 操作傳回的工作階段字符大小不固定。我們強烈建議您不對大小上限做出任何假設。一般權杖大小小於 4096 個位元組，但有可能會不同。

使用 AWS STS 和 AWS 區域

您可以將 AWS STS API 呼叫傳送到全域端點或其中一個區域端點。如果您選擇比較靠近您的端點，您可以減少延遲並改善您的 API 呼叫的效能。如果可以不再與原始端點通訊，您也可以選擇將您的呼叫導向至其他區域性端點。如果您使用的是各種 AWS 開發套件之一，則使用該 SDK 的方法來指定區域，之後再進行 API 呼叫。如果您手動建構 HTTP API 請求，則必須您自己將請求直接導向到正確的端點。如需詳細資訊，請參閱區域與端點的 AWS STS 一節和在 AWS STS 中管理 AWS 區域。

以下是 API 操作，您可以用於您的 AWS 環境和應用程式中獲取暫時性憑證。

透過自訂身分經紀人請求跨帳戶委派和聯合身分的憑證

AssumeRole API 操作適合讓現有的 IAM 使用者存取其尚無權存取的 AWS 資源。例如，使用者可能需要存取另一個 AWS 帳戶中的資源。它也能夠用來暫時獲得特殊許可，例如，提供多重要素驗證 (MFA)。您必須使用作用中的登入資料呼叫此 API。若要了解誰可以呼叫此操作，請參閱比較 AWS STS 憑證。如需詳細資訊，請參閱建立角色以將許可授予 IAM 使用者及透過 MFA 實現安全的 API 存取。

透過自訂身分經紀人請求跨帳戶委派和聯合身分的臨時安全憑證

使用 AWS 安全憑證進行驗證。必須使用有效的 AWS 安全憑證進行此呼叫。
呼叫 AssumeRole 操作。

以下範例顯示使用 AssumeRole 的範例請求及回應。此範例請求假設指定時間內的 demo 角色具有已包含的工作階段政策、工作階段標籤、外部 ID 和來源身分。產生的工作階段名為 John-session。

範例請求


https://sts.amazonaws.com/
?Version=2011-06-15
&Action=AssumeRole
&RoleSessionName=John-session
&RoleArn=arn:aws::iam::123456789012:role/demo
&Policy=%7B%22Version%22%3A%222012-10-17		 	 	 %22%2C%22Statement%22%3A%5B%7B%22Sid%22%3A%20%22Stmt1%22%2C%22Effect%22%3A%20%22Allow%22%2C%22Action%22%3A%20%22s3%3A*%22%2C%22Resource%22%3A%20%22*%22%7D%5D%7D
&DurationSeconds=1800
&Tags.member.1.Key=Project
&Tags.member.1.Value=Pegasus
&Tags.member.2.Key=Cost-Center
&Tags.member.2.Value=12345
&ExternalId=123ABC
&SourceIdentity=DevUser123
&AUTHPARAMS

在上述範例中顯示的政策值是以下政策的 URL 編碼版本：

範例中的 AUTHPARAMS 參數是簽章的預留位置。簽章是您必須使用 AWS HTTP API 請求包含的身分驗證資訊。我們建議使用 AWS 開發套件來建立 API 請求。執行此作業的其中一個好處是開發套件會為您處理請求簽署。如果您必須手動建立和簽署 API 請求，請移至 Amazon Web Services 一般參考 的使用 Signature 第 4 版簽署 AWS 請求，以了解如何簽署請求。

除了暫時性安全憑證外，回應包含聯合身分使用者的 Amazon Resource Name (ARN) 和憑證過期時間。

範例回應範例


<AssumeRoleResponse xmlns="https://sts.amazonaws.com/doc/2011-06-15/">
<AssumeRoleResult>
<SourceIdentity>DevUser123</SourceIdentity>
<Credentials>
  <SessionToken>
   AQoDYXdzEPT//////////wEXAMPLEtc764bNrC9SAPBSM22wDOk4x4HIZ8j4FZTwdQW
   LWsKWHGBuFqwAeMicRXmxfpSPfIeoIYRqTflfKD8YUuwthAx7mSEI/qkPpKPi/kMcGd
   QrmGdeehM4IC1NtBmUpp2wUE8phUZampKsburEDy0KPkyQDYwT7WZ0wq5VSXDvp75YU
   9HFvlRd8Tx6q6fE8YQcHNVXAkiY9q6d+xo0rKwT38xVqr7ZD0u0iPPkUL64lIZbqBAz
   +scqKmlzm8FDrypNC9Yjc8fPOLn9FX9KSYvKTr4rvx3iSIlTJabIQwj2ICCR/oLxBA==
  </SessionToken>
  <SecretAccessKey>
   wJalrXUtnFEMI/K7MDENG/bPxRfiCYzEXAMPLEKEY
  </SecretAccessKey>
  <Expiration>2019-07-15T23:28:33.359Z</Expiration>
  <AccessKeyId>AKIAIOSFODNN7EXAMPLE</AccessKeyId>
</Credentials>
<AssumedRoleUser>
  <Arn>arn:aws:sts::123456789012:assumed-role/demo/John</Arn>
  <AssumedRoleId>ARO123EXAMPLE123:John</AssumedRoleId>
</AssumedRoleUser>
<PackedPolicySize>8</PackedPolicySize>
</AssumeRoleResult>
<ResponseMetadata>
<RequestId>c6104cbe-af31-11e0-8154-cbc7ccf896c7</RequestId>
</ResponseMetadata>
</AssumeRoleResponse>

注意

AWS 轉換會將傳遞的工作階段政策和工作階段標籤壓縮成具有個別限制的封裝二進位格式。即使您的純文字符合其他需求，您的請求也可能因不符限制而失敗。PackedPolicySize 回應元素會按百分比指出請求的政策和標籤與大小上限的距離。

透過 OIDC 提供者請求憑證

AssumeRoleWithWebIdentity API 操作會傳回一組臨時 AWS 安全憑證，以換取 JSON Web 權杖 (JWT)。其中包括公有身分提供者 (例如 Login with Amazon、Facebook、Google)，以及發行與 OpenID Connect (OIDC) 探索相容的 JWT 的提供者 (例如 GitHub actions 或 Azure Devops)。如需更多詳細資訊，請參閱 OIDC 聯合身分。

注意

AssumeRoleWithWebIdentity 請求未經簽名，且不需要 AWS 憑證。

透過 OIDC 提供者請求憑證

呼叫 AssumeRoleWithWebIdentity 操作。

當您呼叫 AssumeRoleWithWebIdentity 時，AWS 透過使用 IdP 的 JSON Web 金鑰集 (JWKS) 提供的公有金鑰驗證數位簽章，來驗證所提供的權杖。如果權杖有效，且符合 IAM 角色信任政策中規定的所有條件，AWS 會傳回下列資訊給您：
- 一組暫時性安全憑證。這些包含存取金鑰 ID、私密存取金鑰和工作階段權杖。
- 所擔任角色的角色 ID 和 ARN。
- SubjectFromWebIdentityToken 值，其中包含唯一的使用者 ID。
然後，您的應用程式可能會使用回應中傳回的臨時安全憑證來進行 AWS API 呼叫。這個程序與使用長期安全憑證進行 AWS API 呼叫的程序相同。差別在於您必須包含工作階段權杖，這個權杖可讓 AWS 驗證臨時安全憑證是否有效。

您的應用程式應快取 AWS STS 傳回的憑證，並視需要進行重新整理。如果您的應用程式是使用 AWS SDK 建置的，則 SDK 具有憑證提供者，可以在憑證過期之前處理呼叫 AssumeRoleWithWebIdentity 和重新整理 AWS 憑證。如需詳細資訊，請參閱 AWS SDKs and Tools Reference Guide 中的 AWS SDKs and Tools standardized credential providers。

透過 SAML 2.0 身分提供者請求憑證

AssumeRoleWithSAML API 操作會傳回 SAML 聯合身分主體的一組臨時安全憑證，這些主體透過您組織現有的身分系統進行驗證。使用者還必須使用 SAML 2.0 (安全聲明標記語言) 來將身分驗證和授權資訊傳遞至 AWS。這個 API 操作適用於整合他們自己的身分系統的組織 (例如，Windows Active Directory 或 OpenLDAP)，而軟體可以產生 SAML 聲明。這種整合會提供有關使用者身分和許可 (例如 Active Directory Federation Services 或 Shibboleth) 的資訊。如需更多詳細資訊，請參閱 SAML 2.0 聯合身分。

呼叫 AssumeRoleWithSAML 操作。

這是未簽署的呼叫，表示您不需要在發出請求之前驗證 AWS 安全憑證。

注意
AssumeRoleWithSAML 呼叫未簽署 (加密)。因此，如果請求是透過信任的媒介傳輸，您應該只包含選用的工作階段政策。在這種情況下，有人可以更改政策以移除限制。
當您呼叫 AssumeRoleWithSAML 時，AWS 會驗證 SAML 聲明的真偽。假設身分提供者驗證聲明，AWS 傳回以下資訊給您：
- 一組暫時性安全憑證。這些包含存取金鑰 ID、私密存取金鑰和工作階段權杖。
- 所擔任角色的角色 ID 和 ARN。
- Audience 值，其包含 SAML 聲明的 Recipient 元素的 SubjectConfirmationData 屬性值。
- Issuer 值，其包含 SAML 聲明的 Issuer 元素的值。
- NameQualifier 元素，包含從 Issuer 值建構的雜湊值、AWS 帳戶 ID 和 SAML 提供者的易記名稱。當與 Subject 元素結合使用時，這些內容可以唯一識別 SAML 聯合身分主體。
- Subject 元素，其包含 SAML 聲明的 NameID 元素的 Subject 元素值。
- SubjectType 元素指出 Subject 元素的格式。此值可以是 persistent、transient 或在您的 SAML 聲明中使用的 Format 與 Subject 元素的完整 NameID URI。如需 NameID 元素的 Format 屬性的詳細資訊，請參閱為身分驗證回應設定 SAML 聲明。
使用回應中傳回的臨時安全憑證來進行 AWS API 呼叫。這個程序與使用長期安全憑證進行 AWS API 呼叫的程序相同。差別在於您必須包含工作階段權杖，這個權杖可讓 AWS 驗證臨時安全憑證是否有效。

您的應用程式應該快取憑證。預設情況下，憑證會在一小時後到期。如果您不是使用開發套件中的 AmazonSTSCredentialsProviderAWS 動作，則取決於您和您的應用程式是否再次呼叫 AssumeRoleWithSAML。呼叫此操作，或取得一組新的暫時性安全憑證，之後舊的憑證才會過期。

透過自訂身分經紀人請求憑證

GetFederationToken API 操作會傳回 AWS STS 聯合身分使用者主體的一組臨時安全憑證。此 API 與 AssumeRole 不同，其中的預設過期時段是實質上比較長 (12 小時，而不是 1 小時)。此外，您可以使用 DurationSeconds 參數來指定暫時性安全憑證的持續時間，以保持有效。產生的憑證在指定的持續時間內有效，介於 900 秒 (15 分鐘) 至 129,600 秒 (36 小時) 之間。較長的過期期間有助於減少對 AWS 的呼叫次數，因為您不需要經常取得新的憑證。

使用特定 IAM 使用者的 AWS 安全憑證進行驗證。必須使用有效的 AWS 安全憑證進行此呼叫。
呼叫 GetFederationToken 操作。

GetFederationToken 呼叫會傳回暫時性安全憑證，該憑證由工作階段字符、存取金鑰、私密金鑰和過期時間組成。如果您想要管理您組織內的許可 (例如，使用 Proxy 應用程式以指派許可)，您可以使用 GetFederationToken。

以下範例顯示使用 GetFederationToken 的範例請求及回應。此範例請求會將指定期間的呼叫發起使用者與工作階段政策 ARN 和工作階段標籤聯合在一起。產生的工作階段名為 Jane-session。

範例請求


https://sts.amazonaws.com/
?Version=2011-06-15
&Action=GetFederationToken
&Name=Jane-session
&PolicyArns.member.1.arn==arn%3Aaws%3Aiam%3A%3A123456789012%3Apolicy%2FRole1policy
&DurationSeconds=1800
&Tags.member.1.Key=Project
&Tags.member.1.Value=Pegasus
&Tags.member.2.Key=Cost-Center
&Tags.member.2.Value=12345
&AUTHPARAMS

上述範例中顯示的政策 ARN 包含以下 URL 編碼 ARN：

arn:aws:iam::123456789012:policy/Role1policy

此外，請注意範例中的 &AUTHPARAMS 參數表示身分驗證資訊的預留位置。這是「簽章」，必須隨附於 AWS HTTP API 請求。我們建議使用 AWS 開發套件來建立 API 請求。執行此作業的其中一個好處是開發套件會為您處理請求簽署。如果您必須手動建立和簽署 API 請求，請移至 Amazon Web Services 一般參考 的使用 Signature 第 4 版簽署 AWS 請求，以了解如何簽署請求。

除了暫時性安全憑證外，回應包含聯合身分使用者的 Amazon Resource Name (ARN) 和憑證過期時間。

範例回應範例


<GetFederationTokenResponse xmlns="https://sts.amazonaws.com/doc/2011-06-15/">
<GetFederationTokenResult>
<Credentials>
  <SessionToken>
   AQoDYXdzEPT//////////wEXAMPLEtc764bNrC9SAPBSM22wDOk4x4HIZ8j4FZTwdQW
   LWsKWHGBuFqwAeMicRXmxfpSPfIeoIYRqTflfKD8YUuwthAx7mSEI/qkPpKPi/kMcGd
   QrmGdeehM4IC1NtBmUpp2wUE8phUZampKsburEDy0KPkyQDYwT7WZ0wq5VSXDvp75YU
   9HFvlRd8Tx6q6fE8YQcHNVXAkiY9q6d+xo0rKwT38xVqr7ZD0u0iPPkUL64lIZbqBAz
   +scqKmlzm8FDrypNC9Yjc8fPOLn9FX9KSYvKTr4rvx3iSIlTJabIQwj2ICCEXAMPLE==
  </SessionToken>
  <SecretAccessKey>
  wJalrXUtnFEMI/K7MDENG/bPxRfiCYzEXAMPLEKEY
  </SecretAccessKey>
  <Expiration>2019-04-15T23:28:33.359Z</Expiration>
  <AccessKeyId>AKIAIOSFODNN7EXAMPLE;</AccessKeyId>
</Credentials>
<FederatedUser>
  <Arn>arn:aws:sts::123456789012:federated-user/Jean</Arn>
  <FederatedUserId>123456789012:Jean</FederatedUserId>
</FederatedUser>
<PackedPolicySize>4</PackedPolicySize>
</GetFederationTokenResult>
<ResponseMetadata>
<RequestId>c6104cbe-af31-11e0-8154-cbc7ccf896c7</RequestId>
</ResponseMetadata>
</GetFederationTokenResponse>

注意

AWS 建議，如果您想要在資源層級授予許可 (例如，將以資源為基礎的政策連接到 Amazon S3 儲存貯體)，您可以省略 Policy 參數。不過，如果您不包含 AWS STS 聯合身分使用者主體的政策，臨時安全憑證將不會授予任何許可。在這種情況下，您「必須」使用資源政策，來授予聯合身分使用者存取您 AWS 資源的許可。

例如，假設您的 AWS 帳戶號碼是 111122223333，而您擁有想要允許 Susan 存取的 Amazon S3 儲存貯體。Susan 的暫時性安全憑證不包含儲存貯體的政策。在這種情況下，您需要確保儲存貯體具有其 ARN 與 Susan 的 ARN 相符的政策，例如 arn:aws:sts::111122223333:federated-user/Susan。

為不信任環境中的使用者請求憑證

GetSessionToken API 操作會傳回現有 IAM 使用者的一組臨時安全憑證。這適用於提供增強的安全，例如，將 AWS 請求限制在 IAM 使用者啟用 MFA 時。因為憑證為暫時性，它們可在您有透過較不安全環境存取您資源的 IAM 使用者時，提供增強的安全性。較不安全環境的範例包含行動裝置或 Web 瀏覽器。

使用特定 IAM 使用者的 AWS 安全憑證進行驗證。必須使用有效的 AWS 安全憑證進行此呼叫。
呼叫 GetSessionToken 操作。
GetSessionToken 會傳回暫時性安全憑證，其由工作階段字符、存取金鑰 ID 和私密存取金鑰組成。

在預設情況下，IAM 使用者的暫時性安全憑證的有效期最長為 12 小時。但是，您可以使用 DurationSeconds 參數請求持續時間最短為 15 分鐘最長為 36 小時。基於安全考量，AWS 帳戶根使用者的字符的持續時間限制在一個小時。

以下範例顯示使用 GetSessionToken 的範例請求及回應。回應還包括暫時性安全憑證的過期時間。

範例請求


https://sts.amazonaws.com/
?Version=2011-06-15
&Action=GetSessionToken
&DurationSeconds=1800
&AUTHPARAMS

範例回應範例


<GetSessionTokenResponse xmlns="https://sts.amazonaws.com/doc/2011-06-15/">
<GetSessionTokenResult>
<Credentials>
  <SessionToken>
   AQoEXAMPLEH4aoAH0gNCAPyJxz4BlCFFxWNE1OPTgk5TthT+FvwqnKwRcOIfrRh3c/L
   To6UDdyJwOOvEVPvLXCrrrUtdnniCEXAMPLE/IvU1dYUg2RVAJBanLiHb4IgRmpRV3z
   rkuWJOgQs8IZZaIv2BXIa2R4OlgkBN9bkUDNCJiBeb/AXlzBBko7b15fjrBs2+cTQtp
   Z3CYWFXG8C5zqx37wnOE49mRl/+OtkIKGO7fAE
  </SessionToken>
  <SecretAccessKey>
  wJalrXUtnFEMI/K7MDENG/bPxRfiCYzEXAMPLEKEY
  </SecretAccessKey>
  <Expiration>2011-07-11T19:55:29.611Z</Expiration>
  <AccessKeyId>AKIAIOSFODNN7EXAMPLE</AccessKeyId>
</Credentials>
</GetSessionTokenResult>
<ResponseMetadata>
<RequestId>58c5dbae-abef-11e0-8cfe-09039844ac7d</RequestId>
</ResponseMetadata>
</GetSessionTokenResponse>

或者，GetSessionToken 請求可以包含 SerialNumber 多重要素驗證 (MFA) 驗證的 TokenCode 與 AWS 值。如果提供的值有效，AWS STS 會提供暫時性安全憑證，其包括 MFA 身分驗證的狀態。然後，暫時性安全憑證可用來存取受 MFA 保護的 API 操作或 AWS 網站，只要 MFA 身分驗證有效。

以下範例顯示 GetSessionToken 請求，其中包含 MFA 驗證碼和裝置序號。


https://sts.amazonaws.com/
?Version=2011-06-15
&Action=GetSessionToken
&DurationSeconds=7200
&SerialNumber=YourMFADeviceSerialNumber
&TokenCode=123456
&AUTHPARAMS

注意

呼叫 AWS STS 的施作對象，可以是全域端點或任何您啟用 AWS 帳戶的區域端點。如需詳細資訊，請參閱區域與端點的 AWS STS 一節。

您的瀏覽器已停用或無法使用 Javascript。

您必須啟用 Javascript，才能使用 AWS 文件。請參閱您的瀏覽器說明頁以取得說明。

文件慣用形式

服務持有人權杖

將臨時憑證與 AWS 資源搭配使用

請求臨時安全憑證

注意

使用 AWS STS 和 AWS 區域

透過自訂身分經紀人請求跨帳戶委派和聯合身分的憑證

透過自訂身分經紀人請求跨帳戶委派和聯合身分的臨時安全憑證

範例請求

範例 回應範例

注意

透過 OIDC 提供者請求憑證

注意

透過 OIDC 提供者請求憑證

透過 SAML 2.0 身分提供者請求憑證

注意

透過自訂身分經紀人請求憑證

範例請求

範例 回應範例

注意

為不信任環境中的使用者請求憑證

範例請求

範例 回應範例

注意

範例回應範例

範例回應範例

範例回應範例