Azure Identity Plugin para persistencia de caché de token

Este paquete proporciona un complemento para la biblioteca Azure Identity para JavaScript (@azure/identity) que permite la caché persistente de tokens. La persistencia de la caché de token permite que la caché de tokens integrada persista entre sesiones utilizando un sistema de almacenamiento seguro proporcionado por el sistema operativo local.

Código fuente | Samples

Cómo empezar

Prerrequisitos

• Una suscripción Azure.

Instalar el paquete

Este paquete está diseñado para usarse con Azure Identity para JavaScript. Instale tanto @azure/identity como este paquete mediante npm:

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

Entornos admitidos

Azure Los plugins de identidad para JavaScript soportan versiones estables (con número par) de Node.js a partir de la v12. Aunque los plugins pueden funcionar en otras versiones de Node, no hay soporte garantizado. @azure/identity-cache-persistence no admite entornos de explorador.

Conceptos clave

Si es la primera vez que usas @azure/identity o Microsoft Entra ID, te recomendamos que leas primero Usando @azure/identity con Microsoft Entra ID. Este documento te dará una comprensión más profunda de la plataforma y de cómo configurar correctamente tu cuenta de Azure.

Azure Identity Plugins

A partir de @azure/identity versión 2.0.0, la biblioteca cliente de identidad para JavaScript incluye una API de complemento. Este paquete (@azure/identity-cache-persistence) exporta un objeto de complemento que debe pasar como argumento a la función de useIdentityPlugin de nivel superior del paquete de @azure/identity. Activa la persistencia de la caché de tokens en tu programa de la siguiente manera:

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

useIdentityPlugin(cachePersistencePlugin);

Después de llamar useIdentityPlugina , el plugin de caché de tokens persistentes se registra en el @azure/identity paquete y estará disponible en todas las credenciales que soporten caché de tokens persistentes (aquellas que tienen tokenCachePersistenceOptions en sus opciones de constructor).

Ejemplos

Una vez que el plugin está registrado, puedes habilitar la persistencia de la caché de tokens pasando tokenCachePersistenceOptions con una enabled propiedad configurada a true un constructor de credenciales. En el siguiente ejemplo, usamos el DeviceCodeCredential, ya que la caché persistente de sus tokens permite saltarse el flujo interactivo de autenticación por código de dispositivo si hay un token en caché disponible.

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), "...");

Solución de problemas

Registro

Habilitar el registro puede ayudar a descubrir información útil sobre errores. Para ver un registro de solicitudes y respuestas HTTP, establezca la variable de entorno AZURE_LOG_LEVEL en info. Como alternativa, el registro se puede habilitar en tiempo de ejecución llamando a setLogLevel en el @azure/logger:

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

setLogLevel("info");

Pasos siguientes

Proporcionar comentarios

Si encuentras bugs o tienes sugerencias, por favor abre un problema.

Contributing

Si quieres contribuir a esta biblioteca, por favor lee la guía contribución para aprender más sobre cómo construir y probar el código.