Azure Identity Plugin for Token Cache Persistence

Tento balíček poskytuje plugin ke knihovně Azure Identity pro JavaScript (@azure/identity), který umožňuje trvalé cachování tokenů. Perzistence token cache umožňuje vestavěné tokenové cache přetrvávat napříč relacemi pomocí zabezpečeného úložného systému poskytovaného lokálním operačním systémem.

Zdrojový kód | Samples

Začínáme

Předpoklady

Nainstalujte balíček

Tento balíček je navržen pro použití s Azure Identity pro JavaScript. Nainstalujte @azure/identity i tento balíček pomocí npm:

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

Podporovaná prostředí

Azure Identity pluginy pro JavaScript podporují stabilní (sudé číslované) verze Node.js od v12. I když pluginy mohou běžet v jiných verzích Node, podpora není zaručena. @azure/identity-cache-persistence nepodporuje prostředí prohlížeče.

Klíčové koncepty

Pokud používáte @azure/identity nebo Microsoft Entra ID poprvé, doporučujeme nejprve si přečíst Using @azure/identity s Microsoft Entra ID nejdříve. Tento dokument vám poskytne hlubší pochopení platformy a toho, jak správně nastavit svůj Azure účet.

Azure Identity Plugins

Od @azure/identity verze 2.0.0 zahrnuje klientská knihovna identit pro JavaScript rozhraní API modulu plug-in. Tento balíček (@azure/identity-cache-persistence) exportuje objekt modulu plug-in, který musíte předat jako argument funkci useIdentityPlugin nejvyšší úrovně z balíčku @azure/identity. Povolte perzistenci token cache ve vašem programu následovně:

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

useIdentityPlugin(cachePersistencePlugin);

Po vyvolání useIdentityPluginje plugin persistentní token cache registrován v balíčku @azure/identity a bude dostupný na všech přihlašovacích údajích, které podporují persistentní cache tokenů (těch, které mají tokenCachePersistenceOptions v možnostech konstruktoru).

Příklady

Jakmile je plugin zaregistrován, můžete povolit perzistenci token cache tím, že s vlastností nastavenou enabled na true předáte tokenCachePersistenceOptions konstruktoru přihlašovacích údajů. V následujícím příkladu používáme DeviceCodeCredential, protože trvalé cachování jeho tokenů umožňuje přeskočit interaktivní proces ověřování kódu zařízení, pokud je k dispozici cacheovaný 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), "...");

Troubleshooting

Logování

Povolení protokolování může pomoct odhalit užitečné informace o chybách. Pokud chcete zobrazit protokol požadavků a odpovědí HTTP, nastavte proměnnou prostředí AZURE_LOG_LEVEL na info. Případně můžete protokolování povolit za běhu voláním setLogLevel v @azure/logger:

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

setLogLevel("info");

Další kroky

Poskytnout zpětnou vazbu

Pokud narazíte na chyby nebo máte nějaké návrhy, prosím, otevřete číslo.

Contributing

Pokud byste chtěli přispět do této knihovny, přečtěte si prosím průvodce přispívání kde se dozvíte více o tom, jak kód sestavit a testovat.

  • Last updated on