Amazon IAM Identity Center 的旧版不可刷新配置 - Amazon Command Line Interface
先决条件遗留配置的自动配置遗留配置的手动配置
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

Amazon IAM Identity Center 的旧版不可刷新配置

本主题介绍如何将 Amazon CLI 配置为使用 Amazon IAM Identity Center（IAM Identity Center）对用户进行身份验证，以获取使用旧版方法运行 Amazon CLI 命令的凭证。使用遗留的不可刷新配置时，您需要手动刷新令牌，因为它会定期过期。

使用 IAM Identity Center 时，您可以登录到 Active Directory、内置 IAM Identity Center 目录或已连接到 IAM Identity Center 的另一个 IdP。您可以将这些凭证映射到一个您可用来运行 Amazon CLI 命令的 Amazon Identity and Access Management（IAM）角色。

无论您使用哪个 IdP，IAM Identity Center 都会将这些区别抽象出来。例如，您可以连接 Microsoft Azure AD，如博客文章 IAM Identity Center 的下一个演进中所述。

注意

有关使用持有者身份验证（不使用账户 ID 和角色）的信息，请参阅《Amazon CodeCatalyst 用户指南》中的进行设置以将 Amazon CLI 与 CodeCatalyst 一起使用。

您可以按以下方式配置一个或多个 Amazon CLI 命名配置文件以使用来自遗留 IAM Identity Center 的角色。

  • 自动，使用 aws configure sso 命令。

  • 手动，通过编辑存储命名配置文件的 config 文件。

先决条件

  • 安装 Amazon CLI。有关更多信息，请参阅安装或更新到最新版本的 Amazon CLI。

  • 您必须先有权访问 IAM Identity Center 中的 SSO 身份验证。选择下列方法之一来访问您的 Amazon 凭证。

请按照《Amazon IAM Identity Center 用户指南》的入门中的说明操作。此过程激活 IAM Identity Center，创建管理用户并添加适当的最低权限集。

注意

对于步骤 6 – 创建应用最低权限的权限集。除非您的雇主已为此目的创建自定义权限集，否则建议使用预定义的 PowerUserAccess 权限集。

退出门户并重新登录以查看 Administrator 或 PowerUserAccess 的 Amazon Web Services 账户和选项。在使用开发工具包时选择 PowerUserAccess。这也可以帮助您找到有关编程访问的详细信息。

通过身份提供商的门户登录 Amazon。如果您的云管理员已向您授予 PowerUserAccess（开发人员）权限，您将看到您有权访问的 Amazon Web Services 账户和您的权限集。在您的权限集名称旁边，可以看到有关使用该权限集手动或以编程方式访问账户的选项。

自定义实现可能会产生不同的体验，例如不同的权限集名称。如果您不确定要使用哪个权限集，请联系 IT 团队以寻求帮助。

通过 Amazon 访问门户登录到 Amazon。如果您的云管理员已向您授予 PowerUserAccess（开发人员）权限，您将看到您有权访问的 Amazon Web Services 账户和您的权限集。在您的权限集名称旁边，可以看到有关使用该权限集手动或以编程方式访问账户的选项。

请联系您的 IT 团队以寻求帮助。

遗留配置的自动配置

在 Amazon CLI 中配置 IAM Identity Center 配置文件

  1. 运行 aws configure sso 命令并提供 IAM Identity Center 启动 URL 和托管 Identity Center 目录的 Amazon 区域。

    $ aws configure sso
SSO session name (Recommended):
SSO start URL [None]: https://my-sso-portal.awsapps.com/start
SSO region [None]:us-east-1

  2. Amazon CLI 尝试打开默认浏览器，并开始您的 IAM Identity Center 账户的登录过程。

    SSO authorization page has automatically been opened in your default browser.
Follow the instructions in the browser to complete this authorization request.

    如果 Amazon CLI 无法打开浏览器，则会显示以下消息，其中包含有关如何手动开始登录过程的说明。

    Using a browser, open the following URL:
 
https://device.sso.us-west-2.amazonaws.com/

and enter the following code:
QCFK-N451

    IAM Identity Center 使用代码将 IAM Identity Center 会话与当前 Amazon CLI 会话关联。IAM Identity Center 浏览器页面会提示您使用 IAM Identity Center 凭证登录。这样可向 Amazon CLI 授予权限以检索和显示您有权与 IAM Identity Center 一起使用的 Amazon 账户和角色。

  3. 接下来，Amazon CLI 会显示可供您使用的 Amazon 账户。如果您只被授权使用一个账户，Amazon CLI 会自动为您选择该账户并跳过提示。可供您使用的 Amazon 账户由 IAM Identity Center 中的用户配置决定。

    There are 2 Amazon accounts available to you.
> DeveloperAccount, developer-account-admin@example.com (123456789011) 
  ProductionAccount, production-account-admin@example.com (123456789022)

    使用箭头键选择要用于此配置文件的账户。左侧的“>”字符指向当前选择。按 Enter 进行选择。

  4. 接下来，Amazon CLI 确认您选择的账户，并显示所选账户中可供您使用的 IAM 角色。如果所选账户仅列出一个角色，Amazon CLI 会自动为您选择该角色并跳过提示。可供您使用的角色由 IAM Identity Center 中的用户配置决定。

    Using the account ID 123456789011
There are 2 roles available to you.
> ReadOnly
  FullAccess

    使用箭头键选择要与这个配置文件一起使用的 IAM 角色，然后按 <ENTER> 键。

  5. Amazon CLI 将确认您的角色选择。

    Using the role name "ReadOnly"

  6. 完成配置文件的配置，方法是指定默认输出格式、要向其发送命令的默认 Amazon Web Services 区域，并提供配置文件名称，以便您可以从本地计算机上定义的所有配置文件中引用此配置文件。在以下示例中，用户输入原定设置区域、原定设置输出格式和配置文件的名称。也可以按下 <ENTER> 以选择方括号之间显示的任何原定设置值。建议的配置文件名称是账户 ID 号，并依次后跟下划线和角色名称。

    CLI default client Region [None]: us-west-2<ENTER>
CLI default output format [None]: json<ENTER>
CLI profile name [123456789011_ReadOnly]: my-dev-profile<ENTER>
    注意

    如果您指定 default 作为配置文件名称，则每当您运行 Amazon CLI 命令但不指定配置文件名称时，此配置文件将变为使用的配置文件。

  7. 最后一条消息描述了完成的配置文件配置。

    要使用此配置文件，请使用 --profile 指定配置文件名称，如下所示：

    aws s3 ls --profile my-dev-profile

  8. 前面的示例条目将在 ~/.aws/config 中生成一个命名的配置文件，类似于以下示例。

    [profile my-dev-profile]
sso_start_url = https://my-sso-portal.awsapps.com/start
sso_region = us-east-1
sso_account_id = 123456789011
sso_role_name = readOnly
region = us-west-2
output = json

    此时，您有一个可用于请求临时凭证的配置文件。您必须使用 aws sso login 命令实际请求和检索运行命令所需的临时凭证。有关说明，请参阅使用 IAM Identity Center 命名配置文件 。

遗留配置的手动配置

使用遗留的不可刷新配置不支持自动令牌刷新。我们建议使用 SSO 令牌配置。

要手动向命名的配置文件添加 IAM Identity Center 支持，必须将以下密钥和值添加到文件 ~/.aws/config（Linux 或 macOS）或 %USERPROFILE%/.aws/config (Windows) 中的配置文件定义中。

您可以在 .aws/config 文件中包括有效的任何其他键和值，例如 region、output 或 s3。为防止出错，不要包括任何与凭证相关的值，例如 role_arn 或 aws_secret_access_key。

以下是 .aws/config 中的示例 IAM Identity Center 配置文件：

[profile my-sso-profile]
sso_start_url = https://my-sso-portal.awsapps.com/start
sso_region = us-west-2
sso_account_id = 111122223333
sso_role_name = SSOReadOnlyRole
region = us-west-2
output = json

您的临时凭证配置文件已完成。

要运行命令，您必须首先使用 aws sso login 命令请求和检索临时凭证。有关说明，请参阅下一节：使用 IAM Identity Center 命名配置文件 。身份验证令牌缓存到磁盘中的 ~/.aws/sso/cache 目录下面，文件名基于 sso_start_url。