Azure Identity Plugin for Token Cache Persistence

Este pacote fornece um plugin para a biblioteca Azure Identity para JavaScript (@azure/identity) que permite cache persistente de tokens. A persistência do cache de token permite que o cache de token interno persista entre sessões usando um sistema de armazenamento seguro fornecido pelo sistema operacional local.

Código-fonte | Samples

Primeiros passos

Pré-requisitos

• Uma subscrição Azure.

Instalar o pacote

Este pacote foi concebido para ser usado com o Azure Identity para JavaScript. Instale o @azure/identity e este pacote usando npm:

$ npm install --save @azure/identity
$ npm install --save @azure/identity-cache-persistence

Ambientes suportados

Azure Plugins Identity para JavaScript suportam versões estáveis (com número par) do Node.js a partir da v12. Embora os plugins possam ser executados em outras versões do Node, nenhum suporte é garantido. @azure/identity-cache-persistence não suporta ambientes de navegadores.

Conceitos-chave

Se for a sua primeira vez a usar @azure/identity ou Microsoft Entra ID, recomendamos que leia primeiro Usando @azure/identity com Microsoft Entra ID. Este documento dar-lhe-á uma compreensão mais profunda da plataforma e de como configurar corretamente a sua conta Azure.

Azure Identity Plugins

A partir de @azure/identity versão 2.0.0, a biblioteca de cliente Identity para JavaScript inclui uma API de plug-in. Este pacote (@azure/identity-cache-persistence) exporta um objeto de plugin que você deve passar como um argumento para a função de useIdentityPlugin de nível superior do pacote @azure/identity. Habilite a persistência de cache de token em seu programa da seguinte maneira:

import { useIdentityPlugin } from "@azure/identity";
import { cachePersistencePlugin } from "@azure/identity-cache-persistence";

useIdentityPlugin(cachePersistencePlugin);

Após chamar useIdentityPlugin, o plugin de cache de token persistente é registado no @azure/identity pacote e estará disponível em todas as credenciais que suportam cache persistente de token (aquelas que têm tokenCachePersistenceOptions nas suas opções de construtor).

Exemplos

Uma vez registado o plugin, pode ativar a persistência da cache de tokens passando tokenCachePersistenceOptions com uma enabled propriedade definida como true para um construtor de credenciais. No exemplo seguinte, usamos o DeviceCodeCredential, uma vez que a cache persistente dos seus tokens permite saltar o fluxo interativo de autenticação por código de dispositivo se houver um token em cache disponível.

import { DeviceCodeCredential } from "@azure/identity";

const credential = new DeviceCodeCredential({
  tokenCachePersistenceOptions: {
    enabled: true,
  },
});

// We'll use the Microsoft Graph scope as an example
const scope = "https://graph.microsoft.com/.default";

// Print out part of the access token
console.log((await credential.getToken(scope)).token.substring(0, 10), "...");

Solução de problemas

Registo

Habilitar o registro em log pode ajudar a descobrir informações úteis sobre falhas. Para ver um log de solicitações e respostas HTTP, defina a variável de ambiente AZURE_LOG_LEVEL como info. Como alternativa, o registro em log pode ser habilitado em tempo de execução chamando setLogLevel no @azure/logger:

import { setLogLevel } from "@azure/logger";

setLogLevel("info");

Próximos passos

Fornecer comentários

Se encontrares bugs ou tiveres sugestões, por favor abre uma questão.

Contribuição

Se quiser contribuir para esta biblioteca, por favor leia o guia contribuição para saber mais sobre como construir e testar o código.