使用 的單一登入 適用於 .NET 的 AWS SDK

在高階，SDKs與 IAM Identity Center 的互動方式類似下列模式：

本節說明如何建立 .NET 應用程式，在必要時產生臨時 SSO 字符，然後使用該字符。如需此程序的完整教學課程，請參閱 僅使用 .NET 應用程式的 SSO 教學課程。

以程式設計方式產生和使用 SSO 字符

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

若要這樣做，您的應用程式會為 SSO 設定檔建立 AWSCredentials 物件，如果有任何可用，則會載入臨時登入資料。然後，您的應用程式必須將AWSCredentials物件轉換為SSOAWSCredentials物件，並設定一些選項屬性，包括在必要時用來提示使用者登入資訊的回呼方法。

此方法會顯示在下列程式碼片段中。

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
        });
    };
    ssoCredentials.Options.SupportsGettingNewToken = true;

    return ssoCredentials;
}

如果沒有適當的 SSO 字符，則會啟動預設瀏覽器視窗，並開啟適當的登入頁面。例如，如果您使用 IAM Identity Center 做為身分來源，使用者會看到類似以下的登入頁面：

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

本節說明如何使用 產生臨時 SSO 字符 AWS CLI，以及如何在應用程式中使用該字符。如需此程序的完整教學課程，請參閱 使用 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 教學課程