Bibliotecas do Azure Active Directory para .NET

  • Artigo

Visão geral

Conecte usuários e acesse APIs Web protegidas com o Azure Active Directory (Azure AD).

Para começar a desenvolver aplicativos com o Azure Active Directory, confira o plataforma de identidade da Microsoft.

Biblioteca do cliente

Forneça acesso com escopo às APIs Web protegidas por Azure AD usando o OpenID Connect e o OAuth 2.0 com a Biblioteca de Autenticação da Microsoft para .NET (MSAL.NET).

Instale o pacote NuGet diretamente do console do Gerenciador de Pacotes do Visual Studio ou com a CLI do .NET Core.

Gerenciador de Pacotes do Visual Studio

Install-Package Microsoft.Identity.Client

CLI do .NET Core

dotnet add package Microsoft.Identity.Client

Exemplo de código

Recupere um token de acesso para o Microsoft API do Graph em um aplicativo da área de trabalho (cliente público).

/* Include this using directive:
using Microsoft.Identity.Client;
*/

string ClientId = "11111111-1111-1111-1111-111111111111"; // Application (client) ID
string Tenant = "common";
string Instance = "https://login.microsoftonline.com/";

string graphAPIEndpoint = "https://graph.microsoft.com/v1.0/me";
string[] scopes = new string[] { "user.read" };

AuthenticationResult authResult = null;

var app = PublicClientApplicationBuilder.Create(ClientId)
                .WithAuthority($"{Instance}{Tenant}")
                .WithRedirectUri("http://localhost")
                .Build();

var accounts = await app.GetAccountsAsync();
var firstAccount = accounts.FirstOrDefault();

try
{
    // Always first try to acquire a token silently.
    authResult = await app.AcquireTokenSilent(scopes, firstAccount)
        .ExecuteAsync();
}
catch (MsalUiRequiredException ex)
{
    // If an MsalUiRequiredException occurred when AcquireTokenSilent was called,
    // it indicates you need to call AcquireTokenInteractive to acquire a token.
    System.Diagnostics.Debug.WriteLine($"MsalUiRequiredException: {ex.Message}");

    try
    {
        authResult = await app.AcquireTokenInteractive(scopes)
            .WithAccount(firstAccount)
            .WithPrompt(Prompt.SelectAccount)
            .ExecuteAsync();
    }
    catch (MsalException msalex)
    {
        System.Diagnostics.Debug.WriteLine($"Error acquiring Token:{System.Environment.NewLine}{msalex}");
    }
}
catch (Exception ex)
{
    System.Diagnostics.Debug.WriteLine($"Error acquiring token silently:{System.Environment.NewLine}{ex}");
    return;
}

if (authResult != null)
{
    System.Diagnostics.Debug.WriteLine($"Access token:{System.Environment.NewLine}{authResult.AccessToken}");
}

Explorar as APIs do cliente

Exemplos

Explore a coleção completa de plataforma de identidade da Microsoft exemplos de código.