通过 Amazon SDK for .NET 进行单点登录

总体而言，开发工具包与 IAM Identity Center 交互的方式与以下模式类似：

本节介绍如何创建 .NET 应用程序，在必要时生成临时 SSO 令牌，然后使用该令牌。有关此过程的完整教程，请参阅仅使用 .NET 应用程序的 SSO 教程。

以编程方式生成和使用 SSO 令牌

除了使用 Amazon CLI，您还可以通过编程方式生成 SSO 令牌。

为此，您的应用程序会为 SSO 配置文件创建一个 AWSCredentials 对象，该对象会加载临时凭证（如果有）。然后，您的应用程序必须将 AWSCredentials 对象转换为 SSOAWSCredentials 对象并设置一些 Options 属性，包括用于在必要时提示用户输入登录信息的回调方法。

下面的代码片段中显示了此方法。

static AWSCredentials LoadSsoCredentials()
{
    var chain = new CredentialProfileStoreChain();
    if (!chain.TryGetAWSCredentials("my-sso-profile", out var credentials))
        throw new Exception("Failed to find the my-sso-profile profile");

    var ssoCredentials = credentials as SSOAWSCredentials;

    ssoCredentials.Options.ClientName = "Example-SSO-App";
    ssoCredentials.Options.SsoVerificationCallback = args =>
    {
        // Launch a browser window that prompts the SSO user to complete an SSO sign-in.
        // This method is only invoked if the session doesn't already have a valid SSO token.
        // NOTE: Process.Start might not support launching a browser on macOS or Linux. If not,
        //       use an appropriate mechanism on those systems instead.
        Process.Start(new ProcessStartInfo
        {
            FileName = args.VerificationUriComplete,
            UseShellExecute = true
        });
    };

    return ssoCredentials;
}

如果没有相应的 SSO 令牌可用，则会启动默认浏览器窗口并打开相应的登录页面。例如，如果您使用 IAM Identity Center 作为身份来源，则用户会看到类似如下的登录页面：

仅使用 .NET 应用程序的 SSO 教程

本节介绍如何使用 Amazon CLI 生成临时 SSO 令牌，以及如何在应用程序中使用该令牌。有关此过程的完整教程，请参阅使用 Amazon CLI 和 .NET 应用程序的 SSO 教程。

使用 Amazon CLI 生成 SSO 令牌

除了以编程方式生成临时 SSO 令牌外，您还可以使用 Amazon CLI 生成令牌。以下信息将为您演示如何操作。

用户创建启用 SSO 的配置文件后（如上一节所示），他们将从 Amazon CLI 中运行 aws sso login 命令。他们必须确保包含带有启用 SSO 的配置文件名称的 --profile 参数。如下例所示:

aws sso login --profile my-sso-profile

如果用户想在当前临时令牌到期后生成新的临时令牌，他们可以再次运行相同的命令。

在 .NET 应用程序中使用生成的 SSO 令牌

以下信息向您展示了如何使用已经生成的临时令牌。

您的应用程序为 SSO 配置文件创建一个 AWSCredentials 对象，该对象会加载之前由 Amazon CLI 生成的临时凭证。这与访问应用程序中的凭证和配置文件中所示的方法类似，其形式如下：

static AWSCredentials LoadSsoCredentials()
{
    var chain = new CredentialProfileStoreChain();
    if (!chain.TryGetAWSCredentials("my-sso-profile", out var credentials))
        throw new Exception("Failed to find the my-sso-profile profile");

    return credentials;
}

然后将 AWSCredentials 对象传递给服务客户端的构造函数。例如：

var S3Client_SSO = new AmazonS3Client(LoadSsoCredentials());

使用 Amazon CLI 和 .NET 应用程序的 SSO 教程