Azure Identity Plugin for Token Cache Persistence

Pakiet ten zawiera wtyczkę do biblioteki Azure Identity for JavaScript (@azure/identity), która umożliwia trwałe buforowanie tokenów. Utrzymywanie pamięci podręcznej tokenów pozwala wbudowanej pamięci podręcznej tokenów utrzymywać się w różnych sesjach przy użyciu bezpiecznego systemu przechowywania danych zapewnianego przez lokalny system operacyjny.

Kod źródłowy | Samples

Rozpoczęcie pracy

Wymagania wstępne

• Subskrypcja Azure .

Instalowanie pakietu

Ten pakiet został zaprojektowany do użycia z Azure Identity for JavaScript. Zainstaluj zarówno @azure/identity, jak i ten pakiet przy użyciu npm:

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

Obsługiwane środowiska

Wtyczki Azure Identity dla JavaScript obsługują stabilne (parzyste) wersje Node.js począwszy od v12. Chociaż wtyczki mogą działać w innych wersjach Node, wsparcie nie jest gwarantowane. @azure/identity-cache-persistence nie obsługuje środowisk przeglądarki.

Kluczowe pojęcia

Jeśli po raz pierwszy używasz @azure/identity lub Microsoft Entra ID, zalecamy najpierw przeczytać Using @azure/identity z Microsoft Entra ID Ten dokument pozwoli Ci lepiej zrozumieć platformę i dowiedzieć się, jak poprawnie skonfigurować swoje konto Azure.

Azure Identity Plugins

Od wersji @azure/identity 2.0.0 biblioteka klienta identity dla języka JavaScript zawiera interfejs API wtyczki. Ten pakiet (@azure/identity-cache-persistence) eksportuje obiekt wtyczki, który należy przekazać jako argument do funkcji useIdentityPlugin najwyższego poziomu z pakietu @azure/identity. Włącz trwałość pamięci podręcznej tokenów w swoim programie w następujący sposób:

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

useIdentityPlugin(cachePersistencePlugin);

Po wywołaniu useIdentityPlugin, wtyczka persist token cache jest zarejestrowana w pakiecie @azure/identity i będzie dostępna we wszystkich poświadczeniach obsługujących trwałe bufor token (tych, które mają tokenCachePersistenceOptions w swoich konstrukcjach).

Examples

Po zarejestrowaniu wtyczki możesz włączyć trwałość pamięci podręcznej tokenów, przekazując tokenCachePersistenceOptions ją z właściwością ustawioną enabled na true do konstruktora poświadczeń. W poniższym przykładzie używamy , DeviceCodeCredentialponieważ trwałe buforowanie jego tokenów pozwala pominąć interaktywny proces uwierzytelniania kodem urządzenia, jeśli dostępny jest token buforowany.

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

Przemysł drzewny

Włączenie rejestrowania może pomóc odkryć przydatne informacje o błędach. Aby wyświetlić dziennik żądań i odpowiedzi HTTP, ustaw zmienną środowiskową AZURE_LOG_LEVEL na info. Alternatywnie rejestrowanie można włączyć w czasie wykonywania, wywołując setLogLevel w @azure/logger:

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

setLogLevel("info");

Następne kroki

Przekaż opinię

Jeśli napotkasz błędy lub masz sugestie, proszę otwórz numer.

Contributing

Jeśli chcesz przyczynić się do tej biblioteki, przeczytaj przewodnik wkład aby dowiedzieć się więcej o budowaniu i testowaniu kodu.