Azure Identity Plugin for Token Cache Persistence

Ez a csomag egy bővítményt biztosít a Azure Identity könyvtárhoz JavaScripthez (@azure/identity), amely lehetővé teszi a tartós token gyorsítótározást. A token cache tartósság lehetővé teszi, hogy a beépített token cache a helyi operációs rendszer által biztosított biztonságos tárolórendszeren keresztül működjön a munkamenetek között.

Forráskód | Minták

Kezdő lépések

Előfeltételek

A csomag telepítése

Ez a csomag az Azure Identity for JavaScript használatra készült. Telepítse @azure/identity és ezt a csomagot is a npm:

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

Támogatott környezetek

Azure JavaScript identitás pluginjei stabil (páros számozású) verziókat támogatnak a Node.js verzióiból a v12-től kezdődően. Bár a bővítmények más Node verziókban is futhatnak, a támogatás nem garantált. @azure/identity-cache-persistence nem támogatja a böngészőkörnyezeteket.

főbb fogalmak

Ha ez az első alkalom, hogy @azure/identity vagy Microsoft Entra ID használod, először olvasd el a Using @azure/identity with Microsoft Entra ID szöveget. Ez a dokumentum mélyebb megértést ad a platformról és arról, hogyan konfigurálhatja helyesen az Azure fiókját.

Azure Identity Plugins

@azure/identity 2.0.0-s verziójá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 legfelső szintű useIdentityPlugin függvénynek a @azure/identity csomagból. Engedélyezze a token cache tartósságát a programodban az alábbiak szerint:

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

useIdentityPlugin(cachePersistencePlugin);

Hívás useIdentityPluginután a tartós token cache plugin regisztrálódik a @azure/identity csomagban, és elérhető lesz minden olyan hitelesítő eszközön, amely támogatja a tartós token gyorsítótárázást (azoknál, amelyek a konstruktor opcióikban vannak tokenCachePersistenceOptions ).

Examples

Miután a plugin regisztrálva van, engedélyezheted a token cache persistenciát úgy tokenCachePersistenceOptions , hogy egy enabled tulajdonságot adsz true át egy hitelesítési konstruktornak. A következő példában a , használjuk, DeviceCodeCredentialmivel a tokenek állandó gyorsítótárázása lehetővé teszi, hogy kihagyjuk az interaktív eszközkód hitelesítési folyamatot, ha elérhető egy gyorsagtározott token.

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

Hibaelhárítás

Logging

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 következőre info: . Alternatívaként a naplózás futásidőben is engedélyezhető a setLogLevel hívásával a @azure/logger.

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

setLogLevel("info");

Következő lépések

Visszajelzés küldése

Ha hibákat találsz vagy javaslataid vannak, kérlek, nyiss ki egy problémát.

Közreműködés

Ha szeretnél hozzájárulni ehhez a könyvtárhoz, kérjük, olvasd el a hozzájárulás útmutatót hogy többet megtudj arról, hogyan lehet elkészíteni és tesztelni a kódot.

  • Last updated on