Considerações sobre o navegador do sistema Xamarin Android para usar o MSAL.NET

Este artigo descreve o que você deve considerar ao usar o navegador do sistema no Xamarin Android com a Biblioteca de Autenticação da Microsoft para .NET (MSAL.NET).

Nota

MSAL.NET versões 4.61.0 e superiores não oferecem suporte para a Plataforma Universal do Windows (UWP), Xamarin Android e Xamarin iOS. Recomendamos que você migre seus aplicativos Xamarin para estruturas modernas como MAUI. Leia mais sobre a descontinuação em Anunciando a próxima descontinuação do MSAL.NET para Xamarin e UWP.

A partir do MSAL.NET 2.4.0 Preview, MSAL.NET suporta navegadores diferentes do Chrome. Já não é necessário que o Chrome esteja instalado no dispositivo Android para autenticação.

Recomendamos que utilize navegadores que suportem abas personalizadas. Aqui estão alguns exemplos desses navegadores:

Navegadores que têm suporte a guias personalizadas Nome do pacote
Cromado com.android.chrome
Borda da Microsoft com.microsoft.emmx
Firefox org.mozilla.firefox
Ecosia com.ecosia.android
Kiwi com.kiwibrowser.browser
Corajoso com.brave.browser

Além de identificar navegadores que oferecem suporte a guias personalizadas, nossos testes indicam que alguns navegadores que não oferecem suporte a guias personalizadas também funcionam para autenticação. Esses navegadores incluem Opera, Opera Mini, InBrowser e Maxthon.

Dispositivos e navegadores testados

A tabela a seguir lista os dispositivos e navegadores que foram testados quanto à compatibilidade de autenticação.

Dispositivo Navegador Resultado
Huawei/One+ Croma* Aprovação
Huawei/One+ Borda* Aprovação
Huawei/One+ Firefox* Aprovação
Huawei/One+ Corajoso* Aprovação
Um+ Ecosia* Aprovação
Um+ Kiwi* Aprovação
Huawei/One+ Ópera Aprovação
Huawei, OperaMini Aprovação
Huawei/One+ InBrowser Aprovação
Um+ Maxthon Aprovação
Huawei/One+ DuckDuckGo Autenticação cancelada pelo usuário
Huawei/One+ Navegador UC Autenticação cancelada pelo usuário
Um+ Golfinho Autenticação cancelada pelo usuário
Um+ Navegador CM Autenticação cancelada pelo usuário
Huawei/One+ Nenhum instalado Exceção AndroidActivityNotFound

* Suporta abas personalizadas

Problemas conhecidos

Se o usuário não tiver nenhum navegador ativado no dispositivo, MSAL.NET lançará uma AndroidActivityNotFound exceção.

  • Atenuação: peça ao usuário para ativar um navegador em seu dispositivo. Recomende um navegador que suporte separadores personalizados.

Se a autenticação falhar (por exemplo, se a autenticação for iniciada com o DuckDuckGo), MSAL.NET retornará AuthenticationCanceled MsalClientException.

  • Problema principal: um navegador que suporta separadores personalizados não estava habilitado no dispositivo. Autenticação iniciada com um navegador que não pôde concluir a autenticação.
  • Atenuação: peça ao usuário para ativar um navegador em seu dispositivo. Recomende um navegador que suporte separadores personalizados.

Próximos passos

Para obter mais informações e exemplos de código, consulte Escolhendo entre um navegador da Web incorporado e um navegador do sistema no Xamarin Android e Interface do usuário da Web incorporada versus do sistema.