Azure Identity Plugin for Token Cache Persistence

Этот пакет предоставляет плагин к библиотеке Azure Identity для JavaScript (@azure/identity), который позволяет кэшировать постоянные токены. Сохранение кэша токенов позволяет встроенному кэшу токенов сохраняться на протяжении всех сессий с использованием защищённой системы хранения, предоставляемой локальной операционной системой.

Исходный код | Сэмплы

Начало работы

Необходимые условия

• Подписка Azure.

Установите пакет

Этот пакет предназначен для использования с Azure Identity for JavaScript. Установите @azure/identity и этот пакет с помощью npm:

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

Поддерживаемые среды

Azure Плагины идентичности для JavaScript поддерживают стабильные (чётные номера) версии Node.js, начиная с v12. Хотя плагины могут работать в других версиях Node, поддержка не гарантируется. @azure/identity-cache-persistence не поддерживает среды браузера.

Основные понятия

Если вы впервые используете @azure/identity или Microsoft Entra ID, рекомендуем сначала прочитать Использование @azure/identity с Microsoft Entra ID Этот документ даст вам более глубокое понимание платформы и того, как правильно настроить ваш аккаунт Azure.

Azure Identity Plugins

В @azure/identity версии 2.0.0 клиентская библиотека удостоверений для JavaScript включает API подключаемого модуля. Этот пакет (@azure/identity-cache-persistence) экспортирует объект подключаемого модуля, который необходимо передать в качестве аргумента функции useIdentityPlugin верхнего уровня из пакета @azure/identity. Включите сохранение кэша токенов в вашей программе следующим образом:

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

useIdentityPlugin(cachePersistencePlugin);

После вызова useIdentityPluginплагин кэша персистентных токенов регистрируется в @azure/identity пакет и будет доступен на всех учётных данных, поддерживающих кэширование перстентных токенов (тех, что есть tokenCachePersistenceOptions в настройках конструктора).

Примеры

После регистрации плагина вы можете включить сохранение кэша токенов, передавая tokenCachePersistenceOptions его с enabled заданным true свойством конструктору учетных данных. В следующем примере мы используем DeviceCodeCredential, поскольку постоянное кэширование его токенов позволяет пропускать интерактивный процесс аутентификации кода устройства, если доступен кэшированный токен.

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

Logging

Включение ведения журнала может помочь выявить полезные сведения о сбоях. Чтобы просмотреть журнал HTTP-запросов и ответов, задайте для переменной среды AZURE_LOG_LEVEL значение info. В альтернативном порядке, логирование можно включить во время выполнения, вызвав setLogLevel в @azure/logger:

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

setLogLevel("info");

Дальнейшие действия

Предоставление отзывов

Если вы столкнётесь с багами или у вас есть предложения, пожалуйста, откройте проблему.

Contributing

Если вы хотите внести вклад в эту библиотеку, пожалуйста, ознакомьтесь с руководством contributing guide чтобы узнать больше о том, как создавать и тестировать код.