Lenguaje

MsalServiceException Clase

Definición

Tipo de excepción que se produce cuando el servicio devuelve una respuesta de error u otros errores de red. Si desea obtener información más detallada, consulte https://aka.ms/msal-net-exceptions.

public class MsalServiceException : Microsoft.Identity.Client.MsalException
type MsalServiceException = class
    inherit MsalException
Public Class MsalServiceException
Inherits MsalException
Herencia
MsalServiceException
Derivado

Constructores

Nombre Description
MsalServiceException(String, String, Exception)

Inicializa una nueva instancia de la clase de excepción con un código de error, un mensaje de error y una referencia a la excepción interna que es la causa de esta excepción.

MsalServiceException(String, String, Int32, Exception)

Inicializa una nueva instancia de la clase de excepción con un código de error, un mensaje de error y una referencia a la excepción interna que es la causa de esta excepción.

MsalServiceException(String, String, Int32, String, Exception)

Inicializa una nueva instancia de la clase de excepción con un código de error, un mensaje de error y una referencia a la excepción interna que es la causa de esta excepción.

MsalServiceException(String, String, Int32)

Inicializa una nueva instancia de la clase de excepción con un código de error, un mensaje de error y una referencia a la excepción interna que es la causa de esta excepción.

MsalServiceException(String, String)

Inicializa una nueva instancia de la clase de excepción con un código de error, un mensaje de error y una referencia a la excepción interna que es la causa de esta excepción.

Campos

Nombre Description
AuthenticationResultMetadataKey

Clave en la Data que MSAL almacena el AuthenticationResultMetadata objeto capturado cuando se produce un error en la adquisición de tokens con un valorMsalException distinto. Permite a los consumidores de nivel inferior exponer los diagnósticos de adquisición de tokens aunque la excepción de origen se vuelva a producir sin cambios.

(Heredado de MsalException)
BrokerErrorCode

Una AdditionalExceptionData clave de propiedad, disponible cuando se usan agentes de escritorio.

(Heredado de MsalException)
BrokerErrorContext

Una AdditionalExceptionData clave de propiedad, disponible cuando se usan agentes de escritorio.

(Heredado de MsalException)
BrokerErrorStatus

Una AdditionalExceptionData clave de propiedad, disponible cuando se usan agentes de escritorio.

(Heredado de MsalException)
BrokerErrorTag

Una AdditionalExceptionData clave de propiedad, disponible cuando se usan agentes de escritorio.

(Heredado de MsalException)
BrokerTelemetry

Una AdditionalExceptionData clave de propiedad, disponible cuando se usan agentes de escritorio.

(Heredado de MsalException)
ManagedIdentitySource

Una AdditionalExceptionData clave de propiedad, disponible cuando se usa la identidad administrada.

(Heredado de MsalException)

Propiedades

Nombre Description
AdditionalExceptionData

Contenedor de propiedades con detalles adicionales para esta excepción.

(Heredado de MsalException)
AuthenticationResultMetadata

Metadatos de diagnóstico para el intento de adquisición de tokens con error: la duración total y, cuando se ejecutó la fase pertinente, duraciones http/caché, punto de conexión del token y región usadas. Esto es null cuando se produjo la excepción antes de que la canalización de solicitudes comenzara a recopilar metadatos (por ejemplo, parámetro o validación del generador). Cuando no es null , el error típico en la solicitud, DurationTotalInMs siempre se rellena (resulta útil para la medición de latencia), mientras que los demás campos pueden ser 0/NULL cuando no se ejecutó la fase correspondiente. En un error TokenSource no tiene ningún valor significativo y no debe basarse en . Reutiliza el tipo devuelto por AuthenticationResultMetadata en la ruta de acceso correcta.

(Heredado de MsalException)
Claims

Notificaciones adicionales solicitadas por el servicio. Cuando esta propiedad no es nula o está vacía, significa que el servicio requiere que el usuario proporcione notificaciones adicionales, como realizar la autenticación en dos fases. Son dos casos:

Para obtener más información, consulte https://aka.ms/msal-net-claim-challenge
CorrelationId

Identificador que se puede usar para dividir un único flujo de autenticación.

(Heredado de MsalException)
ErrorCode

Obtiene el código de error del protocolo devuelto por el servicio o generado por el cliente. Este es el código en el que puede confiar en el control de excepciones. Los valores de este código normalmente se proporcionan en cadenas constantes en los tipos de excepciones derivadas con explicaciones de mitigación.

(Heredado de MsalException)
ErrorCodesForLogging

La lista de códigos de error específicos de STS devueltos por el servicio de token (por ejemplo, los códigos numéricos AADSTS como 50076, 50079) que refinan ErrorCode. Los valores son emitidos por el servicio y pueden cambiar sin previo aviso; diseñado para diagnósticos y registro: no bifurca el comportamiento de producción en este valor. Devuelve null cuando el servicio no proporciona códigos de error.

Headers

Contiene los encabezados HTTP de la respuesta del servidor que indica un error.

IsRetryable

Indica si se debe reintentar la operación anterior que dio lugar a esta excepción.

(Heredado de MsalException)
ResponseBody

Cuerpo de respuesta sin procesar recibido del servidor.

StatusCode

Obtiene el código de estado devuelto de la capa HTTP. Este código de estado es en HttpStatusCode la respuesta interna HttpRequestException o en el código de estado del evento NavigateError en un flujo basado en el explorador (vea NavigateError Event Status Codes). Puede usar este código para fines como la implementación de la lógica de reintento o la investigación de errores.

SubErrorForLogging

Sub error devuelto por el refinador ErrorCode del servicio de token (por ejemplo consent_required, , bad_token, protection_policy_required). Los valores son emitidos por el servicio y pueden cambiar sin previo aviso; diseñado para diagnósticos y registro: no bifurca el comportamiento de producción en este valor.

Métodos

Nombre Description
ToJsonString()

Permite la serialización de la mayoría de los valores de la excepción en JSON.

(Heredado de MsalException)
ToString()

Crea y devuelve una representación de cadena de la excepción actual.

UpdateIsRetryable()

Según el debate con Evo, AAD

Se aplica a