Azure Identity Plugin för Token Cache Persistence

Detta paket tillhandahåller ett tillägg till Azure Identity-biblioteket för JavaScript (@azure/identity) som möjliggör persistent token-cache. Tokencache-persistens gör det möjligt för den inbyggda tokencachen att bevara över sessioner med hjälp av ett säkert lagringssystem som tillhandahålls av det lokala operativsystemet.

Källkod | Samples

Komma igång

Förutsättningar

• Ett Azure abonnemang.

Installera paketet

Detta paket är utformat för att användas med Azure Identity för JavaScript. Installera både @azure/identity och det här paketet med hjälp av npm:

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

Miljöer som stöds

Azure Identity-plugins för JavaScript stödjer stabila (jämna) versioner av Node.js från och med v12. Även om pluginen kan köras i andra Node-versioner är inget stöd garanterat. @azure/identity-cache-persistence stöder inte webbläsarmiljöer.

Viktiga begrepp

Om detta är första gången du använder @azure/identity eller Microsoft Entra ID rekommenderar vi att du läser Using @azure/identity med Microsoft Entra ID först. Detta dokument ger dig en djupare förståelse för plattformen och hur du konfigurerar ditt Azure-konto korrekt.

Azure Identity Plugins

Från och med @azure/identity version 2.0.0 innehåller identitetsklientbiblioteket för JavaScript ett plugin-API. Det här paketet (@azure/identity-cache-persistence) exporterar ett plugin-objekt som du måste skicka som ett argument till den översta useIdentityPlugin-funktionen från @azure/identity-paketet. Aktivera tokencache-persistens i ditt program enligt följande:

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

useIdentityPlugin(cachePersistencePlugin);

Efter anrop useIdentityPluginregistreras pluginet för persistenta tokencachen till paketet @azure/identity och kommer att finnas tillgängligt på alla inloggningsuppgifter som stödjer persistent tokencaching (de som har tokenCachePersistenceOptions det i sina konstruktöralternativ).

Exempel

När pluginet är registrerat kan du aktivera tokencache-persistens genom att skicka tokenCachePersistenceOptions en enabled egenskap satt till true en legitimationskonstruktör. I följande exempel använder DeviceCodeCredentialvi , eftersom persistent caching av dess tokens gör det möjligt att hoppa över det interaktiva autentiseringsflödet av enhetskod om en cachad token finns tillgänglig.

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

Felsökning

Loggar

Aktivering av loggning kan hjälpa dig att hitta användbar information om fel. Om du vill se en logg med HTTP-begäranden och svar anger du AZURE_LOG_LEVEL miljövariabeln till info. Du kan också aktivera loggning vid körning genom att anropa setLogLevel i @azure/logger:

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

setLogLevel("info");

Nästa steg

Lämna feedback

Om du stöter på buggar eller har förslag, vänligen öppna ett problem.

Contributing

Om du vill bidra till detta bibliotek, läs gärna guiden bidrag för att lära dig mer om hur man bygger och testar koden.