語言

MicrosoftIdentityAuthenticationException 類別

定義

當 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 並指定錯誤訊息。

適用於

另請參閱