Single sign-on con AWS SDK for .NET

Ad alto livello, gli SDK interagiscono con IAM Identity Center in modo simile al seguente schema:

In questa sezione viene illustrato come creare un'applicazione.NET che generi un token SSO temporaneo, se necessario, e quindi utilizzi tale token. Per un tutorial completo di questo processo, vediTutorial per SSO che utilizza solo applicazioni.NET.

Genera e usa un token SSO a livello di codice

Oltre a utilizzare ilAWS CLI, puoi anche generare un token SSO a livello di codice.

A tale scopo, l'applicazione crea un AWSCredentialsoggetto per il profilo SSO, che carica le credenziali temporanee, se disponibili. L'applicazione deve quindi eseguire il cast dell'AWSCredentialsoggetto su un SSOAWSCredentialsoggetto e impostare alcune proprietà Options, incluso un metodo di callback utilizzato per richiedere all'utente le informazioni di accesso, se necessario.

Questo metodo è illustrato nel seguente frammento di codice.

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

Se non è disponibile un token SSO appropriato, viene avviata la finestra del browser predefinita e viene aperta la pagina di accesso appropriata. Ad esempio, se utilizzi IAM Identity Center come origine dell'identità, l'utente visualizza una pagina di accesso simile alla seguente:

Tutorial per SSO che utilizza solo applicazioni.NET

Questa sezione mostra come generare un token SSO temporaneo utilizzando e come utilizzare tale token in un'applicazione. AWS CLI Per un tutorial completo di questo processo, vediTutorial per l'utilizzo delle AWS CLI applicazioni SSO e.NET.

Genera un token SSO utilizzando il AWS CLI

Oltre a generare un token SSO temporaneo a livello di codice, si utilizza il AWS CLI per generare il token. Le seguenti informazioni mostrano come fare.

Dopo che l'utente ha creato un profilo abilitato per l'SSO, come illustrato nella sezione precedente, esegue il aws sso login comando da. AWS CLI Devono assicurarsi di includere il --profile parametro con il nome del profilo abilitato all'SSO. Questo viene mostrato nell'esempio seguente:

aws sso login --profile my-sso-profile

Se l'utente desidera generare un nuovo token temporaneo dopo la scadenza di quello corrente, può eseguire nuovamente lo stesso comando.

Usa il token SSO generato in un'applicazione.NET

Le seguenti informazioni mostrano come utilizzare un token temporaneo che è già stato generato.

L'applicazione crea un AWSCredentialsoggetto per il profilo SSO, che carica le credenziali temporanee generate in precedenza da. AWS CLI È simile ai metodi mostrati in Accesso a credenziali e profili in un'applicazione e ha la forma seguente:

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

L'AWSCredentialsoggetto viene quindi passato al costruttore per un client di servizio. Per esempio:

var S3Client_SSO = new AmazonS3Client(LoadSsoCredentials());

Tutorial per l'utilizzo delle AWS CLI applicazioni SSO e.NET