EnvironmentCredential class
啟用驗證,以使用用戶端密碼或憑證,或作為使用者名稱和密碼的使用者,來Microsoft Entra 標識符。
建構函式
Environment |
建立 EnvironmentCredential 類別的實例,並根據可用的環境變數決定要使用的認證。 必要的環境變數:
如果設定AZURE_TENANT_ID,您也可以設定其他允許的租使用者
用戶端認證驗證的環境變數:
或者,使用者可以為使用者名稱和密碼驗證提供環境變數:
如果遺漏執行驗證所需的環境變數,則會擲回 CredentialUnavailableError。 如果驗證失敗,或發生未知的錯誤,則會擲回 AuthenticationError。 |
方法
get |
使用 Microsoft Entra 識別碼進行驗證,並在成功時傳回存取令牌。 |
建構函式詳細資料
EnvironmentCredential(EnvironmentCredentialOptions)
建立 EnvironmentCredential 類別的實例,並根據可用的環境變數決定要使用的認證。
必要的環境變數:
-
AZURE_TENANT_ID
:Microsoft Entra 租使用者 (目錄) 識別碼。 -
AZURE_CLIENT_ID
:租用戶中應用程式註冊的用戶端(應用程式)標識碼。
如果設定AZURE_TENANT_ID,您也可以設定其他允許的租使用者
-
AZURE_ADDITIONALLY_ALLOWED_TENANTS
:針對多租使用者應用程式,指定認證可能會取得具有單一分號分隔字串之令牌的其他租使用者。 使用 * 允許所有租使用者。
用戶端認證驗證的環境變數:
-
AZURE_CLIENT_SECRET
:針對應用程式註冊所產生的客戶端密碼。 -
AZURE_CLIENT_CERTIFICATE_PATH
:驗證期間要使用的 PEM 憑證路徑,而不是客戶端密碼。 -
AZURE_CLIENT_CERTIFICATE_PASSWORD
:憑證檔案的密碼(選擇性) 。 -
AZURE_CLIENT_SEND_CERTIFICATE_CHAIN
:( 選擇性)表示憑證鏈結應該設定在 x5c 標頭中,以支援主體名稱/簽發者型驗證。
或者,使用者可以為使用者名稱和密碼驗證提供環境變數:
-
AZURE_USERNAME
:要驗證的用戶名稱。 -
AZURE_PASSWORD
:用來驗證的密碼。
如果遺漏執行驗證所需的環境變數,則會擲回 CredentialUnavailableError。 如果驗證失敗,或發生未知的錯誤,則會擲回 AuthenticationError。
new EnvironmentCredential(options?: EnvironmentCredentialOptions)
參數
- options
- EnvironmentCredentialOptions
設定發出驗證要求的客戶端的選項。
方法詳細資料
getToken(string | string[], GetTokenOptions)
使用 Microsoft Entra 識別碼進行驗證,並在成功時傳回存取令牌。
function getToken(scopes: string | string[], options?: GetTokenOptions): Promise<AccessToken>
參數
- scopes
-
string | string[]
令牌將具有存取權的範圍清單。
- options
- GetTokenOptions
選擇性參數。 請參閱 GetTokenOptions。
傳回
Promise<AccessToken>