GetAuthorizationRequestUrlParameterBuilder 類別

注意：AbstractAcquireTokenParameterBuilder 中的幾個方法（例如 account）在這裡不太合理。 我們是否想建立一個包含所有常見方法的基礎，然後再建立一個只用於 AcquireToken 的帳號等基礎？

注意：AbstractAcquireTokenParameterBuilder 中的幾個方法（例如 account）在這裡不太合理。 我們是否想建立一個包含所有常見方法的基礎，然後再建立一個只用於 AcquireToken 的帳號等基礎？

驗證 AcquireToken 操作的參數。

注意：AbstractAcquireTokenParameterBuilder 中的幾個方法（例如 account）在這裡不太合理。 我們是否想建立一個包含所有常見方法的基礎，然後再建立一個只用於 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 備份認證系統作為 AAD 備份運作。 這將為 AAD 備份認證系統提供路由提示，幫助提升認證效能。 用這個 API 建立的提示會優先於用 API 建立的提示 WithLoginHint(String)

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

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

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

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

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

注意：AbstractAcquireTokenParameterBuilder 中的幾個方法（例如 account）在這裡不太合理。 我們是否想建立一個包含所有常見方法的基礎，然後再建立一個只用於 AcquireToken 的帳號等基礎？

注意：AbstractAcquireTokenParameterBuilder 中的幾個方法（例如 account）在這裡不太合理。 我們是否想建立一個包含所有常見方法的基礎，然後再建立一個只用於 AcquireToken 的帳號等基礎？

用於透過 Proof of Key for Code Exchange（PKCE）來確保授權碼授予。 欲了解更多資訊，請參閱PKCE區域資源基金： https://tools.ietf.org/html/rfc7636

指定使用者的互動體驗。

修改代幣取得請求，使所取得的代幣成為持有證明代幣（PoP），而非持有人代幣。 PoP 標記類似持有憑證，但綁定於 HTTP 請求及密碼金鑰，MSAL 可在 Windows 上管理。 請參閱 https://aka.ms/msal-net-pop

設定重定向 URI 以加入授權請求 URL

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

修改請求以取得簽署 HTTP 請求（SHR）擁有證明（PoP）令牌，而非承載者。 SHR PoP 標記綁定於 HTTP 請求及密碼金鑰，MSAL 在 Windows 上管理該金鑰。 SHR PoP 令牌與用於互助 TLS（mTLS）認證的 mTLS PoP 令牌不同。 如需詳細資訊，請參閱 https://aka.ms/mtls-pop。

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

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

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

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

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

以 attributeTokensattribute_tokens Body 參數發送，並將它們包含在快取鍵中。 空/空/留白條目會被忽略;空集合或空集合是 no-op。

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

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

指定客戶端提出的權利要求，包含在令牌請求中。 與 WithClaims(String) （伺服器發出的理賠挑戰）不同，客戶端理賠取得的權杖 會被快取， 快取項目則以理賠值為鍵。 不同的理賠值會產生獨立的快取條目。 使用穩定且非動態的值以避免快取無限成長。

在 token 請求中加入額外的 body 參數。 這些參數會加入快取金鑰，以將這些參數與所取得的代幣關聯起來。 適用於機密客戶流程（AcquireTokenForClient、AcquireTokenOnBehalfOf、AcquireTokenByAuthorizationCode）。

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

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

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

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

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