使用 的單一登入 AWS SDK for .NET

在高階，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
        });
    };

    return ssoCredentials;
}

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

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

僅限 .NET 應用程式

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

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

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

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

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

重要

您的應用程式必須參考下列 NuGet 套件，以便 SSO 解析能夠運作：

• AWSSDK.SSO

• AWSSDK.SSOOIDC

未參考這些套件將導致執行時間例外狀況。

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 做為身分來源，使用者會看到類似如下的登入頁面：

注意

您提供的文字字串SSOAWSCredentials.Options.ClientName不能有空格。如果字串有空格，您會收到執行時間例外狀況。

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

本節說明如何使用 產生臨時 SSO 字符 AWS CLI，以及如何在應用程式中使用該字符。如需此程序的完整教學課程，請參閱 使用 AWS CLI 和 .NET 應用程式的 SSO 教學課程。

使用 產生 SSO 權杖 AWS CLI

除了以程式設計方式產生臨時 SSO 字符之外，您還可以使用 AWS CLI 來產生字符。下列資訊說明如何操作。

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

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 教學課程

aws sso login --profile my-sso-profile

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;
}

var S3Client_SSO = new AmazonS3Client(LoadSsoCredentials());