Login único com o AWS SDK para .NET

Em um alto nível, SDKs interaja com o IAM Identity Center de maneira semelhante ao seguinte padrão:

Esta seção mostra como criar um aplicativo .NET que gera um token SSO temporário, se necessário, e depois usa esse token. Para obter um tutorial completo desse processo, consulte Tutorial para SSO usando somente aplicativos .NET.

Gere e use um token SSO de forma programática

Além de usar o AWS CLI, você também pode gerar um token SSO programaticamente.

Para fazer isso, seu aplicativo cria um objeto AWSCredentials para o perfil SSO, que carrega credenciais temporárias, se houver alguma disponível. Em seguida, seu aplicativo deve converter o objeto AWSCredentials em um objeto SSOAWSCredentials e definir algumas propriedades de Opções, incluindo um método de retorno de chamada usado para solicitar ao usuário informações de login, se necessário.

Esse método é mostrado no seguinte trecho de código.

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 um token de SSO apropriado não estiver disponível, a janela padrão do navegador será aberta e a página de login apropriada será aberta. Por exemplo, se você estiver usando o Centro de identidade do IAM como fonte de identidade, o usuário verá uma página de login semelhante à seguinte:

Tutorial para SSO usando somente aplicativos .NET

Somente aplicativo .NET

Esta seção mostra como criar um aplicativo .NET que gera um token SSO temporário, se necessário, e depois usa esse token. Para obter um tutorial completo desse processo, consulte Tutorial para SSO usando somente aplicativos .NET.

Gere e use um token SSO de forma programática

Além de usar o AWS CLI, você também pode gerar um token SSO programaticamente.

Para fazer isso, seu aplicativo cria um objeto AWSCredentials para o perfil SSO, que carrega credenciais temporárias, se houver alguma disponível. Em seguida, seu aplicativo deve converter o objeto AWSCredentials em um objeto SSOAWSCredentials e definir algumas propriedades de Opções, incluindo um método de retorno de chamada usado para solicitar ao usuário informações de login, se necessário.

Esse método é mostrado no seguinte trecho de código.

Importante

Seu aplicativo deve fazer referência aos seguintes NuGet pacotes para que a resolução de SSO funcione:

• AWSSDK.SSO

• AWSSDK.SSOOIDC

A falha em referenciar esses pacotes resultará em uma exceção de tempo de execução.

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 um token de SSO apropriado não estiver disponível, a janela padrão do navegador será aberta e a página de login apropriada será aberta. Por exemplo, se você estiver usando o Centro de identidade do IAM como fonte de identidade, o usuário verá uma página de login semelhante à seguinte:

nota

A string que você fornece para SSOAWSCredentials.Options.ClientName não pode ter espaços. Se a string tiver espaços, você receberá uma exceção de runtime.

Tutorial para SSO usando somente aplicativos .NET

Esta seção mostra como gerar um token SSO temporário usando o AWS CLI e como usar esse token em um aplicativo. Para obter um tutorial completo desse processo, consulte Tutorial para SSO usando os aplicativos AWS CLI e.NET.

Gere um token de SSO usando o AWS CLI

Além de gerar um token de SSO temporário programaticamente, você usa o AWS CLI para gerar o token. O procedimento a seguir mostra como obter essas informações.

Depois que o usuário cria um perfil habilitado para SSO, conforme mostrado na seção anterior, ele executa o comando aws sso login a partir da AWS CLI. Ele deve ter certeza de incluir o parâmetro --profile com o nome do perfil habilitado para SSO. Isso é mostrado no exemplo a seguir:

aws sso login --profile my-sso-profile

Se o usuário quiser gerar um novo token temporário após a expiração do atual, ele poderá executar o mesmo comando novamente.

Use o token SSO gerado em um aplicativo .NET

As informações a seguir mostram como usar um token temporário que já foi gerado.

Seu aplicativo cria um objeto AWSCredentials para o perfil SSO, que carrega as credenciais temporárias geradas anteriormente pela AWS CLI. Isso é semelhante aos métodos mostrados em Acessar credenciais e perfis em um aplicativo e tem o seguinte formato:

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

O objeto AWSCredentials é então passado para o construtor de um cliente de serviço. Por exemplo:

var S3Client_SSO = new AmazonS3Client(LoadSsoCredentials());

Tutorial para SSO usando os aplicativos AWS CLI e.NET

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());