Exceções no MSAL Java

Ao processar exceções, pode usar o próprio tipo de exceção e o membro ErrorCode para distinguir entre exceções. Existem três tipos de exceções: MsalClientException, , e MsalServiceException, todas herdadas de MsalInteractionRequiredExceptionMsalException.

• MsalClientException é gerada quando ocorre um erro local à biblioteca ou ao dispositivo.
• O MsalServiceException é lançado quando o serviço STS devolve uma resposta de erro ou ocorre outro erro de rede.
• O MsalInteractionRequiredException é lançado quando é necessária interação com a interface para que a autenticação tenha sucesso.

MsalServiceException

A MsalServiceException expõe os cabeçalhos HTTP devolvidos nos pedidos ao STS. Pode aceder a eles através de MsalServiceException.headers()

MsalInteractionRequiredException

Um dos códigos de estado comuns devolvidos pelo MSAL4J ao chamar AcquireTokenSilently() é InvalidGrantError. Este código de estado significa que a aplicação deve chamar novamente a biblioteca de autenticação, mas em modo interativo (usando AuthorizationCodeParameters ou DeviceCodeParameters para aplicações clientes públicas). Isto deve-se ao facto de ser necessária uma interação adicional do utilizador antes de poder emitir um token de autenticação.

Na maioria das vezes, quando o AcquireTokenSilently falha, é porque a cache de tokens não tem tokens que correspondam ao seu pedido. Os tokens de acesso expiram em 1 hora, e a AcquireTokenSilently tenta obter um novo com base num token de atualização (em termos OAuth2, este é o fluxo de "Token de Atualização"). Este fluxo também pode falhar por várias razões, por exemplo, se um administrador de inquilino configurar políticas de login mais rigorosas.

A interação visa que o utilizador realize uma ação. Algumas dessas condições são fáceis de resolver pelos utilizadores (por exemplo, aceitar os Termos de Uso com um único clique), e outras não podem ser resolvidas com a configuração atual (por exemplo, a máquina em questão precisa de se ligar a uma rede corporativa específica).

O MSAL expõe um reason campo, que pode ler para proporcionar uma melhor experiência ao utilizador, por exemplo, para informar o utilizador que a sua palavra-passe expirou ou que terá de dar consentimento para usar alguns recursos. Os valores suportados fazem parte do enum InteractionRequiredExceptionReason:

Exemplo de código

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
    }
}