Plugin Identitas Azure untuk Persistensi Cache Token
Paket ini menyediakan plugin ke pustaka Azure Identity 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.
Memulai
import { useIdentityPlugin } from "@azure/identity";
import { cachePersistencePlugin } from "@azure/identity-cache-persistence";
useIdentityPlugin(cachePersistencePlugin);
Prasyarat
Instal paketnya
Paket ini dirancang untuk digunakan dengan Azure Identity for JavaScript. Instal dan @azure/identity
paket ini menggunakan npm
:
$ npm install --save @azure/identity
$ npm install --save @azure/identity-cache-persistence
Lingkungan yang Didukung
Plugin Azure Identity untuk JavaScript mendukung versi Node.js stabil (bahkan bernomor) mulai dari v12. Meskipun plugin dapat berjalan di versi Node lainnya, tidak ada dukungan yang dijamin.
@azure/identity-cache-persistence
tidak mendukung lingkungan browser.
Konsep utama
Jika ini pertama kalinya Anda menggunakan @azure/identity
atau platform identitas Microsoft (Azure Active Directory), sebaiknya Anda membaca Menggunakan @azure/identity
dengan Platform Identitas Microsoft terlebih dahulu. Dokumen ini akan memberi Anda pemahaman yang lebih mendalam tentang platform dan cara mengonfigurasi akun Azure Anda dengan benar.
Plugin Identitas Azure
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 tingkat useIdentityPlugin
atas dari @azure/identity
paket. 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 didaftarkan ke @azure/identity
paket dan akan tersedia di semua kredensial yang mendukung penembolokan token persisten (yang memiliki tokenCachePersistenceOptions
dalam opsi konstruktor mereka).
Contoh
Setelah plugin terdaftar, Anda dapat mengaktifkan persistensi cache token dengan meneruskan tokenCachePersistenceOptions
properti yang enabled
diatur ke true
konstruktor kredensial. Dalam contoh berikut, kami menggunakan DeviceCodeCredential
, karena penembolokan token persisten memungkinkan Anda untuk melewati alur autentikasi kode perangkat interaktif jika token yang di-cache tersedia.
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);
});
Pemecahan Masalah
Pencatatan
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 menemukan bug atau memiliki saran, buka masalah.
Berkontribusi
Jika Anda ingin berkontribusi pada pustaka ini, baca panduan berkontribusi untuk mempelajari selengkapnya tentang cara membuat dan menguji kode.
Azure SDK for JavaScript