MicrosoftIdentityAuthenticationException Klasa

Definicja

public class MicrosoftIdentityAuthenticationException : Exception

type MicrosoftIdentityAuthenticationException = class
    inherit Exception

Public Class MicrosoftIdentityAuthenticationException
Inherits Exception

Dziedziczenie

Exception

MicrosoftIdentityAuthenticationException

Przykłady

Typowy wzorzec obsługi wyjątków:

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

Uwagi

Ten wyjątek jest zwykle zgłaszany w następujących scenariuszach:

• Żadne opcje uwierzytelniania nie są skonfigurowane (ani domyślne, ani na żądanie)
• W opcjach uwierzytelniania nie określono żadnych zakresów
• Pozyskiwanie tokenu kończy się niepowodzeniem z powodu problemów z dostawcą uwierzytelniania

Uwaga dotycząca obsługi wyzwań WWW-Authenticate: Gdy podrzędny interfejs API zwraca odpowiedź 401 Brak autoryzacji z nagłówkiem WWW-Authenticate zawierającym dodatkowe oświadczenia (np. w przypadku dostępu warunkowego), program obsługi automatycznie wyodrębnia te oświadczenia przy użyciu polecenia WwwAuthenticateParameters i próbuje uzyskać nowy token z żądanymi oświadczeniami. Jeśli to automatyczne ponowienie próby powiedzie się, nie zostanie zgłoszony wyjątek. Jeśli ponowna próba również zakończy się niepowodzeniem z błędem 401, odpowiedź zostanie zwrócona do wywołującego bez zgłaszania wyjątku — obiekt wywołujący powinien sprawdzić kod stanu. Wyjątki są zgłaszane tylko w przypadku niepowodzeń pozyskiwania tokenu, a nie samych odpowiedzi HTTP 401.

Podczas obsługi tego wyjątku Message sprawdź właściwość, aby uzyskać szczegółowe informacje o przyczynie niepowodzenia uwierzytelniania. Jeśli występuje wyjątek wewnętrzny, może zawierać dodatkowe informacje od bazowego dostawcy uwierzytelniania.

Zobacz też

• MicrosoftIdentityMessageHandler
• MicrosoftIdentityMessageHandlerOptions