Plugin Azure Identity untuk Persistensi Cache Token

Paket ini menyediakan plugin ke pustaka Identitas Azure untuk JavaScript (@azure/identity) yang memungkinkan penembolokan token persisten. Persistensi cache token memungkinkan cache token bawaan bertahan di seluruh sesi menggunakan sistem penyimpanan aman yang disediakan oleh sistem operasi lokal.

Kode sumber | Sampel

Memulai Langkah Pertama

Prasyarat

• Langganan Azure.

Pasang paketnya

Paket ini dirancang untuk digunakan dengan Azure Identity untuk JavaScript. Instal @azure/identity dan paket ini menggunakan npm:

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

Lingkungan yang Didukung

Azure Plugin identitas untuk JavaScript mendukung versi Node.js yang stabil (bernomor genap) mulai dari v12. Meskipun plugin dapat berjalan di versi Node lain, tidak ada dukungan yang dijamin. @azure/identity-cache-persistence tidak mendukung lingkungan browser.

Konsep Utama

Jika ini adalah pertama kalinya Anda menggunakan @azure/identity atau Microsoft Entra ID, sebaiknya baca Menggunakan @azure/identity dengan Microsoft Entra ID terlebih dahulu. Dokumen ini akan memberi Anda pemahaman yang lebih dalam tentang platform dan cara mengonfigurasi akun Azure Anda dengan benar.

Plugin Azure Identity

Pada @azure/identity versi 2.0.0, pustaka klien Identitas untuk JavaScript menyertakan API plugin. Paket ini (@azure/identity-cache-persistence) mengekspor objek plugin yang harus Anda teruskan sebagai argumen ke fungsi useIdentityPlugin tingkat atas dari paket @azure/identity. Aktifkan persistensi cache token dalam program Anda sebagai berikut:

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

useIdentityPlugin(cachePersistencePlugin);

Setelah memanggil useIdentityPlugin, plugin cache token persisten terdaftar ke @azure/identity paket dan akan tersedia di semua kredensial yang mendukung cache token persisten (yang ada tokenCachePersistenceOptions di opsi konstruktornya).

Examples

Setelah plugin terdaftar, Anda dapat mengaktifkan persistensi cache token dengan meneruskan tokenCachePersistenceOptions properti enabled yang diatur ke true konstruktor kredensial. Dalam contoh berikut, kami menggunakan , DeviceCodeCredentialkarena penembolokan persisten tokennya memungkinkan Anda melewati alur autentikasi kode perangkat interaktif jika token cache tersedia.

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

Penebangan kayu

Mengaktifkan pengelogan dapat membantu menemukan informasi yang berguna tentang kegagalan. Untuk melihat log permintaan dan respons HTTP, atur variabel lingkungan AZURE_LOG_LEVEL ke info. Atau, pengelogan dapat diaktifkan saat runtime dengan memanggil setLogLevel di @azure/logger:

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

setLogLevel("info");

Langkah berikutnya

Berikan Umpan Balik

Jika Anda mengalami bug atau memiliki saran, silakan buka masalah.

Contributing

Jika Anda ingin berkontribusi ke library ini, silakan baca panduan contributor untuk mempelajari lebih lanjut cara membuat dan menguji kode.