Single sign-on dengan AWS SDK for .NET

Pada tingkat tinggi, SDK berinteraksi dengan IAM Identity Center dengan cara yang mirip dengan pola berikut:

Bagian ini menunjukkan cara membuat aplikasi.NET yang menghasilkan token SSO sementara, jika perlu, dan kemudian menggunakan token itu. Untuk tutorial lengkap tentang proses ini, lihatTutorial untuk SSO hanya menggunakan aplikasi.NET.

Hasilkan dan gunakan token SSO secara terprogram

Selain menggunakanAWS CLI, Anda juga dapat menghasilkan token SSO secara terprogram.

Untuk melakukan ini, aplikasi Anda membuat AWSCredentialsobjek untuk profil SSO, yang memuat kredensi sementara jika ada yang tersedia. Kemudian, aplikasi Anda harus mentransmisikan AWSCredentials objek ke SSOAWSCredentialsobjek dan menyetel beberapa properti Options, termasuk metode callback yang digunakan untuk meminta pengguna informasi login, jika perlu.

Metode ini ditunjukkan dalam cuplikan kode berikut.

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

Jika token SSO yang sesuai tidak tersedia, jendela browser default diluncurkan dan halaman login yang sesuai dibuka. Misalnya, jika Anda menggunakan Pusat Identitas IAM sebagai sumber Identitas, pengguna akan melihat halaman login yang mirip dengan berikut ini:

Tutorial untuk SSO hanya menggunakan aplikasi.NET

Bagian ini menunjukkan kepada Anda cara membuat token SSO sementara dengan menggunakanAWS CLI, dan cara menggunakan token itu dalam aplikasi. Untuk tutorial lengkap tentang proses ini, lihatTutorial untuk SSO menggunakan aplikasi AWS CLI dan .NET.

Hasilkan token SSO dengan menggunakan AWS CLI

Selain menghasilkan token SSO sementara secara terprogram, Anda menggunakan token AWS CLI untuk menghasilkan token. Informasi berikut menunjukkan caranya.

Setelah pengguna membuat profil berkemampuan SSO seperti yang ditunjukkan di bagian sebelumnya, mereka menjalankan aws sso login perintah dari file. AWS CLI Mereka harus yakin untuk menyertakan --profile parameter dengan nama profil berkemampuan SSO. Ini ditunjukkan dalam contoh berikut:

aws sso login --profile my-sso-profile

Jika pengguna ingin membuat token sementara baru setelah token saat ini kedaluwarsa, mereka dapat menjalankan perintah yang sama lagi.

Gunakan token SSO yang dihasilkan dalam aplikasi.NET

Informasi berikut menunjukkan kepada Anda cara menggunakan token sementara yang telah dibuat.

Aplikasi Anda membuat AWSCredentialsobjek untuk profil SSO, yang memuat kredenal sementara yang dihasilkan sebelumnya oleh file. AWS CLI Ini mirip dengan metode yang ditunjukkan dalam Mengakses kredensi dan profil dalam aplikasi dan memiliki bentuk berikut:

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

AWSCredentialsObjek kemudian diteruskan ke konstruktor untuk klien layanan. Sebagai contoh:

var S3Client_SSO = new AmazonS3Client(LoadSsoCredentials());

Tutorial untuk SSO menggunakan aplikasi AWS CLI dan .NET