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

Este artigo discute 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).

Observação

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

A partir da MSAL.NET 2.4.0 versão prévia, a MSAL.NET dá suporte a outros navegadores além do Chrome. Ela não requer mais que o Chrome seja instalado no dispositivo Android para autenticação.

Recomendamos que você use navegadores que ofereçam suporte a guias personalizadas. Aqui estão alguns exemplos desses navegadores:

Navegadores com suporte das guias personalizadas Nome do pacote
Cromar com.android.chrome
Microsoft Edge com.microsoft.emmx
Firefox org.mozilla.firefox
Ecosia com.ecosia.android
Quivi 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 dão 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 / Um + Cromar* Aprovado
Huawei / Um + Borda* Aprovado
Huawei / Um + Raposa do fogo* Aprovado
Huawei / Um + Corajoso* Aprovado
Um+ Ecosia* Aprovado
Um+ Quivi* Aprovado
Huawei / Um + Ópera Aprovado
Huawei OperaMini Aprovado
Huawei / Um + No navegador Aprovado
Um+ Maxthon Aprovado
Huawei / Um + DuckDuckGo O usuário cancelou a autenticação
Huawei / Um + Navegador de UC O usuário cancelou a autenticação
Um+ Golfinho O usuário cancelou a autenticação
Um+ Navegador CM O usuário cancelou a autenticação
Huawei / Um + Nenhum instalado Exceção AndroidActivityNotFound

* Dá suporte a funções personalizadas

Problemas conhecidos

Se o usuário não tiver um navegador habilitado no dispositivo, a MSAL.NET gerará uma AndroidActivityNotFound exceção.

  • Mitigação: peça ao usuário para habilitar um navegador em seu dispositivo. Recomendamos um navegador que dê suporte a guias personalizadas.

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

  • Problema de raiz: um navegador que dá suporte a guias personalizadas não foi habilitado no dispositivo. A autenticação foi iniciada com um navegador que não pôde concluir a autenticação.
  • Mitigação: peça ao usuário para habilitar um navegador em seu dispositivo. Recomendamos um navegador que dê suporte a guias personalizadas.

Próximas etapas

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 incorporado versus interface do usuário da Web do sistema.