AcquireTokenInteractiveParameterBuilder 類別
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
互動式代幣請求的建構器。 請參閱 https://aka.ms/msal-net-acquire-token-interactively
public sealed class AcquireTokenInteractiveParameterBuilder : Microsoft.Identity.Client.AbstractPublicClientAcquireTokenParameterBuilder<Microsoft.Identity.Client.AcquireTokenInteractiveParameterBuilder>type AcquireTokenInteractiveParameterBuilder = class
inherit AbstractPublicClientAcquireTokenParameterBuilder<AcquireTokenInteractiveParameterBuilder>Public NotInheritable Class AcquireTokenInteractiveParameterBuilder
Inherits AbstractPublicClientAcquireTokenParameterBuilder(Of AcquireTokenInteractiveParameterBuilder)- 繼承
-
AcquireTokenInteractiveParameterBuilder
方法
| 名稱 | Description |
|---|---|
| ExecuteAsync() |
非同步執行 Token 請求。 (繼承來源 BaseAbstractAcquireTokenParameterBuilder<T>) |
| ExecuteAsync(CancellationToken) |
以非同步方式執行 Token 請求，並有可能取消非同步方法。 (繼承來源 AbstractPublicClientAcquireTokenParameterBuilder<T>) |
| Validate() |
驗證 AcquireToken 操作的參數。 (繼承來源 BaseAbstractAcquireTokenParameterBuilder<T>) |
| WithAccount(IAccount) |
設定將要取回該令牌的帳戶。 此方法與 WithLoginHint(String)互斥。 若兩者同時使用，則會拋出例外 |
| WithAdfsAuthority(String, Boolean) |
新增一個已知的權威，對應於 ADFS 伺服器。 參見 https://aka.ms/msal-net-adfs。 (繼承來源 AbstractAcquireTokenParameterBuilder<T>) |
| WithAuthority(AadAuthorityAudience, Boolean) |
已淘汰.
重要提示：請使用 withTenantID 或 WithTenantIdFromAuthority，或 B2CAuthority 以表示 B2C 權威。 為登入使用者新增已知的 Azure AD 權限，指定登入受眾（雲端為 Azure 公共雲）。 參見 https://aka.ms/msal-net-application-configuration。 (繼承來源 AbstractAcquireTokenParameterBuilder<T>) |
| WithAuthority(AzureCloudInstance, AadAuthorityAudience, Boolean) |
已淘汰.
為應用程式新增已知的 Azure AD 權限，讓使用者登入時指定雲端實例及登入對象。 參見 https://aka.ms/msal-net-application-configuration。 (繼承來源 AbstractAcquireTokenParameterBuilder<T>) |
| WithAuthority(AzureCloudInstance, Guid, Boolean) |
已淘汰.
重要提示：請使用 withTenantID 或 WithTenantIdFromAuthority，或 B2CAuthority 以表示 B2C 權威。 為應用程式新增一個已知的 Azure AD 權限，讓單一組織（單一租戶應用程式）的使用者登入，該權限由其雲端實例和租戶 ID 描述。 參見 https://aka.ms/msal-net-application-configuration。 (繼承來源 AbstractAcquireTokenParameterBuilder<T>) |
| WithAuthority(AzureCloudInstance, String, Boolean) |
已淘汰.
重要提示：請使用 withTenantID 或 WithTenantIdFromAuthority，或 B2CAuthority 以表示 B2C 權威。 為應用程式新增一個已知的 Azure AD 權限，讓單一組織（單一租戶應用程式）的使用者登入，該組織由其雲端實例及網域名稱或租戶 ID 描述。 參見 https://aka.ms/msal-net-application-configuration。 (繼承來源 AbstractAcquireTokenParameterBuilder<T>) |
| WithAuthority(String, Boolean) |
已淘汰.
重要提示：請使用 withTenantID 或 WithTenantIdFromAuthority，或 B2CAuthority 以表示 B2C 權威。 該代幣被請求的特定權限。 傳遞與應用程式建構器設定不同的值，會將選擇範圍縮小到特定租戶。 這不會改變應用程式中設定的值。 這適用於管理多個帳號的應用程式（例如擁有多個信箱的郵件客戶端）。 參見 https://aka.ms/msal-net-application-configuration。 (繼承來源 AbstractAcquireTokenParameterBuilder<T>) |
| WithAuthority(String, Guid, Boolean) |
已淘汰.
重要提示：請使用 withTenantID 或 WithTenantIdFromAuthority，或 B2CAuthority 以表示 B2C 權威。 為應用程式新增已知的 Azure AD 權限，讓單一組織（單一租戶應用程式）的使用者登入，該組織由租戶 ID 指定。 參見 https://aka.ms/msal-net-application-configuration。 (繼承來源 AbstractAcquireTokenParameterBuilder<T>) |
| WithAuthority(String, String, Boolean) |
已淘汰.
重要提示：請使用 withTenantID 或 WithTenantIdFromAuthority，或 B2CAuthority 以表示 B2C 權威。 為應用程式新增一個已知的 Azure AD 權限，讓使用者從單一組織（單一租戶應用程式）登入，該組織以網域名稱描述。 參見 https://aka.ms/msal-net-application-configuration。 (繼承來源 AbstractAcquireTokenParameterBuilder<T>) |
| WithB2CAuthority(String) |
新增一個已知的權威，對應於 Azure AD B2C 政策。 請參閱 https://aka.ms/msal-net-b2c-specificities (繼承來源 AbstractAcquireTokenParameterBuilder<T>) |
| WithClaims(String) |
在查詢中設定主張。 當 AAD 管理員啟用條件存取時使用。 取得該代幣通常會產生 屬性MsalUiRequiredExceptionClaims設定。 重新嘗試取得代幣，並用這個數值來計算 WithClaims(String) 方法。 詳情請參見https://aka.ms/msal-exceptionshttps://aka.ms/msal-net-claim-challenge。 (繼承來源 AbstractAcquireTokenParameterBuilder<T>) |
| WithCorrelationId(Guid) |
設定驗證請求中使用的相關 ID。 用於追蹤 SDK 與身份提供者服務日誌中的請求。 若未設定，則會隨機產生一個。 (繼承來源 BaseAbstractAcquireTokenParameterBuilder<T>) |
| WithEmbeddedWebViewOptions(EmbeddedWebViewOptions) |
指定使用嵌入式網頁檢視進行互動驗證的選項。 |
| WithExtraQueryParameters(Dictionary<String,String>) |
已淘汰.
為 HTTP 認證請求中的查詢字串設定額外的查詢參數。 (繼承來源 BaseAbstractAcquireTokenParameterBuilder<T>) |
| WithExtraQueryParameters(IDictionary<String,ValueTuple<String,Boolean>>) |
為 HTTP 認證請求中的查詢字串設定額外查詢參數，並控制快取金鑰中包含哪些參數 (繼承來源 BaseAbstractAcquireTokenParameterBuilder<T>) |
| WithExtraQueryParameters(String) |
已淘汰.
為 HTTP 認證請求中的查詢字串設定額外的查詢參數。 (繼承來源 AbstractAcquireTokenParameterBuilder<T>) |
| WithExtraScopesToConsent(IEnumerable<String>) |
互動式代幣請求的建構器。 請參閱 https://aka.ms/msal-net-acquire-token-interactively |
| WithLoginHint(String) |
設定 ， |
| WithParentActivityOrWindow(IntPtr) |
將 IntPtr 的參考設定為一個視窗，觸發瀏覽器被顯示。 用來將跳出視窗的瀏覽器置中。 如果設定了值，則會顯示螢幕中央或前景應用程式。 |
| WithParentActivityOrWindow(Object) |
設定 ViewController（若使用 iOS）、Activity（若使用 Android）、IWin32Window 或 IntPtr（若使用 .Net Framework）。 用於呼叫瀏覽器。 |
| WithPrompt(Prompt) |
明確定義使用者的互動體驗。 |
| WithProofOfPossession(String, HttpMethod, Uri) |
修改代幣取得請求，使所取得的代幣成為持有證明代幣（PoP），而非持有人代幣。 PoP 標記類似持有憑證，但綁定於 HTTP 請求及密碼金鑰，MSAL 可在 Windows 上管理。 請注意，請求 URI 中只有主機和路徑部分會被綁定。 請參閱 https://aka.ms/msal-net-pop |
| WithScopes(IEnumerable<String>) |
指定要請求哪些範圍。 此方法用於您的應用程式需要指定呼叫受保護 API 所需的作用域。 請參考 <see>https://docs.microsoft.com/azure/active-directory/develop/v2-permissions-and-consent</see> 了解更多關於作用範圍、權限與同意的資訊，以及<>https://docs.microsoft.com/azure/active-directory/develop/msal-v1-app-scopes<>如何為過去暴露 OAuth2 權限的舊有應用程式建立範圍。 (繼承來源 AbstractAcquireTokenParameterBuilder<T>) |
| WithSystemWebViewOptions(SystemWebViewOptions) |
指定使用系統作業系統瀏覽器處理互動式認證的選項。 |
| WithTenantId(String) |
覆蓋應用程式層級權限中指定的租戶 ID。 此操作會保留權威主機（環境）。 若應用程式層級未指定權限，預設使用的權限為 |
| WithTenantIdFromAuthority(Uri) |
從提供的權限 URI 中擷取租戶 ID，並在應用程式層級覆蓋權限中指定的租戶 ID。 此操作保留提供給應用程式建構者的權限主機（環境）。
若未提供授權給應用程式建構者，此方法將替換預設權限 |
| WithUseEmbeddedWebView(Boolean) |
規定公開用戶端應用程式應使用嵌入式網頁瀏覽器還是系統預設瀏覽器。 如果已設定好經紀人（WAM、Authenticator、公司入口網站），這個設定只會在未安裝經紀人時使用。 在 .NET 上，包括 net8-windows，應用程式開發者必須參考 Microsoft。Identity.Client.Desktop 並呼叫 PublicClientApplicationBuilder.WithDesktopFeatures（） 以啟用內嵌網頁瀏覽器。 |