InteractiveBrowserCredentialInBrowserOptions interface
定義 InteractiveBrowserCredential 類別的通用選項。
- Extends
屬性
client |
租用戶中應用程式註冊的用戶端(應用程式)標識碼。 瀏覽器上需要此參數。 |
login |
loginHint 可預先選取使用者名稱以供互動式登入使用。 設定此選項會略過帳戶選取提示,並立即嘗試使用指定的帳戶登入。 |
login |
指定是否應該使用重新導向或彈出視窗來起始使用者驗證流程。 可能的值為瀏覽器的「重新導向」或「快顯」或「預設」,以及節點的「快顯」(預設值)。 |
redirect |
取得應用程式的重新導向 URI。 這應該與應用程式註冊入口網站中的值相同。 預設為 |
tenant |
Microsoft Entra 租使用者 (目錄) 識別符。 |
繼承的屬性
additionally |
針對多租使用者應用程式,指定認證可取得令牌的其他租使用者。 新增通配符值 「*」 以允許認證取得安裝應用程式之任何租使用者的令牌。 |
additional |
要包含在 HTTP 管線中的其他原則。 |
allow |
如果要求是透過 HTTP 而不是 HTTPS 傳送,則設定為 true |
authentication |
先前驗證的結果,可用來擷取每個個別帳戶的快取認證。 如果應用程式想要針對每個用戶端標識碼和租使用者標識碼組使用一個以上的帳戶,則需要提供此專案。 呼叫認證的
|
authority |
要用於驗證要求的授權單位主機。 可能的值可透過 AzureAuthorityHosts取得。 預設值為 「https://login.microsoftonline.com"。 |
disable |
如果需要手動驗證,會擲回 getToken。
開發人員必須呼叫 |
disable |
欄位會決定在嘗試驗證時是否執行實例探索。
將此設定為 |
http |
將用來傳送 HTTP 要求的 HttpClient。 |
logging |
允許使用者設定記錄原則選項的設定、允許記錄帳戶資訊和客戶支援的個人標識資訊。 |
proxy |
設定連出要求 Proxy 的選項。 |
redirect |
如何處理重新導向響應的選項。 |
retry |
控制如何重試失敗要求的選項。 |
telemetry |
將一般遙測和追蹤資訊設定為傳出要求的選項。 |
tls |
設定 TLS 驗證的選項 |
user |
將使用者代理程式詳細數據新增至傳出要求的選項。 |
屬性詳細資料
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[]
additionalPolicies
要包含在 HTTP 管線中的其他原則。
additionalPolicies?: AdditionalPolicyConfig[]
屬性值
allowInsecureConnection
如果要求是透過 HTTP 而不是 HTTPS 傳送,則設定為 true
allowInsecureConnection?: boolean
屬性值
boolean
authenticationRecord
先前驗證的結果,可用來擷取每個個別帳戶的快取認證。 如果應用程式想要針對每個用戶端標識碼和租使用者標識碼組使用一個以上的帳戶,則需要提供此專案。
呼叫認證的 authenticate()
方法,即可擷取此記錄,如下所示:
const authenticationRecord = await credential.authenticate();
authenticationRecord?: AuthenticationRecord
屬性值
authorityHost
要用於驗證要求的授權單位主機。 可能的值可透過 AzureAuthorityHosts取得。 預設值為 「https://login.microsoftonline.com"。
authorityHost?: string
屬性值
string
disableAutomaticAuthentication
如果需要手動驗證,會擲回 getToken。
開發人員必須呼叫 authenticate()
,以控制手動驗證的時機。
disableAutomaticAuthentication?: boolean
屬性值
boolean
繼承自InteractiveCredentialOptions.disableAutomaticAuthentication
disableInstanceDiscovery
欄位會決定在嘗試驗證時是否執行實例探索。
將此設定為 true
會完全停用實例探索和授權單位驗證。
因此,請務必確保已設定的授權單位主機有效且值得信任。
這項功能適用於無法連線到元數據端點的案例,例如在私人雲端或 Azure Stack 中。
實例探索的程式需要從 https://login.microsoft.com/ 擷取授權單位元數據,以驗證授權單位。
disableInstanceDiscovery?: boolean
屬性值
boolean
httpClient
將用來傳送 HTTP 要求的 HttpClient。
httpClient?: HttpClient
屬性值
loggingOptions
允許使用者設定記錄原則選項的設定、允許記錄帳戶資訊和客戶支援的個人標識資訊。
loggingOptions?: LogPolicyOptions & { allowLoggingAccountIdentifiers?: boolean, enableUnsafeSupportLogging?: boolean }
屬性值
LogPolicyOptions & { allowLoggingAccountIdentifiers?: boolean, enableUnsafeSupportLogging?: boolean }
proxyOptions
設定連出要求 Proxy 的選項。
proxyOptions?: ProxySettings
屬性值
redirectOptions
如何處理重新導向響應的選項。
redirectOptions?: RedirectPolicyOptions
屬性值
retryOptions
控制如何重試失敗要求的選項。
retryOptions?: PipelineRetryOptions
屬性值
telemetryOptions
將一般遙測和追蹤資訊設定為傳出要求的選項。
telemetryOptions?: TelemetryOptions
屬性值
tlsOptions
userAgentOptions
將使用者代理程式詳細數據新增至傳出要求的選項。
userAgentOptions?: UserAgentPolicyOptions