Azure Identity Plug-In für Tokencachepersistenz

Artikel
09/27/2024

Dieses Paket stellt ein Plug-In für die Azure Identity-Bibliothek für JavaScript (@azure/identity) bereit, das die persistente Tokenzwischenspeicherung ermöglicht. Die Persistenz des Tokencaches ermöglicht es, dass der integrierte Tokencache sitzungsübergreifend beibehalten wird, indem ein sicheres Speichersystem verwendet wird, das vom lokalen Betriebssystem bereitgestellt wird.

Quellcode | Proben

Erste Schritte

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

useIdentityPlugin(cachePersistencePlugin);

Voraussetzungen

Ein Azure-Abonnement.

Installieren des Pakets

Dieses Paket ist für die Verwendung mit Azure Identity for JavaScript konzipiert. Installieren Sie sowohl als auch @azure/identity dieses Paket mit npm:

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

Unterstützte Umgebungen

Azure Identity-Plug-Ins für JavaScript unterstützen stabile (gerade nummerierte) Versionen von Node.js ab v12. Während die Plug-Ins möglicherweise in anderen Node-Versionen ausgeführt werden, wird keine Unterstützung garantiert. @azure/identity-cache-persistence unterstützt keine Browserumgebungen.

Wichtige Begriffe

Wenn Sie @azure/identity oder Microsoft Identity Platform (Azure Active Directory) zum ersten Mal verwenden, empfehlen wir, zuerst Verwenden von @azure/identity mit Microsoft Identity Platform zu lesen. Dieses Dokument vermittelt Ihnen ein tieferes Verständnis der Plattform, und Sie erfahren, wie Sie Ihr Azure-Konto richtig konfigurieren.

Azure Identity-Plug-Ins

@azure/identity Ab Version 2.0.0 enthält die Identitätsclientbibliothek für JavaScript eine Plug-In-API. Dieses Paket (@azure/identity-cache-persistence) exportiert ein Plug-In-Objekt, das Sie als Argument aus dem Paket an die Funktion der @azure/identity obersten Ebene useIdentityPlugin übergeben müssen. Aktivieren Sie die Persistenz des Tokencaches in Ihrem Programm wie folgt:

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

useIdentityPlugin(cachePersistencePlugin);

Nach dem Aufrufen useIdentityPluginvon wird das Plug-In für den persistenten Tokencache für das @azure/identity Paket registriert und steht für alle Anmeldeinformationen zur Verfügung, die die persistente Tokenzwischenspeicherung unterstützen (diejenigen, die tokenCachePersistenceOptions über Konstruktoroptionen verfügen).

Beispiele

Nachdem das Plug-In registriert wurde, können Sie die Persistenz des Tokencaches aktivieren, indem Sie eine enabled Eigenschaft, die auf true festgelegt ist, an einen Anmeldeinformationskonstruktor übergebentokenCachePersistenceOptions. Im folgenden Beispiel verwenden wir , DeviceCodeCredentialda das persistente Zwischenspeichern seiner Token es Ihnen ermöglicht, den interaktiven Authentifizierungsflow für Gerätecode zu überspringen, wenn ein zwischengespeichertes Token verfügbar ist.

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

Problembehandlung

Protokollierung

Die Aktivierung der Protokollierung kann hilfreiche Informationen über Fehler aufdecken. Um ein Protokoll von HTTP-Anforderungen und -Antworten anzuzeigen, legen Sie die Umgebungsvariable AZURE_LOG_LEVEL auf info fest. Alternativ kann die Protokollierung zur Laufzeit aktiviert werden, indem Sie setLogLevel in @azure/logger aufrufen:

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

setLogLevel("info");

Nächste Schritte

Feedback geben

Wenn Fehler auftreten oder wenn Sie Vorschläge haben, erstellen Sie ein Problem.

Mitwirken

Wenn Sie an dieser Bibliothek mitwirken möchten, lesen Sie die Anleitung für Mitwirkende, um mehr darüber zu erfahren, wie Sie den Code erstellen und testen können.

Aufrufe

Freigeben über