共用方式為

DeviceCodeCredential class

  • 參考
套件:
@azure/identity

開啟驗證，以使用使用者可以輸入的裝置代碼來Microsoft Entra 識別碼 https://microsoft.com/devicelogin。

建構函式

DeviceCodeCredential(DeviceCodeCredentialOptions)

使用 Microsoft Entra ID 起始裝置程式代碼授權流程所需的詳細數據，建立 DeviceCodeCredential 的實例。

系統會記錄訊息，為使用者提供一個程式代碼，讓使用者在前往 https://microsoft.com/devicelogin 之後，就可以用來進行驗證

開發人員可以藉由傳遞自訂 userPromptCallback來設定此訊息的顯示方式：

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);
  },
});

方法

authenticate(string | string[], GetTokenOptions)

使用 Microsoft Entra 識別碼進行驗證，並在成功時傳回存取令牌。 如果驗證失敗，CredentialUnavailableError 將會擲回失敗的詳細數據。

如果無法以無訊息方式擷取令牌，此方法一律會為用戶產生挑戰。
getToken(string | string[], GetTokenOptions)

使用 Microsoft Entra 識別碼進行驗證，並在成功時傳回存取令牌。 如果驗證失敗，CredentialUnavailableError 將會擲回失敗的詳細數據。

如果使用者提供選項 disableAutomaticAuthentication，一旦無法以無訊息方式擷取令牌，此方法就不會嘗試要求用戶互動以擷取令牌。

建構函式詳細資料

DeviceCodeCredential(DeviceCodeCredentialOptions)

使用 Microsoft Entra ID 起始裝置程式代碼授權流程所需的詳細數據，建立 DeviceCodeCredential 的實例。

系統會記錄訊息，為使用者提供一個程式代碼，讓使用者在前往 https://microsoft.com/devicelogin 之後，就可以用來進行驗證

開發人員可以藉由傳遞自訂 userPromptCallback來設定此訊息的顯示方式：

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)

參數

options
DeviceCodeCredentialOptions

設定發出驗證要求之客戶端的選項。

方法詳細資料

authenticate(string | string[], GetTokenOptions)

使用 Microsoft Entra 識別碼進行驗證，並在成功時傳回存取令牌。 如果驗證失敗，CredentialUnavailableError 將會擲回失敗的詳細數據。

如果無法以無訊息方式擷取令牌，此方法一律會為用戶產生挑戰。

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

參數

scopes

string | string[]

令牌將具有存取權的範圍清單。

options
GetTokenOptions

用來設定此 TokenCredential 實作可能提出的任何要求的選項。

傳回

Promise<undefined | AuthenticationRecord>

getToken(string | string[], GetTokenOptions)

使用 Microsoft Entra 識別碼進行驗證，並在成功時傳回存取令牌。 如果驗證失敗，CredentialUnavailableError 將會擲回失敗的詳細數據。

如果使用者提供選項 disableAutomaticAuthentication，一旦無法以無訊息方式擷取令牌，此方法就不會嘗試要求用戶互動以擷取令牌。

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

參數

scopes

string | string[]

令牌將具有存取權的範圍清單。

options
GetTokenOptions

用來設定此 TokenCredential 實作可能提出的任何要求的選項。

傳回

Promise<AccessToken>