單一登入 AWS SDK for .NET

在高層級上，SDK 會以類似下列模式的方式與 IAM 身分中心互動：

本節說明如何建立 .NET 應用程式，視需要產生暫時 SSO 憑證，然後使用該權杖。如需此程序的完整自學課程，請參閱〈〉僅使用 .NET 應用程式的 SSO 教學課程。

以程式設計方式產生並使用 SSO 權杖

除了使用之外AWS CLI，您也可以透過程式設計方式產生 SSO 憑證。

若要這麼做，您的應用程式會為 SSO 設定檔建立AWSCredentials物件，如果有的話，會載入暫時認證。然後，您的應用程式必須將AWSCredentials物件轉換為SSOAWSCredentials物件，並設定一些 O ptions 屬性，包括在必要時用來提示使用者輸入登入資訊的回呼方法。

這種方法顯示在下面的代碼片段。

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 身分中心做為身分識別來源，使用者會看到類似下列內容的登入頁面：

僅使用 .NET 應用程式的 SSO 教學課程

本節說明如何使用AWS CLI，以及如何在應用程式中使用該權杖來產生暫存 SSO 憑證。如需此程序的完整自學課程，請參閱〈〉使用AWS CLI和 .NET 應用程式的 SSO 教學課程。

使用以產生 SSO 權杖 AWS CLI

除了以程式設計方式產生暫存 SSO 權杖之外，您還可以使用AWS CLI來產生權杖。以下信息向您展示了如何操作。

使用者建立啟用 SSO 的設定檔 (如上一節所示) 之後，他們會從執行aws sso login命令。AWS CLI他們必須確定包含具有 SSO 功能之設定檔名稱的--profile參數。下列範例顯示這種情況：

aws sso login --profile my-sso-profile

如果用戶想要在當前的臨時令牌過期後生成新的臨時令牌，他們可以再次運行相同的命令。

在 .NET 應用程式中使用產生的 SSO 權杖

下列資訊說明如何使用已產生的暫存權杖。

您的應用程式會為 SSO 設定檔建立AWSCredentials物件，該物件會載入先前由AWS 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());

使用AWS CLI和 .NET 應用程式的 SSO 教學課程