Azure Identity Plugin para persistência de cache de token

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

Código-fonte | Samples

Como começar

Pré-requisitos

• Uma assinatura Azure.

Instalar o pacote

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

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

Ambientes com suporte

Azure Plugins Identity para JavaScript suportam versões estáveis (pares) do Node.js a partir da v12. Embora os plugins possam rodar em outras versões do Node, nenhum suporte é garantido. @azure/identity-cache-persistence não dá suporte ambientes de navegador.

Conceitos principais

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

Azure Identity Plugins

A partir de @azure/identity versão 2.0.0, a biblioteca de clientes de identidade para JavaScript inclui uma API de plug-in. Esse pacote (@azure/identity-cache-persistence) exporta um objeto plug-in que você deve passar como um argumento para a função de useIdentityPlugin de nível superior do pacote @azure/identity. Ative a persistência do cache de tokens no seu programa da seguinte forma:

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 é registrado no @azure/identity pacote e estará disponível em todas as credenciais que suportam cache de token persistente (aquelas que possuem tokenCachePersistenceOptions em suas opções de construtor).

Exemplos

Uma vez que o plugin seja registrado, você pode habilitar a persistência do cache de tokens passando tokenCachePersistenceOptions com uma enabled propriedade definida como true para um construtor de credenciais. No exemplo a seguir, usamos o DeviceCodeCredential, já que o cache persistente de seus tokens permite pular o fluxo interativo de autenticação por código de dispositivo se um token em cache estiver 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

Registro

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 runtime chamando setLogLevel no @azure/logger:

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

setLogLevel("info");

Próximas Etapas 

Fornecer Comentários

Se você encontrar bugs ou tiver sugestões, por favor abra uma questão.

Contributing

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