Azure Identity Beépülő modul a tokengyorsítótár-adatmegőrzéshez

Ez a csomag egy beépülő modult biztosít a JavaScripthez készült Azure Identity-kódtárhoz (@azure/identity), amely lehetővé teszi az állandó tokenek gyorsítótárazását. A tokengyorsítótár megőrzése lehetővé teszi, hogy a beépített jogkivonat-gyorsítótár a helyi operációs rendszer által biztosított biztonságos tárolórendszerrel megőrizhesse a munkameneteket.

Forráskód | Minták

Első lépések

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

useIdentityPlugin(cachePersistencePlugin);

Előfeltételek

• Egy Azure-előfizetés.

A csomag telepítése

Ez a csomag az Azure Identity for JavaScripthez való használatához készült. Telepítse mindkettőt @azure/identity és ezt a csomagot a következő használatával npm:

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

Támogatott környezetek

A JavaScripthez készült Azure Identity beépülő modulok támogatják a Node.js stabil (páros számozott) verzióit a 12-es verziótól kezdve. Bár a beépülő modulok más Node-verziókban is futtathatók, a támogatás nem garantált. @azure/identity-cache-persistence nem támogatja a böngészőkörnyezeteket.

Fő fogalmak

Ha most használja először @azure/identity az Microsoft Identitásplatform (Azure Active Directory), javasoljuk, hogy először olvassa el a Használat @azure/identity a Microsoft Identity Platformmal című cikket. Ez a dokumentum részletesebben ismerteti a platformot és az Azure-fiók helyes konfigurálásának módját.

Azure Identity beépülő modulok

@azure/identity A 2.0.0-s verziótól a JavaScript identitásügyfél-kódtára tartalmaz egy beépülő modul API-t. Ez a csomag (@azure/identity-cache-persistence) exportál egy beépülő modulobjektumot, amelyet argumentumként kell átadnia a csomag legfelső szintű useIdentityPlugin függvényének @azure/identity . A jogkivonat-gyorsítótár megőrzésének engedélyezése a programban az alábbiak szerint:

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

useIdentityPlugin(cachePersistencePlugin);

A hívás useIdentityPluginután az állandó jogkivonat-gyorsítótár beépülő modul regisztrálva lesz a @azure/identity csomagban, és minden olyan hitelesítő adaton elérhető lesz, amely támogatja az állandó jogkivonatok gyorsítótárazását (amelyek konstruktorbeállításai vannak tokenCachePersistenceOptions ).

Példák

A beépülő modul regisztrálása után engedélyezheti a tokengyorsítótár-adatmegőrzést tokenCachePersistenceOptions egy enabled hitelesítőadat-konstruktorra true beállított tulajdonsággal. A következő példában a DeviceCodeCredential, mivel a jogkivonatok állandó gyorsítótárazása lehetővé teszi, hogy kihagyja az interaktív eszközkód hitelesítési folyamatot, ha elérhető gyorsítótárazott jogkivonat.

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

Hibaelhárítás

Naplózás

A naplózás engedélyezése segíthet a hibákról szóló hasznos információk feltárásában. A HTTP-kérések és válaszok naplójának megtekintéséhez állítsa a környezeti változót a AZURE_LOG_LEVEL értékre info. A naplózás futásidőben is engedélyezhető a következő hívással setLogLevel@azure/logger:

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

setLogLevel("info");

Következő lépések

Visszajelzés küldése

Ha hibákat tapasztal, vagy javaslatai vannak, nyisson meg egy problémát.

Közreműködés

Ha hozzá szeretne járulni ehhez a kódtárhoz, olvassa el a közreműködői útmutatót , amelyből többet is megtudhat a kód összeállításáról és teszteléséről.