Språk

MsalUiRequiredException Klass

Definition

Den här undantagsklassen är till för att informera utvecklare om att interaktion med användargränssnittet krävs för att autentiseringen ska lyckas. Den utlöses vid anrop AcquireTokenSilent(IEnumerable<String>, IAccount) eller någon av dess åsidosättningar, och när token inte finns i cacheminnet, eller om användaren behöver ange mer innehåll eller utföra multifaktorautentisering baserat på Azure AD-principer osv.. Mer information finns i https://aka.ms/msal-net-exceptions

public class MsalUiRequiredException : Microsoft.Identity.Client.MsalServiceException
type MsalUiRequiredException = class
    inherit MsalServiceException
Public Class MsalUiRequiredException
Inherits MsalServiceException
Arv
MsalUiRequiredException
Härledda

Konstruktorer

Name Description
MsalUiRequiredException(String, String, Exception, UiRequiredExceptionClassification)

Initierar en ny instans av undantagsklassen med en angiven felkod, ett felmeddelande och ett inre undantag som anger rotorsaken.

MsalUiRequiredException(String, String, Exception)

Initierar en ny instans av undantagsklassen med en angiven felkod, ett felmeddelande och ett inre undantag som anger rotorsaken.

MsalUiRequiredException(String, String)

Initierar en ny instans av undantagsklassen med en angiven felkod och ett felmeddelande.

Fält

Name Description
AuthenticationResultMetadataKey

En nyckel Data där MSAL lagrar den AuthenticationResultMetadata insamlade när ett tokenförvärv misslyckas med en icke-MsalException. Låter nedströmskonsumenter visa token-förvärvsdiagnostik även om det ursprungliga undantaget genereras på nytt oförändrat.

(Ärvd från MsalException)
BrokerErrorCode

En AdditionalExceptionData egenskapsnyckel som är tillgänglig när du använder skrivbordskoordinatorer.

(Ärvd från MsalException)
BrokerErrorContext

En AdditionalExceptionData egenskapsnyckel som är tillgänglig när du använder skrivbordskoordinatorer.

(Ärvd från MsalException)
BrokerErrorStatus

En AdditionalExceptionData egenskapsnyckel som är tillgänglig när du använder skrivbordskoordinatorer.

(Ärvd från MsalException)
BrokerErrorTag

En AdditionalExceptionData egenskapsnyckel som är tillgänglig när du använder skrivbordskoordinatorer.

(Ärvd från MsalException)
BrokerTelemetry

En AdditionalExceptionData egenskapsnyckel som är tillgänglig när du använder skrivbordskoordinatorer.

(Ärvd från MsalException)
ManagedIdentitySource

En AdditionalExceptionData egenskapsnyckel som är tillgänglig när du använder hanterad identitet.

(Ärvd från MsalException)

Egenskaper

Name Description
AdditionalExceptionData

En egenskapsväska med extra information för det här undantaget.

(Ärvd från MsalException)
AuthenticationResultMetadata

Diagnostikmetadata för det misslyckade tokenförvärvsförsöket – den totala varaktigheten och, när den relevanta fasen kördes, HTTP/cachevaraktighet, tokenslutpunkt och region som används. Det här är null när undantaget utlöstes innan begärandepipelinen började samla in metadata (till exempel parameter- eller byggvalidering). När det inte är null , det typiska felet i begäran, DurationTotalInMs fylls alltid i (användbart för svarstidsmätning), medan de andra fälten kan vara 0/null när motsvarande steg inte kördes. Vid ett fel TokenSource har inget meningsfullt värde och bör inte förlitas på. Återanvänder den typ som returneras av AuthenticationResultMetadata på lyckad sökväg.

(Ärvd från MsalException)
Claims

Ytterligare anspråk som begärs av tjänsten. När den här egenskapen inte är null eller tom innebär det att tjänsten kräver att användaren tillhandahåller ytterligare anspråk, till exempel att göra tvåfaktorautentisering. Är två fall:

Mer information finns i https://aka.ms/msal-net-claim-challenge (Ärvd från MsalServiceException)
Classification

Klassificering av felet för villkorsstyrd åtkomst så att du kan utföra fler åtgärder eller informera användaren beroende på ditt scenario. Mer information finns i https://aka.ms/msal-net-UiRequiredException.

CorrelationId

Ett ID som kan användas för att dela upp ett enda autentiseringsflöde.

(Ärvd från MsalException)
ErrorCode

Hämtar protokollfelkoden som returneras av tjänsten eller genereras av klienten. Det här är den kod som du kan lita på för undantagshantering. Värden för den här koden anges vanligtvis i konstanta strängar i de härledda undantagstyperna med förklaringar av minskning.

(Ärvd från MsalException)
ErrorCodesForLogging

Listan över STS-specifika felkoder som returneras av tokentjänsten (till exempel de numeriska AADSTS koder som , 50079) som 50076förfinar ErrorCode. Värden genereras av tjänsten och kan ändras utan föregående meddelande. avsedd för diagnostik och loggning – förgrena inte produktionsbeteendet på det här värdet. Returnerar null när tjänsten inte angav felkoder.

(Ärvd från MsalServiceException)
Headers

Innehåller HTTP-huvudena från serversvaret som indikerade ett fel.

(Ärvd från MsalServiceException)
IsRetryable

Anger om den tidigare åtgärden som resulterade i det här undantaget ska göras om.

(Ärvd från MsalException)
ResponseBody

Råsvarstext som tagits emot från servern.

(Ärvd från MsalServiceException)
StatusCode

Hämtar statuskoden som returneras från HTTP-lagret. Den här statuskoden är antingen HttpStatusCode i det inre HttpRequestException svaret eller NavigateError Event Status Code i ett webbläsarbaserat flöde (se NavigateError Händelsestatuskoder). Du kan använda den här koden för ändamål som att implementera omprövningslogik eller felundersökning.

(Ärvd från MsalServiceException)
SubErrorForLogging

Underfel som returneras av tokentjänstens förfining ErrorCode (till exempel consent_required, bad_token, protection_policy_required). Värden genereras av tjänsten och kan ändras utan föregående meddelande. avsedd för diagnostik och loggning – förgrena inte produktionsbeteendet på det här värdet.

(Ärvd från MsalServiceException)

Metoder

Name Description
ToJsonString()

Tillåter serialisering av de flesta värden i undantaget till JSON.

(Ärvd från MsalException)
ToString()

Skapar och returnerar en strängrepresentation av det aktuella undantaget.

(Ärvd från MsalServiceException)
UpdateIsRetryable()

Enligt diskussion med Evo, AAD

(Ärvd från MsalServiceException)

Gäller för