Eccezioni in MSAL Java

Durante l'elaborazione delle eccezioni, è possibile usare il tipo di eccezione stesso e il membro ErrorCode per distinguere le eccezioni. Esistono tre tipi di eccezioni: MsalClientException, MsalServiceExceptione MsalInteractionRequiredException, che ereditano da MsalException.

• MsalClientException viene generata quando si verifica un errore locale per la libreria o il dispositivo.
• MsalServiceException viene generata quando il servizio STS restituisce una risposta di errore o si verifica un altro errore di rete.
• MsalInteractionRequiredException viene generata quando l'interazione dell'interfaccia utente è necessaria per consentire l'esito positivo dell'autenticazione.

MsalServiceException

MsalServiceException espone le intestazioni HTTP restituite in risposta alle richieste all'STS. È possibile accedervi tramite MsalServiceException.headers()

MsalInteractionRequiredException

Uno dei codici di stato comuni restituiti da MSAL4J quando si chiama AcquireTokenSilently() è InvalidGrantError. Questo codice di stato indica che l'applicazione deve chiamare di nuovo la libreria di autenticazione, ma in modalità interattiva (uso di AuthorizationCodeParameters o DeviceCodeParameters per le applicazioni client pubbliche). Ciò è dovuto al fatto che è necessaria un'interazione utente aggiuntiva prima di poter emettere un token di autenticazione.

La maggior parte del tempo in cui AcquireTokenSilently ha esito negativo, perché la cache dei token non dispone di token corrispondenti alla richiesta. I token di accesso scadono entro 1 ora e AcquireTokenSilently tenterà di recuperare un nuovo token in base a un token di aggiornamento (in termini OAuth2, si tratta del flusso del "token di aggiornamento"). Questo flusso può anche non riuscire per diversi motivi, ad esempio se un amministratore tenant configura criteri di accesso più rigorosi.

L'interazione mira a indurre l'utente a compiere un'azione. Alcune di queste condizioni sono facili da risolvere (ad esempio, accettare condizioni per l'utilizzo con un solo clic) e alcune non possono essere risolte con la configurazione corrente (ad esempio, il computer in questione deve connettersi a una rete aziendale specifica).

MSAL espone un reason campo, che è possibile leggere per offrire un'esperienza utente migliore, ad esempio per indicare all'utente che la password è scaduta o che dovrà fornire il consenso per usare alcune risorse. I valori supportati fanno parte dell'enumerazione InteractionRequiredExceptionReason:

Esempio di codice

IAuthenticationResult result;
try {
    PublicClientApplication application = PublicClientApplication
            .builder("clientId")
            .b2cAuthority("authority")
            .build();

    SilentParameters parameters = SilentParameters
            .builder(Collections.singleton("scope"))
            .build();

    result = application.acquireTokenSilently(parameters).join();
}
catch (Exception ex){
    if(ex instanceof MsalInteractionRequiredException){
        // AcquireToken by either AuthorizationCodeParameters or DeviceCodeParameters
    } else{
        // Log and handle exception accordingly
    }
}