使用配置 SDK 身份验证 Amazon - 适用于 .NET 的 Amazon SDK （版本 3）
启用和配置 IAM Identity Center将开发工具包配置为使用 IAM Identity Center。启动 Amazon 访问门户会话其他信息
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

的版本 4 (V4) 适用于 .NET 的 Amazon SDK 正在预览中！要在预览版中查看有关此新版本的信息，请参阅 适用于 .NET 的 Amazon SDK （版本 4 预览版）开发者指南。

请注意，SDK 的 V4 处于预览版，因此其内容可能会发生变化。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

使用配置 SDK 身份验证 Amazon

使用开发 Amazon 时，您必须确定您的代码是如何进行身份验证的。 Amazon Web Services 服务您可以通过不同的方式配置对 Amazon 资源的编程访问权限，具体取决于环境和可用的 Amazon 访问权限。

要查看 SDK 的各种身份验证方法，请参阅和工具参考指南中的身份验证Amazon SDKs 和访问。

本主题假设新用户正在本地开发，雇主未向其提供身份验证方法，并将使用该用户 Amazon IAM Identity Center 来获取临时证书。如果您的环境与这些假设不符，则本主题中的某些信息可能不适用于您，或者某些信息可能已经提供给您。

配置此环境需要几个步骤，总结如下：

  1. 启用和配置 IAM Identity Center

  2. 将开发工具包配置为使用 IAM Identity Center。

  3. 启动 Amazon 访问门户会话

启用和配置 IAM Identity Center

要使用 IAM Identity Center，必须先启用并进行配置。要详细了解如何为 SDK 执行此操作，请查看Amazon SDKs 和工具参考指南中 IAM Identity Center 身份验证主题中的步骤 1。具体而言，请按照我没有通过 IAM Identity Center 确立访问权限下的所有必要说明进行操作。

将开发工具包配置为使用 IAM Identity Center。

有关如何配置软件开发工具包以使用 IAM Identity Center 的信息，请参阅《工具参考指南》中 IAM 身份中心身份验证主题的步骤 2。Amazon SDKs 完成此配置后，您的系统应包含以下元素：

  • Amazon CLI，用于在运行应用程序之前启动 Amazon 访问门户会话。

  • 共享 Amazon config文件，其中包含一个[default]配置文件，其中包含一组可从 SDK 中引用的配置值。要查找此文件的位置，请参阅Amazon SDKs 和工具参考指南中的共享文件的位置。在向发送请求之前， 适用于 .NET 的 Amazon SDK 使用配置文件的 SSO 令牌提供者获取凭证。 Amazon Web Servicessso_role_name 值是与 IAM Identity Center 权限集关联的 IAM 角色，应允许访问您的应用程序中使用的 Amazon Web Services 服务 。

    以下示例 config 文件显示了使用 SSO 令牌提供程序设置的默认配置文件。配置文件的 sso_session 设置是指所指定的 sso-session 节。该sso-session部分包含启动 Amazon 访问门户会话的设置。

    [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
重要

如果您使用 Amazon IAM Identity Center 进行身份验证，则您的应用程序必须引用以下 NuGet软件包，这样 SSO 解析才能起作用：

  • AWSSDK.SSO

  • AWSSDK.SSOOIDC

未能引用这些程序包将导致运行时系统异常。

启动 Amazon 访问门户会话

在运行可访问的应用程序之前 Amazon Web Services 服务，您需要为开发工具包进行有效的 Amazon 访问门户会话，才能使用 IAM Identity Center 身份验证来解析证书。根据配置的会话时长，访问权限最终将过期，并且开发工具包将遇到身份验证错误。要登录 Amazon 访问门户，请在中运行以下命令 Amazon CLI。

aws sso login

由于您有默认的配置文件设置，因此无需使用 --profile 选项调用该命令。如果您的 SSO 令牌提供程序配置在使用指定的配置文件，则命令为 aws sso login --profile named-profile。

要测试是否已有活动会话，请运行以下 Amazon CLI 命令。

aws sts get-caller-identity

对此命令的响应应该报告共享 config 文件中配置的 IAM Identity Center 账户和权限集。

注意

如果您已经有一个有效的 Amazon 访问门户会话并且aws sso login正在运行，则无需提供凭据。

登录过程可能会提示您允许 Amazon CLI 访问您的数据。由于 Amazon CLI 是在适用于 Python 的 SDK 之上构建的，因此权限消息可能包含botocore名称的变体。

其他信息

  • 有关在开发环境中使用 IAM Identity Center 和 SSO 的更多信息，请参阅高级身份验证部分中的单点登录。此信息包括替代方法和更高级的方法，以及向您展示如何使用这些方法的教程。

  • 有关 SDK 身份验证的更多选项，例如配置文件和环境变量的使用，请参阅Amazon SDKs 和工具参考指南中的配置章节。

  • 有关最佳实践的更多信息，请参阅《IAM 用户指南》中的 IAM 中的安全最佳实践。

  • 要创建短期 Amazon 证书，请参阅 IAM 用户指南中的临时安全证书。

  • 要了解其他凭证提供商，请参阅《工具参考指南》Amazon SDKs 中的标准化凭证提供商。