Azure Identity-invoegtoepassing voor persistentie van tokencache

Artikel
04/05/2023

Dit pakket biedt een invoegtoepassing voor de Azure Identity-bibliotheek voor JavaScript (@azure/identity) die permanente tokencache mogelijk maakt. Met persistentie van de tokencache kan de ingebouwde tokencache blijven bestaan tussen sessies met behulp van een beveiligd opslagsysteem dat wordt geleverd door het lokale besturingssysteem.

Broncode | Monsters

Aan de slag

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

useIdentityPlugin(cachePersistencePlugin);

Vereisten

Een Azure-abonnement.

Het pakket installeren

Dit pakket is ontworpen voor gebruik met Azure Identity voor JavaScript. Installeer zowel als @azure/identity dit pakket met behulp van npm:

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

Ondersteunde omgevingen

Azure Identity-invoegtoepassingen voor JavaScript ondersteunen stabiele (even genummerde) versies van Node.js vanaf v12. Hoewel de invoegtoepassingen in andere knooppuntversies kunnen worden uitgevoerd, wordt er geen ondersteuning gegarandeerd. @azure/identity-cache-persistencebiedt geen ondersteuning voor browseromgevingen.

Belangrijkste concepten

Als dit de eerste keer @azure/identity is dat u of de Microsoft identity platform (Azure Active Directory) gebruikt, raden we u aan eerst Gebruiken @azure/identity met Microsoft Identity Platform te lezen. In dit document krijgt u meer inzicht in het platform en hoe u uw Azure-account correct configureert.

Azure Identity-invoegtoepassingen

@azure/identity Vanaf versie 2.0.0 bevat de Identity-clientbibliotheek voor JavaScript een api voor invoegtoepassingen. Met dit pakket (@azure/identity-cache-persistence) wordt een invoegtoepassingsobject geëxporteerd dat u als argument moet doorgeven aan de functie op het hoogste niveau useIdentityPlugin van het @azure/identity pakket. Schakel persistentie van tokencache in uw programma als volgt in:

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

useIdentityPlugin(cachePersistencePlugin);

Na het aanroepen useIdentityPluginvan wordt de invoegtoepassing voor de permanente tokencache geregistreerd bij het @azure/identity pakket en is deze beschikbaar voor alle referenties die ondersteuning bieden voor permanente tokencaching (de referenties die de constructoropties hebben tokenCachePersistenceOptions ).

Voorbeelden

Zodra de invoegtoepassing is geregistreerd, kunt u persistentie van de tokencache inschakelen door een enabled eigenschap die is ingesteld op door te true geven tokenCachePersistenceOptions aan een referentieconstructor. In het volgende voorbeeld gebruiken we de DeviceCodeCredential, omdat u de interactieve verificatiestroom voor apparaatcode kunt overslaan als er een token in de cache beschikbaar is.

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);
});

Problemen oplossen

Logboekregistratie

Het inschakelen van logboekregistratie kan helpen bij het ontdekken van nuttige informatie over fouten. Als u een logboek met HTTP-aanvragen en -antwoorden wilt zien, stelt u de AZURE_LOG_LEVEL omgevingsvariabele in op info. Logboekregistratie kan ook worden ingeschakeld tijdens runtime door aan te roepen setLogLevel in de @azure/logger:

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

setLogLevel("info");

Volgende stappen

Feedback geven

Als u fouten tegenkomt of suggesties hebt, opent u een probleem.

Bijdragen

Als u een bijdrage wilt leveren aan deze bibliotheek, leest u de handleiding voor bijdragen voor meer informatie over het bouwen en testen van de code.

Weergaven

Delen via