Azure Identity Plugin per la persistenza della cache dei token

Questo pacchetto fornisce un plugin per la libreria Azure Identity per JavaScript (@azure/identity) che abilita la cache persistente dei token. La persistenza della cache dei token permette alla cache dei token integrata di persistere tra le sessioni utilizzando un sistema di archiviazione sicuro fornito dal sistema operativo locale.

Codice sorgente | Campioni

Come iniziare

Prerequisiti

• Un abbonamento Azure.

Installare il pacchetto

Questo pacchetto è progettato per essere utilizzato con Azure Identity per JavaScript. Installare sia @azure/identity che questo pacchetto usando npm:

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

Ambienti supportati

Azure plugin Identity per JavaScript supportano versioni stabili (a numero pari) di Node.js a partire dalla v12. Sebbene i plugin possano funzionare in altre versioni di Node, non è garantito alcun supporto. @azure/identity-cache-persistence non supporta ambienti browser.

Concetti chiave

Se è la prima volta che usi @azure/identity o Microsoft Entra ID, ti consigliamo di leggere prima Usando @azure/identity con Microsoft Entra ID. Questo documento ti darà una comprensione più approfondita della piattaforma e di come configurare correttamente il tuo account Azure.

Azure Identity Plugins

A partire da @azure/identity versione 2.0.0, la libreria client identity per JavaScript include un'API plug-in. Questo pacchetto (@azure/identity-cache-persistence) esporta un oggetto plug-in che è necessario passare come argomento alla funzione useIdentityPlugin di primo livello dal pacchetto @azure/identity. Abilita la persistenza della cache dei token nel tuo programma come segue:

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

useIdentityPlugin(cachePersistencePlugin);

Dopo aver chiamato useIdentityPlugin, il plugin di cache persistente del token viene registrato nel @azure/identity pacchetto e sarà disponibile su tutte le credenziali che supportano la cache persistente dei token (quelle che hanno tokenCachePersistenceOptions nelle opzioni costruttori).

Examples

Una volta registrato il plugin, puoi abilitare la persistenza della cache dei token passando tokenCachePersistenceOptions con una enabled proprietà impostata a true un costruttore di credenziali. Nel seguente esempio, usiamo il DeviceCodeCredential, poiché la cache persistente dei suoi token permette di saltare il flusso interattivo di autenticazione tramite codice dispositivo se è disponibile un token cacheato.

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

Risoluzione dei problemi

Registrazione

L'abilitazione della registrazione può aiutare a individuare informazioni utili sugli errori. Per visualizzare un log di richieste e risposte HTTP, impostare la variabile di ambiente AZURE_LOG_LEVEL su info. In alternativa, la registrazione può essere abilitata in fase di esecuzione chiamando setLogLevel nel @azure/logger:

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

setLogLevel("info");

Passaggi successivi

Fornire commenti

Se incontri bug o hai suggerimenti, ti preghiamo di aprire una questione.

Contributing

Se desideri contribuire a questa libreria, leggi la guida contributi per saperne di più su come costruire e testare il codice.