Adquira tokens para chamar uma API da Web usando um aplicativo daemon

Aqui está um exemplo de definição dos escopos para a API da Web como parte da configuração em um arquivo de appsettings.json. Este exemplo é retirado do exemplo de código de daemon de consola .NET no GitHub.

{
    "AzureAd": {
        // Same AzureAd section as before.
    },

    "MyWebApi": {
        "BaseUrl": "https://localhost:44372/",
        "RelativePath": "api/TodoList",
        "RequestAppToken": true,
        "Scopes": [ "[Enter here the scopes for your web API]" ]
    }
}

Em Java, defina o âmbito padrão do Microsoft Graph como uma constante:

final static String GRAPH_DEFAULT_SCOPE = "https://graph.microsoft.com/.default";

Em Node.js, especifique o âmbito no objeto de pedido de token:

const tokenRequest = {
    scopes: [process.env.GRAPH_ENDPOINT + '.default'], // e.g. 'https://graph.microsoft.com/.default'
};

No MSAL Python, o arquivo de configuração se parece com este trecho de código:

{
    "scope": ["https://graph.microsoft.com/.default"],
}

Em código .NET de baixo nível, constrói o âmbito acrescentando /.default ao ID do recurso:

ResourceId = "someAppIDURI";
var scopes = new [] {  ResourceId+"/.default"};

Com a Microsoft. Identity.Web, não precisas de adquirir um token diretamente. Você pode usar APIs de nível superior, como se vê em Chamando uma API da Web a partir de uma aplicação daemon. Se, no entanto, estiver a usar um SDK que requer um token, pode obter um token de aplicação através da ITokenAcquirer abstração, como mostrado no exemplo seguinte:

using Microsoft.Extensions.DependencyInjection;
using Microsoft.Identity.Abstractions;
using Microsoft.Identity.Web;

// In the Program.cs, acquire a token for your downstream API

var tokenAcquirerFactory = TokenAcquirerFactory.GetDefaultInstance();
ITokenAcquirer acquirer = tokenAcquirerFactory.GetTokenAcquirer();
AcquireTokenResult tokenResult = await acquirer.GetTokenForUserAsync(new[] { "https://graph.microsoft.com/.default" });
string accessToken = tokenResult.AccessToken;

O seguinte exemplo de aquisição de tokens Java é extraído dos exemplos de desenvolvimento MSAL Java.

private static IAuthenticationResult acquireToken() throws Exception {

     // Load token cache from file and initialize token cache aspect. The token cache will have
     // dummy data, so the acquireTokenSilently call will fail.
     TokenCacheAspect tokenCacheAspect = new TokenCacheAspect("sample_cache.json");

     IClientCredential credential = ClientCredentialFactory.createFromSecret(CLIENT_SECRET);
     ConfidentialClientApplication cca =
             ConfidentialClientApplication
                     .builder(CLIENT_ID, credential)
                     .authority(AUTHORITY)
                     .setTokenCacheAccessAspect(tokenCacheAspect)
                     .build();

     IAuthenticationResult result;
     try {
         SilentParameters silentParameters =
                 SilentParameters
                         .builder(SCOPE)
                         .build();

         // try to acquire token silently. This call will fail since the token cache does not
         // have a token for the application you are requesting an access token for
         result = cca.acquireTokenSilently(silentParameters).join();
     } catch (Exception ex) {
         if (ex.getCause() instanceof MsalException) {

             ClientCredentialParameters parameters =
                     ClientCredentialParameters
                             .builder(SCOPE)
                             .build();

             // Try to acquire a token. If successful, you should see
             // the token information printed out to console
             result = cca.acquireToken(parameters).join();
         } else {
             // Handle other exceptions accordingly
             throw ex;
         }
     }
     return result;
 }

O seguinte exemplo de código ilustra a aquisição de token num cliente confidencial MSAL Node.

try {
    const authResponse = await cca.acquireTokenByClientCredential(tokenRequest);
    console.log(authResponse.accessToken) // display access token
} catch (error) {
    console.log(error);
}

O exemplo seguinte mostra o padrão MSAL Python para adquirir um token de acesso exclusivo de aplicação com credenciais do cliente:

result = None

# First, the code looks up a token from the cache.
# Because we're looking for a token for the current app, not for a user,
# use None for the account parameter.
result = app.acquire_token_silent(config["scope"], account=None)

if not result:
    logging.info("No suitable token exists in cache. Let's get a new one from Azure AD.")
    result = app.acquire_token_for_client(scopes=config["scope"])

if "access_token" in result:
    # Call a protected API with the access token.
    print(result["token_type"])
else:
    print(result.get("error"))
    print(result.get("error_description"))
    print(result.get("correlation_id"))  # You might need this when reporting a bug.

using Microsoft.Identity.Client;

// With client credentials flows, the scope is always of the shape "resource/.default" because the
// application permissions need to be set statically (in the portal or by PowerShell), and then granted by
// a tenant administrator.
string[] scopes = new string[] { "https://graph.microsoft.com/.default" };

AuthenticationResult result = null;
try
{
 result = await app.AcquireTokenForClient(scopes)
                  .ExecuteAsync();
}
catch (MsalUiRequiredException ex)
{
    // The application doesn't have sufficient permissions.
    // - Did you declare enough app permissions during app creation?
    // - Did the tenant admin grant permissions to the application?
}
catch (MsalServiceException ex) when (ex.Message.Contains("AADSTS70011"))
{
    // Invalid scope. The scope has to be in the form "https://resourceurl/.default"
    // Mitigation: Change the scope to be as expected.
}

AcquireTokenForClient usa o cache de token de aplicativo

No MSAL.NET, AcquireTokenForClient usa o cache de token de aplicativo. (Todos os outros métodos AcquireTokenXX usam o cache de token de usuário.) Não chame AcquireTokenSilent antes de chamar AcquireTokenForClient, porque AcquireTokenSilent usa o cache de token de usuário. AcquireTokenForClient verifica o próprio cache de token do aplicativo e o atualiza.

Passe para o próximo artigo neste cenário, Chamando uma API da Web.

Passe para o próximo artigo neste cenário, Chamando uma API da Web.

Passe para o próximo artigo neste cenário, Chamando uma API da Web.

Passe para o próximo artigo neste cenário, Chamando uma API da Web.

Passe para o próximo artigo neste cenário, Chamando uma API da Web.