Bagikan melalui

DeviceCodeCredential class

Paket:
@azure/identity

Mengaktifkan autentikasi ke ID Microsoft Entra menggunakan kode perangkat yang dapat dimasukkan pengguna ke https://microsoft.com/devicelogin.

Konstruktor

DeviceCodeCredential(DeviceCodeCredentialOptions)

Membuat instans DeviceCodeCredential dengan detail yang diperlukan untuk memulai alur otorisasi kode perangkat dengan ID Microsoft Entra.

Pesan akan dicatat, memberi pengguna kode yang dapat mereka gunakan untuk mengautentikasi setelah mereka masuk ke https://microsoft.com/devicelogin

Pengembang dapat mengonfigurasi bagaimana pesan ini ditampilkan dengan meneruskan userPromptCallbackkustom :

import { DeviceCodeCredential } from "@azure/identity";

const credential = new DeviceCodeCredential({
  tenantId: process.env.AZURE_TENANT_ID,
  clientId: process.env.AZURE_CLIENT_ID,
  userPromptCallback: (info) => {
    console.log("CUSTOMIZED PROMPT CALLBACK", info.message);
  },
});

Metode

authenticate(string | string[], GetTokenOptions)

Mengautentikasi dengan ID Microsoft Entra dan mengembalikan token akses jika berhasil. Jika autentikasi gagal, CredentialUnavailableError akan dilemparkan dengan detail kegagalan.

Jika token tidak dapat diambil secara diam-diam, metode ini akan selalu menghasilkan tantangan bagi pengguna.
getToken(string | string[], GetTokenOptions)

Mengautentikasi dengan ID Microsoft Entra dan mengembalikan token akses jika berhasil. Jika autentikasi gagal, CredentialUnavailableError akan dilemparkan dengan detail kegagalan.

Jika pengguna memberikan opsi disableAutomaticAuthentication, setelah token tidak dapat diambil secara diam-diam, metode ini tidak akan mencoba meminta interaksi pengguna untuk mengambil token.

Detail Konstruktor

DeviceCodeCredential(DeviceCodeCredentialOptions)

Membuat instans DeviceCodeCredential dengan detail yang diperlukan untuk memulai alur otorisasi kode perangkat dengan ID Microsoft Entra.

Pesan akan dicatat, memberi pengguna kode yang dapat mereka gunakan untuk mengautentikasi setelah mereka masuk ke https://microsoft.com/devicelogin

Pengembang dapat mengonfigurasi bagaimana pesan ini ditampilkan dengan meneruskan userPromptCallbackkustom :

import { DeviceCodeCredential } from "@azure/identity";

const credential = new DeviceCodeCredential({
  tenantId: process.env.AZURE_TENANT_ID,
  clientId: process.env.AZURE_CLIENT_ID,
  userPromptCallback: (info) => {
    console.log("CUSTOMIZED PROMPT CALLBACK", info.message);
  },
});

new DeviceCodeCredential(options?: DeviceCodeCredentialOptions)

Parameter

options
DeviceCodeCredentialOptions

Opsi untuk mengonfigurasi klien yang membuat permintaan autentikasi.

Detail Metode

authenticate(string | string[], GetTokenOptions)

Mengautentikasi dengan ID Microsoft Entra dan mengembalikan token akses jika berhasil. Jika autentikasi gagal, CredentialUnavailableError akan dilemparkan dengan detail kegagalan.

Jika token tidak dapat diambil secara diam-diam, metode ini akan selalu menghasilkan tantangan bagi pengguna.

function authenticate(scopes: string | string[], options?: GetTokenOptions): Promise<undefined | AuthenticationRecord>

Parameter

scopes

string | string[]

Daftar cakupan yang tokennya akan memiliki akses.

options
GetTokenOptions

Opsi yang digunakan untuk mengonfigurasi permintaan apa pun yang mungkin dibuat oleh implementasi TokenCredential ini.

Mengembalikan

Promise<undefined | AuthenticationRecord>

getToken(string | string[], GetTokenOptions)

Mengautentikasi dengan ID Microsoft Entra dan mengembalikan token akses jika berhasil. Jika autentikasi gagal, CredentialUnavailableError akan dilemparkan dengan detail kegagalan.

Jika pengguna memberikan opsi disableAutomaticAuthentication, setelah token tidak dapat diambil secara diam-diam, metode ini tidak akan mencoba meminta interaksi pengguna untuk mengambil token.

function getToken(scopes: string | string[], options?: GetTokenOptions): Promise<AccessToken>

Parameter

scopes

string | string[]

Daftar cakupan yang tokennya akan memiliki akses.

options
GetTokenOptions

Opsi yang digunakan untuk mengonfigurasi permintaan apa pun yang mungkin dibuat oleh implementasi TokenCredential ini.

Mengembalikan

Promise<AccessToken>