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 substituiçã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 browsers que suportem separadores personalizados. Aqui estão alguns exemplos desses navegadores:

Navegadores que têm suporte a guias personalizadas	Nome do pacote
Chrome	com.android.chrome
Microsoft Edge	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	Browser	Result
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+	Opera	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+	UC Browser	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 raiz: um navegador que suporta separadores personalizados não estava ativado 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 Embedded versus interface do usuário da Web do sistema.