Modul plug-in Azure Identity pro trvalost mezipaměti tokenů

Článek
04/05/2023

Tento balíček poskytuje modul plug-in do knihovny Azure Identity pro JavaScript (@azure/identity), který umožňuje ukládání trvalých tokenů do mezipaměti. Trvalost mezipaměti tokenů umožňuje, aby integrovaná mezipaměť tokenů uchovávala napříč relacemi pomocí zabezpečeného systému úložiště poskytovaného místním operačním systémem.

Zdrojový kód | Vzorky

Začínáme

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

useIdentityPlugin(cachePersistencePlugin);

Požadavky

Předplatné Azure

Instalace balíčku

Tento balíček je navržený pro použití se službou Azure Identity pro JavaScript. Nainstalujte oba a @azure/identity tento balíček pomocí npm:

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

Podporovaná prostředí

Moduly plug-in Azure Identity pro JavaScript podporují stabilní (sudé) verze Node.js počínaje verzí v12. I když moduly plug-in můžou běžet v jiných verzích Node, není zaručena žádná podpora. @azure/identity-cache-persistence nepodporuje prostředí prohlížeče.

Klíčové koncepty

Pokud používáte @azure/identity nebo Microsoft identity platform (Azure Active Directory) poprvé, doporučujeme přečíst si nejprve téma Použití @azure/identity s platformou Microsoft Identity Platform. Tento dokument vám poskytne hlubší pochopení platformy a toho, jak správně nakonfigurovat účet Azure.

Moduly plug-in Azure Identity

@azure/identity Od verze 2.0.0 obsahuje 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 nejvyšší úrovně useIdentityPlugin z @azure/identity balíčku. Následujícím způsobem povolte v programu trvalost mezipaměti tokenů:

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

useIdentityPlugin(cachePersistencePlugin);

Po volání useIdentityPluginse modul plug-in mezipaměti trvalých tokenů zaregistruje do @azure/identity balíčku a bude k dispozici pro všechny přihlašovací údaje, které podporují trvalé ukládání tokenů do mezipaměti (ty, které mají tokenCachePersistenceOptions v možnostech konstruktoru).

Příklady

Po registraci modulu plug-in můžete povolit trvalost mezipaměti tokenů předáním tokenCachePersistenceOptionsenabled vlastnosti nastavené na true konstruktoru přihlašovacích údajů. V následujícím příkladu DeviceCodeCredentialpoužíváme , protože trvalé ukládání tokenů do mezipaměti umožňuje přeskočit tok interaktivního ověřování kódu zařízení, pokud je k dispozici token uložený v mezipaměti.

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

Řešení potíží

protokolování

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

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

setLogLevel("info");

Další kroky

Zadání zpětné vazby

Pokud narazíte na chyby nebo máte návrhy, otevřete problém.

Přispívání

Pokud chcete přispívat do této knihovny, přečtěte si příručku pro přispívání , kde najdete další informace o tom, jak sestavit a otestovat kód.

Imprese

Sdílet prostřednictvím