View a markdown version of this page

基本設定 - 適用於 Kotlin 的 AWS SDK
概觀AWS 存取入口網站的登入功能設定單一登入使用 登入 AWS CLI安裝 Java 和建置工具使用暫時性憑證

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

基本設定

概觀

若要成功開發 AWS 服務 使用 存取的應用程式 適用於 Kotlin 的 AWS SDK，必須符合下列要求。

重要

此設定區段中的指示假設您或組織使用 IAM Identity Center。如果您的組織使用獨立於 IAM Identity Center 運作的外部身分提供者，請了解如何取得適用於 Kotlin 的 SDK 暫時登入資料。請依照這些指示，將臨時登入資料新增至 ~/.aws/credentials 檔案。

如果您的身分提供者自動將臨時登入資料新增至 ~/.aws/credentials 檔案，請確定設定檔名稱為 ，[default]如此您就不需要提供設定檔名稱給 SDK 或 AWS CLI。

AWS 存取入口網站的登入功能

AWS 存取入口網站是您手動登入 IAM Identity Center 的 Web 位置。URL 的格式為 d-xxxxxxxxxx.awsapps.com/start或 your_subdomain.awsapps.com/start。

如果您不熟悉 AWS 存取入口網站，請遵循《 AWS SDKs和工具參考指南》中的 IAM Identity Center 身分驗證主題中的帳戶存取指引。

設定 SDK 的單一登入存取

完成程式設計存取區段中的步驟 2 後，軟體開發套件才能使用 IAM Identity Center 身分驗證，您的系統應該包含下列元素。

  • 在執行應用程式之前 AWS CLI，您用來啟動AWS 存取入口網站工作階段的 。

  • 包含預設設定檔~/.aws/config的檔案。適用於 Kotlin 的 SDK 使用描述檔的 SSO 字符提供者組態，在傳送請求至 之前取得憑證 AWS。該 sso_role_name 值是連接到 IAM Identity Center 許可集合的 IAM 角色，應該允許存取應用程式中使用的 AWS 服務 。

    下列範例config檔案顯示使用 SSO 權杖提供者組態設定的預設設定檔。設定檔的 sso_session 設定是指已命名的 sso-session 區段。sso-session 區段包含啟動 AWS 存取入口網站工作階段的設定。

    [default]
sso_session = my-sso
sso_account_id = 111122223333
sso_role_name = SampleRole
region = us-east-1
output = json

[sso-session my-sso]
sso_region = us-east-1
sso_start_url = https://provided-domain.awsapps.com/start
sso_registration_scopes = sso:account:access

如需 SSO 權杖提供者組態中使用的設定詳細資訊，請參閱 AWS SDKs和工具參考指南中的 SSO 權杖提供者組態。

如果您的開發環境未如先前所示設定程式設計存取，請遵循 SDKs參考指南中的步驟 2。

使用 登入 AWS CLI

在執行存取的應用程式之前 AWS 服務，您需要作用中 AWS 的存取入口網站工作階段，開發套件才能使用 IAM Identity Center 身分驗證來解析登入資料。在 中執行下列命令 AWS CLI ，以登入 AWS 存取入口網站。

aws sso login

由於您有預設的設定檔設定，您不需要使用 --profile選項呼叫 命令。如果您的 SSO 權杖提供者組態使用具名設定檔，則命令為 aws sso login --profile named-profile。

若要測試您是否已有作用中的工作階段，請執行下列 AWS CLI 命令。

aws sts get-caller-identity

對此命令的回應，應報告共用 config 檔案中設定的 IAM Identity Center 帳戶和許可集合。

注意

如果您已經擁有作用中的 AWS 存取入口網站工作階段並執行 aws sso login，則不需要提供憑證。

不過，您會看到一個對話方塊，要求 botocore 存取您資訊的許可。 botocore是 的基礎 AWS CLI 。

選取允許以授權存取適用於 Kotlin 的 AWS CLI 和 SDK 的資訊。

安裝 Java 和建置工具

您的開發環境需要下列項目：

使用暫時性憑證

除了設定 SDK 的 IAM Identity Center 單一登入存取之外，您也可以使用暫時登入資料來設定開發環境。

為臨時登入資料設定本機登入資料檔案

  1. 建立共用登入資料檔案

  2. 在登入資料檔案中，貼上下列預留位置文字，直到您貼上運作中的臨時登入資料：

    [default]
aws_access_key_id=<value from AWS access portal>
aws_secret_access_key=<value from AWS access portal>
aws_session_token=<value from AWS access portal>

  3. 儲存檔案。檔案現在~/.aws/credentials應該存在於您的本機開發系統上。如果未指定特定具名設定檔，此檔案包含適用於 Kotlin 的 SDK 所使用的 【預設】 設定檔。

  4. 登入 AWS 存取入口網站

  5. 請遵循手動登入資料重新整理標題下的這些指示，從 AWS 存取入口網站複製 IAM 角色登入資料。

    1. 針對連結指示中的步驟 4，選擇 IAM 角色名稱，為您的開發需求授予存取權。此角色通常具有 PowerUserAccess 或 Developer 等名稱。

    2. 針對步驟 7，選取手動將設定檔新增至您的 AWS 登入資料檔案選項，然後複製內容。

  6. 將複製的登入資料貼到本機credentials檔案中，並移除產生的設定檔名稱。您的 檔案應該類似以下內容：

    [default]
aws_access_key_id=AKIAIOSFODNN7EXAMPLE
aws_secret_access_key=wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
aws_session_token=IQoJb3JpZ2luX2IQoJb3JpZ2luX2IQoJb3JpZ2luX2IQoJb3JpZ2luX2IQoJb3JpZVERYLONGSTRINGEXAMPLE

  7. 儲存credentials檔案

適用於 Kotlin 的 SDK 會在建立服務用戶端時存取這些臨時登入資料，並用於每個請求。在步驟 5a 中選擇的 IAM 角色設定會決定臨時憑證的有效時長。最長持續時間為 12 小時。

臨時憑證過期後，請重複步驟 4 至 7。