AcquireTokenByIntegratedWindowsAuthParameterBuilder 類別

非同步執行 Token 請求。

以非同步方式執行 Token 請求，並有可能取消非同步方法。

驗證 AcquireToken 操作的參數。

新增一個已知的權威，對應於 ADFS 伺服器。 參見 https://aka.ms/msal-net-adfs。

重要提示：請使用 withTenantID 或 WithTenantIdFromAuthority，或 B2CAuthority 以表示 B2C 權威。

為登入使用者新增已知的 Azure AD 權限，指定登入受眾（雲端為 Azure 公共雲）。 參見 https://aka.ms/msal-net-application-configuration。

為應用程式新增已知的 Azure AD 權限，讓使用者登入時指定雲端實例及登入對象。 參見 https://aka.ms/msal-net-application-configuration。

重要提示：請使用 withTenantID 或 WithTenantIdFromAuthority，或 B2CAuthority 以表示 B2C 權威。

為應用程式新增一個已知的 Azure AD 權限，讓單一組織（單一租戶應用程式）的使用者登入，該權限由其雲端實例和租戶 ID 描述。 參見 https://aka.ms/msal-net-application-configuration。

重要提示：請使用 withTenantID 或 WithTenantIdFromAuthority，或 B2CAuthority 以表示 B2C 權威。

為應用程式新增一個已知的 Azure AD 權限，讓單一組織（單一租戶應用程式）的使用者登入，該組織由其雲端實例及網域名稱或租戶 ID 描述。 參見 https://aka.ms/msal-net-application-configuration。

重要提示：請使用 withTenantID 或 WithTenantIdFromAuthority，或 B2CAuthority 以表示 B2C 權威。

該代幣被請求的特定權限。 傳遞與應用程式建構器設定不同的值，會將選擇範圍縮小到特定租戶。 這不會改變應用程式中設定的值。 這適用於管理多個帳號的應用程式（例如擁有多個信箱的郵件客戶端）。 參見 https://aka.ms/msal-net-application-configuration。

重要提示：請使用 withTenantID 或 WithTenantIdFromAuthority，或 B2CAuthority 以表示 B2C 權威。

為應用程式新增已知的 Azure AD 權限，讓單一組織（單一租戶應用程式）的使用者登入，該組織由租戶 ID 指定。 參見 https://aka.ms/msal-net-application-configuration。

重要提示：請使用 withTenantID 或 WithTenantIdFromAuthority，或 B2CAuthority 以表示 B2C 權威。

為應用程式新增一個已知的 Azure AD 權限，讓使用者從單一組織（單一租戶應用程式）登入，該組織以網域名稱描述。 參見 https://aka.ms/msal-net-application-configuration。

新增一個已知的權威，對應於 Azure AD B2C 政策。 請參閱 https://aka.ms/msal-net-b2c-specificities

在查詢中設定主張。 當 AAD 管理員啟用條件存取時使用。 取得該代幣通常會產生 屬性MsalUiRequiredExceptionClaims設定。 重新嘗試取得代幣，並用這個數值來計算 WithClaims(String) 方法。 詳情請參見https://aka.ms/msal-exceptionshttps://aka.ms/msal-net-claim-challenge。

設定驗證請求中使用的相關 ID。 用於追蹤 SDK 與身份提供者服務日誌中的請求。 若未設定，則會隨機產生一個。

為 HTTP 認證請求中的查詢字串設定額外的查詢參數。

為 HTTP 認證請求中的查詢字串設定額外查詢參數，並控制快取金鑰中包含哪些參數

為 HTTP 認證請求中的查詢字串設定額外的查詢參數。

讓 MSAL 能從所提供的輸入讀取 WS-Trust 交換的聯邦元資料，而非從端點取得。 這只適用於管理型 ADFS 帳戶。 參見 https://aka.ms/MsalFederationMetadata。

指定要請求哪些範圍。 此方法用於您的應用程式需要指定呼叫受保護 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 權限的舊有應用程式建立範圍。

覆蓋應用程式層級權限中指定的租戶 ID。 此操作會保留權威主機（環境）。

若應用程式層級未指定權限，預設使用的權限為 https://login.microsoftonline.com/common。

從提供的權限 URI 中擷取租戶 ID，並在應用程式層級覆蓋權限中指定的租戶 ID。 此操作保留提供給應用程式建構者的權限主機（環境）。 若未提供授權給應用程式建構者，此方法將替換預設權限 https://login.microsoftonline.com/common中的租戶 ID。

請指定使用者名稱。

介入請求管線，在 MSAL 提出權杖請求前執行使用者提供的代理。 代理者可透過新增或移除主體參數與標頭來修改請求有效載荷。 OnBeforeTokenRequestData

指定從認證回應中取得的額外參數，這些參數通常不包含在快取物件中，並用存取權杖快取。 這些值可從 AdditionalResponseParameters 參數讀取。

使用戶端應用程式能提供自訂的認證操作，用於憑證取得請求。

在不作為查詢參數的情況下，將鍵值對加入令牌快取金鑰。 利用此方法分割快取的標記（例如，將同一使用者的短命會話與一般會話隔離）。 AcquireTokenByAuthorizationCode兩者 和 AcquireTokenSilent 都必須使用相同的分割鍵來匹配快取的項目。

在不作為查詢參數的情況下，將鍵值對加入令牌快取金鑰。 利用此方法分割快取存取權杖（例如，將短命會話與同一使用者的常規會話隔離）。 AcquireTokenByAuthorizationCode兩者 和 AcquireTokenSilent 都必須使用相同的分割鍵來匹配快取的項目。

規定客戶主張中需包含的額外權利要求。 當客戶提出主張時，這些理賠將與違約理賠合併。 這讓像 Microsoft 這類更高層次的 API 能夠使用。Identity.Web 為客戶主張提供了額外的權利要求。 重要提示：代幣與額外的客戶端斷言聲明相關聯，這會影響快取查詢。 這是一個擴充性 API，應用程式不應直接使用。

為令牌請求新增額外的 Http 標頭。

在令牌請求中加入額外的 HTTP 標頭。

指定用於客戶端斷言的 FMI 路徑。 這讓像 Id.Web 這類高階 API 能提供對 FMI 敏感的憑證。 重要提示：憑證與憑證 FMI 路徑相關聯，影響快取查詢。這是擴充性 API，應用程式不應使用。

註冊一個代理，為 MSAL 為此代幣取得所發出的 OpenTelemetry 指標新增標籤（維度）。 當 MSAL 記錄其指標並接收 ExecutionResult 取得的指標（表示成功或失敗，包含結果或例外）以及可變的標籤清單時，代理會被呼叫。 附加在該清單上的標籤會附加在請求中記錄的每個指標上。

將標記綁定到快取中的金鑰。代幣上不會執行任何密碼學操作。