Plugin Identitas Azure untuk Persistensi Cache Token

Artikel
04/05/2023

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.

Kode sumber | Sampel

Memulai

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

useIdentityPlugin(cachePersistencePlugin);

Prasyarat

Langganan Azure.

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-persistencetidak 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.

Tayangan

Bagikan melalui