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.