MicrosoftIdentityAuthenticationException 類別
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
當 HTTP 訊息處理 MicrosoftIdentityMessageHandler過程中驗證失敗時,會拋出異常。
public class MicrosoftIdentityAuthenticationException : Exception
type MicrosoftIdentityAuthenticationException = class
inherit Exception
Public Class MicrosoftIdentityAuthenticationException
Inherits Exception
- 繼承
-
MicrosoftIdentityAuthenticationException
範例
典型的例外處理模式:
try
{
var response = await httpClient.SendAsync(request, cancellationToken);
response.EnsureSuccessStatusCode();
}
catch (MicrosoftIdentityAuthenticationException authEx)
{
// Handle authentication-specific failures
logger.LogError(authEx, "Authentication failed: {Message}", authEx.Message);
throw; // Re-throw or handle as appropriate
}
catch (HttpRequestException httpEx)
{
// Handle other HTTP-related failures
logger.LogError(httpEx, "HTTP request failed: {Message}", httpEx.Message);
}
備註
此例外通常出現在以下情境:
- 沒有設定任何認證選項(無論是預設還是每個請求)
- 認證選項中未指定範圍
- 憑證取得因認證提供者問題而失敗
關於 WWW-Authenticate 挑戰處理的說明: 當下游 API 回傳帶有包含額外申索的 WWW-Authenticate 標頭的 401 未授權回應(例如條件存取時),處理器會自動擷取這些申索 WwwAuthenticateParameters ,並嘗試取得包含請求申索的新權杖。 若此自動重試成功,則不予拋出例外。 如果重試也失敗且出現 401,回應會回傳給呼叫者且不會拋出例外——呼叫者應該檢查狀態碼。 例外僅在令牌取得失敗時拋出,HTTP 401 回應本身則不例外。
處理此例外時,請檢查 Message 該屬性以了解導致認證失敗的具體細節。 若存在內部例外,可能包含來自底層認證提供者的額外資訊。
建構函式
| 名稱 | Description |
|---|---|
| MicrosoftIdentityAuthenticationException(String, Exception) |
初始化類別的新實例 MicrosoftIdentityAuthenticationException ,並附上指定的錯誤訊息及導致該異常的內部例外的參考。 |
| MicrosoftIdentityAuthenticationException(String) |
初始化類別的新實例 MicrosoftIdentityAuthenticationException 並指定錯誤訊息。 |