Azure Identity Plugin for Token Cache Persistence

Dieses Paket stellt ein Plugin für die Azure Identity-Bibliothek für JavaScript (@azure/identity) bereit, das persistentes Token-Caching ermöglicht. Die Token-Cache-Persistenz ermöglicht es, dass der integrierte Token-Cache über Sitzungen hinweg über ein sicheres Speichersystem des lokalen Betriebssystems hinweg erhalten bleibt.

Quellcode | Beispiele

Erste Schritte

Voraussetzungen

• Ein Azure Abonnement.

Installiere das Paket

Dieses Paket ist dafür konzipiert, mit Azure Identity für JavaScript verwendet zu werden. Installieren Sie sowohl @azure/identity als auch dieses Paket mit npm:

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

Unterstützte Umgebungen

Azure Identity-Plugins für JavaScript unterstützen stabile (gerade nummerierte) Versionen von Node.js ab v12. Obwohl die Plugins in anderen Node-Versionen laufen können, ist keine Unterstützung garantiert. @azure/identity-cache-persistence unterstützt keine Browserumgebungen.

Wichtige Konzepte

Wenn Sie zum ersten Mal @azure/identity oder Microsoft Entra ID verwenden, empfehlen wir, zuerst Using @azure/identity with Microsoft Entra ID zu lesen. Dieses Dokument vermittelt Ihnen ein tieferes Verständnis der Plattform und wie Sie Ihr Azure-Konto korrekt konfigurieren.

Azure Identity Plugins

Ab @azure/identity 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 an die Funktion der obersten Ebene useIdentityPlugin aus dem @azure/identity-Paket übergeben müssen. Aktivieren Sie die Token-Cache-Persistenz in Ihrem Programm wie folgt:

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

useIdentityPlugin(cachePersistencePlugin);

Nach dem Aufruf useIdentityPluginist das persistent-Token-Cache-Plugin im @azure/identity Paket registriert und ist auf allen Zugangsdaten verfügbar, die persistentes Token-Caching unterstützen (solche in tokenCachePersistenceOptions ihren Konstruktoroptionen).

Beispiele

Sobald das Plugin registriert ist, können Sie die Token-Cache-Persistenz aktivieren, indem Sie mit einer enabled Eigenschaft auf true an einen Credential-Konstruktor übergebentokenCachePersistenceOptions. Im folgenden Beispiel verwenden wir das DeviceCodeCredential, da persistente Caching seiner Tokens es ermöglicht, den interaktiven Authentifizierungsfluss des Gerätecodes zu überspringen, wenn ein zwischengespeicherter Token verfügbar ist.

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

Problembehandlung

Protokollierung

Das Aktivieren der Protokollierung kann hilfreiche Informationen zu Fehlern aufdecken. Um ein Protokoll von HTTP-Anforderungen und -Antworten anzuzeigen, legen Sie die AZURE_LOG_LEVEL Umgebungsvariable auf infofest. Alternativ kann die Protokollierung zur Laufzeit durch Aufrufen von setLogLevel im @azure/loggeraktiviert werden:

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

setLogLevel("info");

Nächste Schritte

Feedback geben

Wenn du auf Bugs stößt oder Vorschläge hast, öffne ein Problem.

Contributing

Wenn Sie zu dieser Bibliothek beitragen möchten, lesen Sie bitte den beitragenden Leitfaden, um mehr darüber zu erfahren, wie man den Code erstellt und testet.