Azure Identity Plugin for Token Cache Persistence

Dit pakket biedt een plugin voor de Azure Identity-bibliotheek voor JavaScript (@azure/identity) die persistent tokencaching mogelijk maakt. Tokencache-persistentie maakt het mogelijk om de ingebouwde tokencache over sessies heen te behouden met behulp van een veilig opslagsysteem dat door het lokale besturingssysteem wordt geleverd.

Broncode | Samples

Aan de slag

Vereiste voorwaarden

• Een Azure abonnement.

Installeer het pakket

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

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

Ondersteunde omgevingen

Azure Identity-plugins voor JavaScript ondersteunen stabiele (even genummerde) versies van Node.js vanaf v12. Hoewel de plugins in andere Node-versies kunnen draaien, is geen garantie voor ondersteuning. @azure/identity-cache-persistence biedt geen ondersteuning voor browseromgevingen.

belangrijke concepten

Als dit de eerste keer is dat je @azure/identity of Microsoft Entra ID gebruikt, raden we aan om eerst Using @azure/identity with Microsoft Entra ID te lezen. Dit document geeft je een dieper begrip van het platform en hoe je je Azure-account correct kunt configureren.

Azure Identity Plugins

Vanaf @azure/identity versie 2.0.0 bevat de identiteitsclientbibliotheek voor JavaScript een invoegtoepassings-API. Met dit pakket (@azure/identity-cache-persistence) exporteert u een invoegtoepassingsobject dat u als argument moet doorgeven aan de functie op het hoogste niveau useIdentityPlugin uit het @azure/identity-pakket. Schakel tokencache-persistentie in je programma als volgt in:

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

useIdentityPlugin(cachePersistencePlugin);

Na het aanroepen useIdentityPluginvan , wordt de persistent token cache-plugin geregistreerd aan het @azure/identity pakket en zal beschikbaar zijn op alle inloggegevens die persistent token caching ondersteunen (die in tokenCachePersistenceOptions hun constructoropties).

Examples

Zodra de plugin geregistreerd is, kun je tokencache-persistentie inschakelen door een enabled eigenschap die op is gezet naar true een credential-constructor te sturentokenCachePersistenceOptions. In het volgende voorbeeld gebruiken we de DeviceCodeCredential, omdat persistent caching van de tokens je in staat stelt de interactieve apparaatcode-authenticatieflow over te slaan als er een gecachte token beschikbaar is.

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

Troubleshooting

Logging

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

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

setLogLevel("info");

Volgende stappen 

Feedback geven

Als je bugs tegenkomt of suggesties hebt, open een issue.

Contributing

Als je wilt bijdragen aan deze bibliotheek, lees dan de bijdragende gids om meer te weten te komen over hoe je de code bouwt en test.