共用方式為


InteractiveBrowserCredentialNodeOptions interface

定義 InteractiveBrowserCredential 類別的通用選項。

Extends

屬性

clientId

使用者將登入之Microsoft Entra 應用程式的用戶端標識碼。 建議開發人員註冊其應用程式,並指派適當的角色。 如需詳細資訊,請瀏覽 https://aka.ms/identity/AppRegistrationAndRoleAssignment。 如果未指定,使用者將會向 Azure 開發應用程式進行驗證,不建議用於生產案例。

loginHint

loginHint 可預先選取使用者名稱以供互動式登入使用。 設定此選項會略過帳戶選取提示,並立即嘗試使用指定的帳戶登入。

redirectUri

取得應用程式的重新導向 URI。 這應該與應用程式註冊入口網站中的值相同。 預設為 window.location.href。 Node.js不再需要此欄位。

tenantId

Microsoft Entra 租使用者 (目錄) 識別符。

繼承的屬性

additionallyAllowedTenants

針對多租使用者應用程式,指定認證可取得令牌的其他租使用者。 新增通配符值 「*」 以允許認證取得安裝應用程式之任何租使用者的令牌。

additionalPolicies

要包含在 HTTP 管線中的其他原則。

allowInsecureConnection

如果要求是透過 HTTP 而不是 HTTPS 傳送,則設定為 true

authenticationRecord

先前驗證的結果,可用來擷取每個個別帳戶的快取認證。 如果應用程式想要針對每個用戶端標識碼和租使用者標識碼組使用一個以上的帳戶,則需要提供此專案。

呼叫認證的 authenticate() 方法,即可擷取此記錄,如下所示:

const authenticationRecord = await credential.authenticate();
authorityHost

要用於驗證要求的授權單位主機。 可能的值可透過 AzureAuthorityHosts取得。 預設值為 「https://login.microsoftonline.com"。

brokerOptions

使用 InteractiveBrowserCredential 時允許訊息代理程式驗證的選項

browserCustomizationOptions

瀏覽器自定義的共享組態選項

disableAutomaticAuthentication

如果需要手動驗證,會擲回 getToken。 開發人員必須呼叫 authenticate(),以控制手動驗證的時機。

disableInstanceDiscovery

欄位會決定在嘗試驗證時是否執行實例探索。 將此設定為 true 會完全停用實例探索和授權單位驗證。 因此,請務必確保已設定的授權單位主機有效且值得信任。 這項功能適用於無法連線到元數據端點的案例,例如在私人雲端或 Azure Stack 中。 實例探索的程式需要從 https://login.microsoft.com/ 擷取授權單位元數據來驗證授權單位。

httpClient

將用來傳送 HTTP 要求的 HttpClient。

loggingOptions

允許使用者設定記錄原則選項的設定、允許記錄帳戶資訊和客戶支援的個人標識資訊。

proxyOptions

設定連出要求 Proxy 的選項。

redirectOptions

如何處理重新導向響應的選項。

retryOptions

控制如何重試失敗要求的選項。

telemetryOptions

將一般遙測和追蹤資訊設定為傳出要求的選項。

tlsOptions

設定 TLS 驗證的選項

tokenCachePersistenceOptions

儲存認證時,提供給持續性層的選項(如果有的話)。

您必須先註冊持續性提供者外掛程式。 請參閱 NPM 上的 @azure/identity-cache-persistence 套件。

例:

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

useIdentityPlugin(cachePersistencePlugin);
const credential = new DeviceCodeCredential({
  tokenCachePersistenceOptions: {
    enabled: true,
  },
});
userAgentOptions

將使用者代理程式詳細數據新增至傳出要求的選項。

屬性詳細資料

clientId

使用者將登入之Microsoft Entra 應用程式的用戶端標識碼。 建議開發人員註冊其應用程式,並指派適當的角色。 如需詳細資訊,請瀏覽 https://aka.ms/identity/AppRegistrationAndRoleAssignment。 如果未指定,使用者將會向 Azure 開發應用程式進行驗證,不建議用於生產案例。

clientId?: string

屬性值

string

loginHint

loginHint 可預先選取使用者名稱以供互動式登入使用。 設定此選項會略過帳戶選取提示,並立即嘗試使用指定的帳戶登入。

loginHint?: string

屬性值

string

redirectUri

取得應用程式的重新導向 URI。 這應該與應用程式註冊入口網站中的值相同。 預設為 window.location.href。 Node.js不再需要此欄位。

redirectUri?: string | () => string

屬性值

string | () => string

tenantId

Microsoft Entra 租使用者 (目錄) 識別符。

tenantId?: string

屬性值

string

繼承的屬性詳細資料

additionallyAllowedTenants

針對多租使用者應用程式,指定認證可取得令牌的其他租使用者。 新增通配符值 「*」 以允許認證取得安裝應用程式之任何租使用者的令牌。

additionallyAllowedTenants?: string[]

屬性值

string[]

繼承自InteractiveCredentialOptions.additionallyAllowedTenants

additionalPolicies

要包含在 HTTP 管線中的其他原則。

additionalPolicies?: AdditionalPolicyConfig[]

屬性值

繼承自InteractiveCredentialOptions.additionalPolicies

allowInsecureConnection

如果要求是透過 HTTP 而不是 HTTPS 傳送,則設定為 true

allowInsecureConnection?: boolean

屬性值

boolean

繼承自InteractiveCredentialOptions.allowInsecureConnection

authenticationRecord

先前驗證的結果,可用來擷取每個個別帳戶的快取認證。 如果應用程式想要針對每個用戶端標識碼和租使用者標識碼組使用一個以上的帳戶,則需要提供此專案。

呼叫認證的 authenticate() 方法,即可擷取此記錄,如下所示:

const authenticationRecord = await credential.authenticate();
authenticationRecord?: AuthenticationRecord

屬性值

繼承自InteractiveCredentialOptions.authenticationRecord

authorityHost

要用於驗證要求的授權單位主機。 可能的值可透過 AzureAuthorityHosts取得。 預設值為 「https://login.microsoftonline.com"。

authorityHost?: string

屬性值

string

繼承自InteractiveCredentialOptions.authorityHost

brokerOptions

使用 InteractiveBrowserCredential 時允許訊息代理程式驗證的選項

brokerOptions?: BrokerOptions

屬性值

繼承自BrokerAuthOptions.brokerOptions

browserCustomizationOptions

瀏覽器自定義的共享組態選項

browserCustomizationOptions?: { errorMessage?: string, successMessage?: string }

屬性值

{ errorMessage?: string, successMessage?: string }

繼承自BrowserCustomizationOptions.browserCustomizationOptions

disableAutomaticAuthentication

如果需要手動驗證,會擲回 getToken。 開發人員必須呼叫 authenticate(),以控制手動驗證的時機。

disableAutomaticAuthentication?: boolean

屬性值

boolean

繼承自InteractiveCredentialOptions.disableAutomaticAuthentication

disableInstanceDiscovery

欄位會決定在嘗試驗證時是否執行實例探索。 將此設定為 true 會完全停用實例探索和授權單位驗證。 因此,請務必確保已設定的授權單位主機有效且值得信任。 這項功能適用於無法連線到元數據端點的案例,例如在私人雲端或 Azure Stack 中。 實例探索的程式需要從 https://login.microsoft.com/ 擷取授權單位元數據來驗證授權單位。

disableInstanceDiscovery?: boolean

屬性值

boolean

繼承自InteractiveCredentialOptions.disableInstanceDiscovery

httpClient

將用來傳送 HTTP 要求的 HttpClient。

httpClient?: HttpClient

屬性值

繼承自InteractiveCredentialOptions.HTTPClient

loggingOptions

允許使用者設定記錄原則選項的設定、允許記錄帳戶資訊和客戶支援的個人標識資訊。

loggingOptions?: LogPolicyOptions & { allowLoggingAccountIdentifiers?: boolean, enableUnsafeSupportLogging?: boolean }

屬性值

LogPolicyOptions & { allowLoggingAccountIdentifiers?: boolean, enableUnsafeSupportLogging?: boolean }

繼承自InteractiveCredentialOptions.loggingOptions

proxyOptions

設定連出要求 Proxy 的選項。

proxyOptions?: ProxySettings

屬性值

繼承自InteractiveCredentialOptions.proxyOptions

redirectOptions

如何處理重新導向響應的選項。

redirectOptions?: RedirectPolicyOptions

屬性值

繼承自InteractiveCredentialOptions.redirectOptions

retryOptions

控制如何重試失敗要求的選項。

retryOptions?: PipelineRetryOptions

屬性值

繼承自InteractiveCredentialOptions.retryOptions

telemetryOptions

將一般遙測和追蹤資訊設定為傳出要求的選項。

telemetryOptions?: TelemetryOptions

屬性值

繼承自InteractiveCredentialOptions.telemetryOptions

tlsOptions

設定 TLS 驗證的選項

tlsOptions?: TlsSettings

屬性值

繼承自InteractiveCredentialOptions.tlsOptions

tokenCachePersistenceOptions

儲存認證時,提供給持續性層的選項(如果有的話)。

您必須先註冊持續性提供者外掛程式。 請參閱 NPM 上的 @azure/identity-cache-persistence 套件。

例:

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

useIdentityPlugin(cachePersistencePlugin);
const credential = new DeviceCodeCredential({
  tokenCachePersistenceOptions: {
    enabled: true,
  },
});
tokenCachePersistenceOptions?: TokenCachePersistenceOptions

屬性值

繼承自CredentialPersistenceOptions.tokenCachePersistenceOptions

userAgentOptions

將使用者代理程式詳細數據新增至傳出要求的選項。

userAgentOptions?: UserAgentPolicyOptions

屬性值

繼承自InteractiveCredentialOptions.userAgentOptions