Como cache o token de autenticação

Este artigo demonstra como cache o token de autenticação de forma a melhorar o desempenho da sua aplicação.

Utilização de ASP.NET

Importe o pacote Microsoft.Identity.Client NuGet, que é usado para adquirir um token.

Crie uma propriedade de aplicação de cliente confidencial.

private IConfidentialClientApplication _confidentialClientApplication;
private IConfidentialClientApplication ConfidentialClientApplication
{
    get {
        if (_confidentialClientApplication == null) {
            _confidentialClientApplication = ConfidentialClientApplicationBuilder.Create(ClientId)
            .WithClientSecret(ClientSecret)
            .WithAuthority($"https://login.windows.net/{TenantId}")
            .Build();
        }

        return _confidentialClientApplication;
    }
}

Em seguida, utilize o seguinte código para adquirir um AuthenticationResult, utilizando os valores de autenticação que obteve quando criou o recurso Leitura Avançada.

Importante

O pacote Microsoft.IdentityModel.Clients.ActiveDirectory NuGet e Azure AD Authentication Library (ADAL) foram depreciados. Não foram adicionadas novidades desde 30 de junho de 2020. Encorajamo-lo a atualizar, ver o guia de migração para mais detalhes.

public async Task<string> GetTokenAsync()
{
    const string resource = "https://cognitiveservices.azure.com/";

    var authResult = await ConfidentialClientApplication.AcquireTokenForClient(
        new[] { $"{resource}/.default" })
        .ExecuteAsync()
        .ConfigureAwait(false);

    return authResult.AccessToken;
}

O AuthenticationResult objeto tem uma AccessToken propriedade que é o símbolo real que você usará ao lançar o Leitura Avançada usando o SDK. Também tem uma ExpiresOn propriedade que denota quando o token expirará. Antes de lançar o Leitura Avançada, pode verificar se o token expirou e adquirir um novo token apenas se tiver expirado.

Usando Node.JS

Adicione o pacote npm pedido ao seu projeto. Utilize o seguinte código para adquirir um token, utilizando os valores de autenticação que obteve quando criou o recurso Leitura Avançada.

router.get('/token', function(req, res) {
    request.post(
        {
            headers: { 'content-type': 'application/x-www-form-urlencoded' },
            url: `https://login.windows.net/${TENANT_ID}/oauth2/token`,
            form: {
                grant_type: 'client_credentials',
                client_id: CLIENT_ID,
                client_secret: CLIENT_SECRET,
                resource: 'https://cognitiveservices.azure.com/'
            }
        },
        function(err, resp, json) {
            const result = JSON.parse(json);
            return res.send({
                access_token: result.access_token,
                expires_on: result.expires_on
            });
        }
    );
});

A expires_on propriedade é a data e hora em que o token expira, expresso como o número de segundos desde 1 de janeiro de 1970 UTC. Use este valor para determinar se o seu token expirou antes de tentar adquirir um novo.

async function getToken() {
    if (Date.now() / 1000 > CREDENTIALS.expires_on) {
        CREDENTIALS = await refreshCredentials();
    }
    return CREDENTIALS.access_token;
}

Passos seguintes