Authentification unique avec AWS SDK for .NET

À un niveau élevé, les SDK interagissent avec IAM Identity Center de la même manière que le modèle suivant :

Cette section explique comment créer une application .NET qui génère un jeton SSO temporaire, si nécessaire, puis utilise ce jeton. Pour un didacticiel complet de ce processus, voirTutoriel pour l'authentification unique utilisant uniquement des applications .NET.

Générer et utiliser un jeton SSO par programmation

En plus d'utiliser leAWS CLI, vous pouvez également générer un jeton SSO par programmation.

Pour ce faire, votre application crée un AWSCredentialsobjet pour le profil SSO, qui charge les informations d'identification temporaires si elles sont disponibles. Votre application doit ensuite convertir l'AWSCredentialsobjet en SSOAWSCredentialsobjet et définir certaines propriétés d'options, notamment une méthode de rappel utilisée pour demander à l'utilisateur de fournir des informations de connexion, si nécessaire.

Cette méthode est illustrée dans l'extrait de code suivant.

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

Si aucun jeton SSO approprié n'est disponible, la fenêtre du navigateur par défaut est ouverte et la page de connexion appropriée est ouverte. Par exemple, si vous utilisez IAM Identity Center comme source d'identité, l'utilisateur voit une page de connexion similaire à la suivante :

Tutoriel pour l'authentification unique utilisant uniquement des applications .NET

Cette section explique comment générer un jeton SSO temporaire à l'aide duAWS CLI, et comment utiliser ce jeton dans une application. Pour un didacticiel complet de ce processus, voirTutoriel d'authentification unique à l'aide des applications .NET AWS CLI et .NET.

Générez un jeton SSO à l'aide du AWS CLI

En plus de générer un jeton SSO temporaire par programmation, vous utilisez le AWS CLI pour générer le jeton. Les informations suivantes vous montrent comment procéder.

Une fois que l'utilisateur a créé un profil compatible SSO, comme indiqué dans la section précédente, il exécute la aws sso login commande à partir du. AWS CLI Ils doivent veiller à inclure le --profile paramètre dans le nom du profil compatible SSO. comme illustré dans l'exemple suivant :

aws sso login --profile my-sso-profile

Si l'utilisateur souhaite générer un nouveau jeton temporaire après l'expiration du jeton actuel, il peut exécuter à nouveau la même commande.

Utiliser le jeton SSO généré dans une application .NET

Les informations suivantes vous montrent comment utiliser un jeton temporaire qui a déjà été généré.

Votre application crée un AWSCredentialsobjet pour le profil SSO, qui charge les informations d'identification temporaires générées précédemment par leAWS CLI. Cette méthode est similaire aux méthodes présentées dans Accès aux informations d'identification et aux profils dans une application et se présente sous la forme suivante :

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'AWSCredentialsobjet est ensuite transmis au constructeur pour un client de service. Par exemple :

var S3Client_SSO = new AmazonS3Client(LoadSsoCredentials());

Tutoriel d'authentification unique à l'aide des applications .NET AWS CLI et .NET