Język

MsalUiRequiredException Klasa

Definicja

Ta klasa wyjątku polega na informowaniu deweloperów, że interakcja interfejsu użytkownika jest wymagana do pomyślnego uwierzytelnienia. Jest zgłaszany podczas wywoływania AcquireTokenSilent(IEnumerable<String>, IAccount) lub jednego z jego przesłonięć, a gdy token nie istnieje w pamięci podręcznej, lub użytkownik musi zapewnić więcej zawartości lub wykonać uwierzytelnianie wieloskładnikowe na podstawie zasad Azure AD itp. Aby uzyskać więcej informacji, zobacz https://aka.ms/msal-net-exceptions

public class MsalUiRequiredException : Microsoft.Identity.Client.MsalServiceException
type MsalUiRequiredException = class
    inherit MsalServiceException
Public Class MsalUiRequiredException
Inherits MsalServiceException
Dziedziczenie
MsalUiRequiredException
Pochodne

Konstruktory

Nazwisko Opis
MsalUiRequiredException(String, String, Exception, UiRequiredExceptionClassification)

Inicjuje nowe wystąpienie klasy wyjątków z określonym kodem błędu, komunikatem o błędzie i wyjątkiem wewnętrznym wskazującym główną przyczynę.

MsalUiRequiredException(String, String, Exception)

Inicjuje nowe wystąpienie klasy wyjątków z określonym kodem błędu, komunikatem o błędzie i wyjątkiem wewnętrznym wskazującym główną przyczynę.

MsalUiRequiredException(String, String)

Inicjuje nowe wystąpienie klasy wyjątków z określonym kodem błędu i komunikatem o błędzie.

Pola

Nazwisko Opis
AuthenticationResultMetadataKey

Klucz, w Data którym biblioteka MSAL przechowuje przechwycone dane, gdy pozyskiwanie AuthenticationResultMetadata tokenu kończy się niepowodzeniem, a nieMsalException. Umożliwia konsumentom podrzędnym uzyskiwanie tokenu diagnostyki, mimo że wyjątek źródłowy zostanie ponownie zgłoszony bez zmian.

(Odziedziczone po MsalException)
BrokerErrorCode

AdditionalExceptionData Klucz właściwości dostępny podczas korzystania z brokerów klasycznych.

(Odziedziczone po MsalException)
BrokerErrorContext

AdditionalExceptionData Klucz właściwości dostępny podczas korzystania z brokerów klasycznych.

(Odziedziczone po MsalException)
BrokerErrorStatus

AdditionalExceptionData Klucz właściwości dostępny podczas korzystania z brokerów klasycznych.

(Odziedziczone po MsalException)
BrokerErrorTag

AdditionalExceptionData Klucz właściwości dostępny podczas korzystania z brokerów klasycznych.

(Odziedziczone po MsalException)
BrokerTelemetry

AdditionalExceptionData Klucz właściwości dostępny podczas korzystania z brokerów klasycznych.

(Odziedziczone po MsalException)
ManagedIdentitySource

AdditionalExceptionData Klucz właściwości dostępny podczas korzystania z tożsamości zarządzanej.

(Odziedziczone po MsalException)

Właściwości

Nazwisko Opis
AdditionalExceptionData

Torba właściwości z dodatkowymi szczegółami dla tego wyjątku.

(Odziedziczone po MsalException)
AuthenticationResultMetadata

Metadane diagnostyczne dla nieudanej próby uzyskania tokenu — łączny czas trwania i czas trwania odpowiedniego etapu, czas trwania http/pamięci podręcznej, punkt końcowy tokenu i używany region. Dzieje się tak null , gdy wyjątek został zgłoszony przed rozpoczęciem zbierania metadanych przez potok żądania (na przykład weryfikacji parametru lub konstruktora). Gdy jest to błąd inny niż null — typowy błąd w żądaniu — DurationTotalInMs jest zawsze wypełniany (przydatny do pomiaru opóźnienia), podczas gdy inne pola mogą mieć wartość 0/null, gdy odpowiedni etap nie został uruchomiony. Na awarii TokenSource nie ma znaczącej wartości i nie należy polegać na. Ponownie używa typu zwracanego AuthenticationResultMetadata przez w ścieżce powodzenia.

(Odziedziczone po MsalException)
Claims

Dodatkowe oświadczenia żądane przez usługę. Jeśli ta właściwość nie ma wartości null lub jest pusta, oznacza to, że usługa wymaga od użytkownika podania dodatkowych oświadczeń, takich jak przeprowadzenie uwierzytelniania dwuskładnikowego. Oto dwa przypadki:

Aby uzyskać więcej informacji, zobacz https://aka.ms/msal-net-claim-challenge (Odziedziczone po MsalServiceException)
Classification

Klasyfikacja błędu dostępu warunkowego, umożliwiając wykonywanie większej liczby akcji lub informowanie użytkownika w zależności od scenariusza. Aby uzyskać więcej informacji, zobacz https://aka.ms/msal-net-UiRequiredException.

CorrelationId

Identyfikator, który może służyć do tworzenia pojedynczego przepływu uwierzytelniania.

(Odziedziczone po MsalException)
ErrorCode

Pobiera kod błędu protokołu zwrócony przez usługę lub generowany przez klienta. Jest to kod, na którym można polegać na obsłudze wyjątków. Wartości dla tego kodu są zwykle udostępniane w ciągach stałych w typach wyjątków pochodnych z wyjaśnieniami ograniczania ryzyka.

(Odziedziczone po MsalException)
ErrorCodesForLogging

Lista kodów błędów specyficznych dla usługi STS zwracanych przez usługę tokenu (na przykład kody liczbowe AADSTS , takie jak 50076, 50079), które uściśliją ErrorCodeelement . Wartości są emitowane przez usługę i mogą ulec zmianie bez powiadomienia; przeznaczone do diagnostyki i rejestrowania — nie należy rozgałęziać zachowania produkcyjnego dla tej wartości. Zwraca wartość null , gdy usługa nie podała kodów błędów.

(Odziedziczone po MsalServiceException)
Headers

Zawiera nagłówki HTTP z odpowiedzi serwera, które wskazywały błąd.

(Odziedziczone po MsalServiceException)
IsRetryable

Wskazuje, czy poprzednia operacja, która spowodowała ten wyjątek, powinna zostać ponowiona.

(Odziedziczone po MsalException)
ResponseBody

Nieprzetworzona treść odpowiedzi odebrana z serwera.

(Odziedziczone po MsalServiceException)
StatusCode

Pobiera kod stanu zwrócony z warstwy HTTP. Ten kod stanu jest HttpStatusCode w wewnętrznej HttpRequestException odpowiedzi lub w kodzie stanu zdarzenia NavigateError w przepływie opartym na przeglądarce (zobacz NavigateError Event Status Codes). Możesz użyć tego kodu do celów, takich jak implementowanie logiki ponawiania prób lub badania błędów.

(Odziedziczone po MsalServiceException)
SubErrorForLogging

Błąd podrzędny zwrócony przez udoskonalenie ErrorCode usługi tokenu (na przykład consent_required, bad_token, protection_policy_required). Wartości są emitowane przez usługę i mogą ulec zmianie bez powiadomienia; przeznaczone do diagnostyki i rejestrowania — nie należy rozgałęziać zachowania produkcyjnego dla tej wartości.

(Odziedziczone po MsalServiceException)

Metody

Nazwisko Opis
ToJsonString()

Umożliwia serializacji większości wartości wyjątku w formacie JSON.

(Odziedziczone po MsalException)
ToString()

Tworzy i zwraca reprezentację ciągu bieżącego wyjątku.

(Odziedziczone po MsalServiceException)
UpdateIsRetryable()

Zgodnie z dyskusją z Evo, AAD

(Odziedziczone po MsalServiceException)

Dotyczy