共用方式為


InteractiveBrowserCredentialInBrowserOptions interface

定義 InteractiveBrowserCredential 類別的通用選項。

Extends

屬性

clientId

租用戶中應用程式註冊的用戶端(應用程式)標識碼。 瀏覽器上需要此參數。

loginHint

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

loginStyle

指定是否應該使用重新導向或彈出視窗來起始使用者驗證流程。 可能的值為瀏覽器的「重新導向」或「快顯」或「預設」,以及節點的「快顯」(預設值)。

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"。

disableAutomaticAuthentication

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

disableInstanceDiscovery

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

httpClient

將用來傳送 HTTP 要求的 HttpClient。

loggingOptions

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

proxyOptions

設定連出要求 Proxy 的選項。

redirectOptions

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

retryOptions

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

telemetryOptions

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

tlsOptions

設定 TLS 驗證的選項

userAgentOptions

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

屬性詳細資料

clientId

租用戶中應用程式註冊的用戶端(應用程式)標識碼。 瀏覽器上需要此參數。

clientId: string

屬性值

string

loginHint

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

loginHint?: string

屬性值

string

loginStyle

指定是否應該使用重新導向或彈出視窗來起始使用者驗證流程。 可能的值為瀏覽器的「重新導向」或「快顯」或「預設」,以及節點的「快顯」(預設值)。

loginStyle?: BrowserLoginStyle

屬性值

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

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

userAgentOptions

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

userAgentOptions?: UserAgentPolicyOptions

屬性值

繼承自InteractiveCredentialOptions.userAgentOptions