Azure Identity-plugin-program för cachepersistens för token

Artikel
04/05/2023

Det här paketet innehåller ett plugin-program till Azure Identity-biblioteket för JavaScript (@azure/identity) som möjliggör beständig tokencachelagring. Med beständig tokencache kan den inbyggda tokencachen bevaras mellan sessioner med hjälp av ett säkert lagringssystem som tillhandahålls av det lokala operativsystemet.

| Källkod Prover

Komma igång

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

useIdentityPlugin(cachePersistencePlugin);

Förutsättningar

En Azure-prenumeration.

Installera paketet

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

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

Miljöer som stöds

Azure Identity-plugin-program för JavaScript stöder stabila (även numrerade) versioner av Node.js från och med v12. Plugin-program kan köras i andra Node-versioner, men inget stöd garanteras. @azure/identity-cache-persistence stöder inte webbläsarmiljöer.

Viktiga begrepp

Om det här är första gången du använder @azure/identity eller Microsofts identitetsplattform (Azure Active Directory) rekommenderar vi att du läser Använda @azure/identity med Microsoft Identity Platform först. Det här dokumentet ger dig en djupare förståelse för plattformen och hur du konfigurerar ditt Azure-konto på rätt sätt.

Plugin-program för Azure Identity

@azure/identity Från och med version 2.0.0 innehåller Identity-klientbiblioteket 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 funktionen på den översta nivån useIdentityPlugin från @azure/identity paketet. Aktivera beständighet för tokencache i ditt program på följande sätt:

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

useIdentityPlugin(cachePersistencePlugin);

När du har anropat useIdentityPluginregistreras plugin-programmet för beständig tokencache i @azure/identity paketet och är tillgängligt för alla autentiseringsuppgifter som stöder beständig tokencachelagring (de som har tokenCachePersistenceOptions i sina konstruktoralternativ).

Exempel

När plugin-programmet har registrerats kan du aktivera cachepersistence för token genom att true skicka tokenCachePersistenceOptions med en enabled egenskap som är inställd på en konstruktor för autentiseringsuppgifter. I följande exempel använder DeviceCodeCredentialvi , eftersom beständig cachelagring av dess token gör att du kan hoppa över det interaktiva autentiseringsflödet för enhetskod om en cachelagrad token är tillgänglig.

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

useIdentityPlugin(cachePersistencePlugin);

async function main() {
  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.substr(0, 10), "...");
}

main().catch((error) => {
  console.error("An error occurred:", error);
  process.exit(1);
});

Felsökning

Loggning

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

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

setLogLevel("info");

Nästa steg

Ge feedback

Om du stöter på buggar eller har förslag kan du öppna ett problem.

Bidra

Om du vill bidra till det här biblioteket kan du läsa bidragsguiden om du vill veta mer om hur du skapar och testar koden.

Visningar

Dela via