Langue

MsalUiRequiredException Classe

Définition

Cette classe d’exception consiste à informer les développeurs que l’interaction de l’interface utilisateur est requise pour que l’authentification réussisse. Elle est levée lors de l'appel AcquireTokenSilent(IEnumerable<String>, IAccount) ou de l'une de ses substitutions, et lorsque le jeton n'existe pas dans le cache, ou que l'utilisateur doit fournir plus de contenu, ou effectuer une authentification à plusieurs facteurs en fonction de Azure stratégies AD, etc.. Pour plus d'informations, voir https://aka.ms/msal-net-exceptions

public class MsalUiRequiredException : Microsoft.Identity.Client.MsalServiceException
type MsalUiRequiredException = class
    inherit MsalServiceException
Public Class MsalUiRequiredException
Inherits MsalServiceException
Héritage
MsalUiRequiredException
Dérivé

Constructeurs

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

Initialise une nouvelle instance de la classe d’exception avec un code d’erreur, un message d’erreur et une exception interne spécifiés indiquant la cause racine.

MsalUiRequiredException(String, String, Exception)

Initialise une nouvelle instance de la classe d’exception avec un code d’erreur, un message d’erreur et une exception interne spécifiés indiquant la cause racine.

MsalUiRequiredException(String, String)

Initialise une nouvelle instance de la classe d’exception avec un code d’erreur et un message d’erreur spécifiés.

Champs

Nom Description
AuthenticationResultMetadataKey

Clé sur Data laquelle MSAL stocke la AuthenticationResultMetadata capture lorsqu’une acquisition de jetons échoue avec un non-MsalException. Permet aux consommateurs en aval de surfacer les diagnostics d’acquisition de jetons même si l’exception d’origine est levée à nouveau inchangée.

(Hérité de MsalException)
BrokerErrorCode

Clé AdditionalExceptionData de propriété disponible lors de l’utilisation de répartiteurs de bureau.

(Hérité de MsalException)
BrokerErrorContext

Clé AdditionalExceptionData de propriété disponible lors de l’utilisation de répartiteurs de bureau.

(Hérité de MsalException)
BrokerErrorStatus

Clé AdditionalExceptionData de propriété disponible lors de l’utilisation de répartiteurs de bureau.

(Hérité de MsalException)
BrokerErrorTag

Clé AdditionalExceptionData de propriété disponible lors de l’utilisation de répartiteurs de bureau.

(Hérité de MsalException)
BrokerTelemetry

Clé AdditionalExceptionData de propriété disponible lors de l’utilisation de répartiteurs de bureau.

(Hérité de MsalException)
ManagedIdentitySource

Clé AdditionalExceptionData de propriété disponible lors de l’utilisation de l’identité managée.

(Hérité de MsalException)

Propriétés

Nom Description
AdditionalExceptionData

Un conteneur de propriétés avec des détails supplémentaires pour cette exception.

(Hérité de MsalException)
AuthenticationResultMetadata

Métadonnées de diagnostic pour la tentative d’acquisition de jeton ayant échoué : durée totale et, lorsque l’étape appropriée a été exécutée, les durées HTTP/cache, le point de terminaison de jeton et la région utilisés. Il s’agit null du moment où l’exception a été levée avant que le pipeline de requête ne commence à collecter les métadonnées (par exemple, la validation du paramètre ou du générateur). Lorsqu’il n’est pas null ( l’échec classique de la demande) DurationTotalInMs est toujours rempli (utile pour la mesure de latence), tandis que les autres champs peuvent être 0/null lorsque l’étape correspondante n’a pas été exécutée. En cas d’échec TokenSource n’a aucune valeur significative et ne doit pas être utilisé. Réutilise le type retourné par AuthenticationResultMetadata sur le chemin de réussite.

(Hérité de MsalException)
Claims

Revendications supplémentaires demandées par le service. Lorsque cette propriété n’est pas null ou vide, cela signifie que le service exige que l’utilisateur fournisse des revendications supplémentaires, telles que l’authentification à deux facteurs. Voici deux cas :

Pour plus d’informations, consultez https://aka.ms/msal-net-claim-challenge (Hérité de MsalServiceException)
Classification

Classification de l’erreur d’accès conditionnel, vous permettant d’effectuer plus d’actions ou d’informer l’utilisateur en fonction de votre scénario. Consultez https://aka.ms/msal-net-UiRequiredException pour plus d’informations.

CorrelationId

ID qui peut être utilisé pour fragmenter un seul flux d’authentification.

(Hérité de MsalException)
ErrorCode

Obtient le code d’erreur du protocole retourné par le service ou généré par le client. Il s’agit du code sur lequel vous pouvez vous appuyer pour la gestion des exceptions. Les valeurs de ce code sont généralement fournies dans des chaînes constantes dans les types d’exceptions dérivés avec des explications d’atténuation.

(Hérité de MsalException)
ErrorCodesForLogging

Liste des codes d’erreur propres à STS retournés par le service de jetons (par exemple les codes numériques AADSTS tels que 50076, 50079) qui affinent ErrorCode. Les valeurs sont émises par le service et peuvent changer sans préavis ; destinées aux diagnostics et à la journalisation : ne pas créer de comportement de production de branche sur cette valeur. Retourne null lorsque le service n’a pas fourni de codes d’erreur.

(Hérité de MsalServiceException)
Headers

Contient les en-têtes HTTP de la réponse du serveur qui ont indiqué une erreur.

(Hérité de MsalServiceException)
IsRetryable

Indique si l’opération précédente qui a entraîné cette exception doit être retentée.

(Hérité de MsalException)
ResponseBody

Corps de réponse brut reçu du serveur.

(Hérité de MsalServiceException)
StatusCode

Obtient le code d’état retourné par la couche HTTP. Ce code d’état est soit HttpStatusCode dans la réponse interne HttpRequestException , soit dans le code d’état de l’événement NavigateError dans un flux basé sur un navigateur (voir Codes d’état de l’événement NavigateError). Vous pouvez utiliser ce code à des fins telles que l’implémentation d’une logique de nouvelle tentative ou d’une investigation d’erreur.

(Hérité de MsalServiceException)
SubErrorForLogging

Sous-erreur retournée par le raffinage ErrorCode du service de jeton (par exempleconsent_required, , bad_tokenprotection_policy_required). Les valeurs sont émises par le service et peuvent changer sans préavis ; destinées aux diagnostics et à la journalisation : ne pas créer de comportement de production de branche sur cette valeur.

(Hérité de MsalServiceException)

Méthodes

Nom Description
ToJsonString()

Permet la sérialisation de la plupart des valeurs de l’exception en JSON.

(Hérité de MsalException)
ToString()

Crée et retourne une représentation sous forme de chaîne de l’exception actuelle.

(Hérité de MsalServiceException)
UpdateIsRetryable()

Selon la discussion avec Evo, AAD

(Hérité de MsalServiceException)

S’applique à