MicrosoftIdentityAuthenticationException Klasse

Definition

public class MicrosoftIdentityAuthenticationException : Exception

type MicrosoftIdentityAuthenticationException = class
    inherit Exception

Public Class MicrosoftIdentityAuthenticationException
Inherits Exception

Vererbung

Exception

MicrosoftIdentityAuthenticationException

Beispiele

Typisches Ausnahmebehandlungsmuster:

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);
}

Hinweise

Diese Ausnahme wird in der Regel in den folgenden Szenarien ausgelöst:

• Es sind keine Authentifizierungsoptionen konfiguriert (weder Standard noch pro Anforderung)
• In den Authentifizierungsoptionen sind keine Bereiche angegeben.
• Tokenerwerb schlägt aufgrund von Authentifizierungsanbieterproblemen fehl

Hinweis zu WWW-Authenticate Problembehandlung: Wenn eine nachgeschaltete API eine 401 Nicht autorisierte Antwort mit einem WWW-Authenticate Header zurückgibt, der zusätzliche Ansprüche enthält (z. B. für bedingten Zugriff), extrahiert der Handler diese Ansprüche automatisch mithilfe WwwAuthenticateParameters und versucht, ein neues Token mit den angeforderten Ansprüchen zu erwerben. Wenn diese automatische Wiederholung erfolgreich ist, wird keine Ausnahme ausgelöst. Wenn der Wiederholungsversuche auch mit einer 401 fehlschlägt, wird die Antwort an den Aufrufer zurückgegeben, ohne eine Ausnahme auszuwerfen . Der Aufrufer sollte den Statuscode überprüfen. Ausnahmen werden nur für Tokenerwerbsfehler ausgelöst, nicht für HTTP 401-Antworten selbst.

Überprüfen Sie bei der Behandlung dieser Ausnahme die Message Eigenschaft auf spezifische Details darüber, was den Authentifizierungsfehler verursacht hat. Wenn eine innere Ausnahme vorhanden ist, kann sie zusätzliche Informationen vom zugrunde liegenden Authentifizierungsanbieter enthalten.

Weitere Informationen

• MicrosoftIdentityMessageHandler
• MicrosoftIdentityMessageHandlerOptions