MicrosoftIdentityAuthenticationException Classe

Definizione

Eccezione generata quando l'autenticazione non riesce durante la gestione dei messaggi HTTP da parte di MicrosoftIdentityMessageHandler.

public class MicrosoftIdentityAuthenticationException : Exception
type MicrosoftIdentityAuthenticationException = class
    inherit Exception
Public Class MicrosoftIdentityAuthenticationException
Inherits Exception
Ereditarietà
MicrosoftIdentityAuthenticationException

Esempio

Modello tipico di gestione delle eccezioni:

try
{
    var response = await httpClient.SendAsync(request, cancellationToken);
    response.EnsureSuccessStatusCode();
}
catch (MicrosoftIdentityAuthenticationException authEx)
{
    // Handle authentication-specific failures
    logger.LogError(authEx, "Authentication failed: {Message}", authEx.Message);
    throw; // Re-throw or handle as appropriate
}
catch (HttpRequestException httpEx)
{
    // Handle other HTTP-related failures
    logger.LogError(httpEx, "HTTP request failed: {Message}", httpEx.Message);
}

Commenti

Questa eccezione viene in genere generata negli scenari seguenti:

  • Nessuna opzione di autenticazione è configurata (né predefinita né per richiesta)
  • Nessun ambito specificato nelle opzioni di autenticazione
  • L'acquisizione del token non riesce a causa di problemi del provider di autenticazione

Nota sulla gestione delle sfide WWW-Authenticate: Quando un'API downstream restituisce una risposta non autorizzata 401 con un'intestazione WWW-Authenticate contenente attestazioni aggiuntive (ad esempio, per l'accesso condizionale), il gestore estrae automaticamente queste attestazioni usando WwwAuthenticateParameters e tenta di acquisire un nuovo token con le attestazioni richieste. Se questo nuovo tentativo automatico ha esito positivo, non viene generata alcuna eccezione. Se il nuovo tentativo non riesce anche con un valore 401, la risposta viene restituita al chiamante senza generare un'eccezione. Il chiamante deve controllare il codice di stato. Le eccezioni vengono generate solo per gli errori di acquisizione del token, non per le risposte HTTP 401 stesse.

Quando si gestisce questa eccezione, esaminare la Message proprietà per informazioni specifiche su ciò che ha causato l'errore di autenticazione. Se è presente un'eccezione interna, può contenere informazioni aggiuntive dal provider di autenticazione sottostante.

Costruttori

Nome Descrizione
MicrosoftIdentityAuthenticationException(String, Exception)

Inizializza una nuova istanza della MicrosoftIdentityAuthenticationException classe con un messaggio di errore specificato e un riferimento all'eccezione interna che è la causa di questa eccezione.

MicrosoftIdentityAuthenticationException(String)

Inizializza una nuova istanza della MicrosoftIdentityAuthenticationException classe con un messaggio di errore specificato.

Si applica a

Vedi anche