Idioma

MsalUiRequiredException Classe

Definição

Essa classe de exceção é informar aos desenvolvedores que a interação com a interface do usuário é necessária para que a autenticação tenha êxito. Ele é gerado ao chamar AcquireTokenSilent(IEnumerable<String>, IAccount) ou uma de suas substituições e quando o token não existe no cache ou o usuário precisa fornecer mais conteúdo ou executar autenticação de vários fatores com base em políticas Azure do AD, etc.. Para obter mais detalhes, confira https://aka.ms/msal-net-exceptions

public class MsalUiRequiredException : Microsoft.Identity.Client.MsalServiceException
type MsalUiRequiredException = class
    inherit MsalServiceException
Public Class MsalUiRequiredException
Inherits MsalServiceException
Herança
MsalUiRequiredException
Derivado

Construtores

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

Inicializa uma nova instância da classe de exceção com um código de erro especificado, uma mensagem de erro e uma exceção interna indicando a causa raiz.

MsalUiRequiredException(String, String, Exception)

Inicializa uma nova instância da classe de exceção com um código de erro especificado, uma mensagem de erro e uma exceção interna indicando a causa raiz.

MsalUiRequiredException(String, String)

Inicializa uma nova instância da classe de exceção com um código de erro e uma mensagem de erro especificados.

Campos

Nome Description
AuthenticationResultMetadataKey

Uma chave na Data qual a MSAL armazena o AuthenticationResultMetadata capturado quando uma aquisição deMsalException token falha com um não. Permite que os consumidores downstream superem o diagnóstico de aquisição de tokens, embora a exceção de origem seja relançada inalterada.

(Herdado de MsalException)
BrokerErrorCode

Uma AdditionalExceptionData chave de propriedade, disponível ao usar agentes da área de trabalho.

(Herdado de MsalException)
BrokerErrorContext

Uma AdditionalExceptionData chave de propriedade, disponível ao usar agentes da área de trabalho.

(Herdado de MsalException)
BrokerErrorStatus

Uma AdditionalExceptionData chave de propriedade, disponível ao usar agentes da área de trabalho.

(Herdado de MsalException)
BrokerErrorTag

Uma AdditionalExceptionData chave de propriedade, disponível ao usar agentes da área de trabalho.

(Herdado de MsalException)
BrokerTelemetry

Uma AdditionalExceptionData chave de propriedade, disponível ao usar agentes da área de trabalho.

(Herdado de MsalException)
ManagedIdentitySource

Uma AdditionalExceptionData chave de propriedade, disponível ao usar a identidade gerenciada.

(Herdado de MsalException)

Propriedades

Nome Description
AdditionalExceptionData

Um recipiente de propriedades com detalhes extras para essa exceção.

(Herdado de MsalException)
AuthenticationResultMetadata

Metadados de diagnóstico para a tentativa de aquisição de token com falha – a duração total e, quando o estágio relevante foi executado, durações HTTP/cache, ponto de extremidade de token e região usados. null É quando a exceção foi gerada antes do pipeline de solicitação começar a coletar metadados (por exemplo, validação de parâmetro ou construtor). Quando não for nulo , a falha típica na solicitação é DurationTotalInMs sempre preenchida (útil para medição de latência), enquanto os outros campos podem ser 0/nulo quando o estágio correspondente não foi executado. Em uma falha TokenSource não tem nenhum valor significativo e não deve ser confiado. Reutiliza o tipo retornado no AuthenticationResultMetadata caminho de êxito.

(Herdado de MsalException)
Claims

Declarações adicionais solicitadas pelo serviço. Quando essa propriedade não é nula ou vazia, isso significa que o serviço exige que o usuário forneça declarações adicionais, como fazer autenticação de dois fatores. São dois casos:

Para obter mais detalhes, consulte https://aka.ms/msal-net-claim-challenge (Herdado de MsalServiceException)
Classification

Classificação do erro de acesso condicional, permitindo que você faça mais ações ou informe o usuário dependendo do seu cenário. Confira https://aka.ms/msal-net-UiRequiredException para saber mais.

CorrelationId

Uma ID que pode ser usada para configurar um único fluxo de autenticação.

(Herdado de MsalException)
ErrorCode

Obtém o código de erro de protocolo retornado pelo serviço ou gerado pelo cliente. Esse é o código no qual você pode confiar para tratamento de exceções. Os valores para esse código normalmente são fornecidos em cadeias de caracteres constantes nos tipos de exceções derivadas com explicações de mitigação.

(Herdado de MsalException)
ErrorCodesForLogging

A lista de códigos de erro específicos de STS retornados pelo serviço de token (por exemplo, os códigos numéricos AADSTS , como 50076, 50079) que refinam ErrorCode. Os valores são emitidos pelo serviço e podem ser alterados sem aviso prévio; destinado a diagnósticos e registro em log – não ramifica o comportamento de produção nesse valor. Retorna null quando o serviço não fornece códigos de erro.

(Herdado de MsalServiceException)
Headers

Contém os cabeçalhos HTTP da resposta do servidor que indicou um erro.

(Herdado de MsalServiceException)
IsRetryable

Indica se a operação anterior que resultou nessa exceção deve ser repetida.

(Herdado de MsalException)
ResponseBody

Corpo de resposta bruto recebido do servidor.

(Herdado de MsalServiceException)
StatusCode

Obtém o código de status retornado da camada HTTP. Esse código de status é a HttpStatusCode resposta interna HttpRequestException ou o código de status de evento NavigateError em um fluxo baseado em navegador (consulte códigos de status de evento NavigateError). Você pode usar esse código para fins como implementar a lógica de repetição ou a investigação de erros.

(Herdado de MsalServiceException)
SubErrorForLogging

Sub-erro retornado pelo refinamento ErrorCode do serviço de token (por exemploconsent_required, , bad_token). protection_policy_required Os valores são emitidos pelo serviço e podem ser alterados sem aviso prévio; destinado a diagnósticos e registro em log – não ramifica o comportamento de produção nesse valor.

(Herdado de MsalServiceException)

Métodos

Nome Description
ToJsonString()

Permite a serialização da maioria dos valores da exceção em JSON.

(Herdado de MsalException)
ToString()

Cria e retorna uma representação de cadeia de caracteres da exceção atual.

(Herdado de MsalServiceException)
UpdateIsRetryable()

De acordo com a discussão com o Evo, AAD

(Herdado de MsalServiceException)

Aplica-se a