Consideraciones del navegador del sistema de Xamarin Android para usar MSAL.NET

En este artículo se describe lo que debe tener en cuenta al usar el explorador del sistema en Xamarin Android con la Biblioteca de autenticación de Microsoft para .NET (MSAL.NET).

Nota:

Ni la versión 4.61.0 de MSAL.NET ni las posteriores proporcionan compatibilidad con la Plataforma universal de Windows (UWP), Xamarin Android y Xamarin iOS. Se recomienda migrar las aplicaciones de Xamarin a marcos modernos, como MAUI. Obtenga más información sobre el desuso en Anuncio del próximo desuso de MSAL.NET para Xamarin y UWP.

A partir de la versión preliminar de MSAL.NET 2.4.0, MSAL.NET admite exploradores distintos de Chrome. Ya no es necesario que Chrome esté instalado en el dispositivo Android para la autenticación.

Se recomienda usar exploradores que admitan pestañas personalizadas. Aquí se proporcionan algunos ejemplos de estos exploradores:

Exploradores que admiten pestañas personalizadas Nombre del paquete
Cromo com.android.chrome
Microsoft Edge com.microsoft.emmx
Firefox org.mozilla.firefox
Ecosia com.ecosia.android
Kiwi com.kiwibrowser.navegador
Valiente com.brave.navegador

Además de identificar los exploradores que admiten pestañas personalizadas, nuestras pruebas revelan que algunos exploradores que no las admiten también funcionan para la autenticación. Estos exploradores incluyen Opera, Opera Mini, InBrowser y Maxthon.

Dispositivos y exploradores probados

En la tabla siguiente se enumeran los dispositivos y exploradores que se han probado para determinar si son compatibles con la autenticación.

Dispositivo Navegador Resultado
Huawei/One+ Cromo* Pasar
Huawei/One+ Borde* Pasar
Huawei/One+ Firefox* Pasar
Huawei/One+ Valiente* Pasar
Uno+ Ecosia* Pasar
Uno+ Kiwi* Pasar
Huawei/One+ Ópera Pasar
Huawei OperaMini Pasar
Huawei/One+ InBrowser (en inglés) Pasar
Uno+ Maxthon Pasar
Huawei/One+ Pato DuckGo Autenticación cancelada por el usuario
Huawei/One+ Navegador UC Autenticación cancelada por el usuario
Uno+ Delfín Autenticación cancelada por el usuario
Uno+ Navegador CM Autenticación cancelada por el usuario
Huawei/One+ Ninguno instalado Excepción AndroidActivityNotFound

* Admite las pestañas personalizadas

Problemas conocidos

Si el usuario no tiene ningún explorador habilitado en el dispositivo, MSAL.NET iniciará una excepción AndroidActivityNotFound.

  • Mitigación: pida al usuario que habilite un explorador en su dispositivo. Recomiende un explorador que admita pestañas personalizadas.

Si se produce un error de autenticación (por ejemplo, si la autenticación se inicia con DuckDuckGo), MSAL.NET devolverá AuthenticationCanceled MsalClientException.

  • Problema raíz: no se ha habilitado un explorador que admite pestañas personalizadas en el dispositivo. La autenticación se inició con un explorador que no pudo completar la autenticación.
  • Mitigación: pida al usuario que habilite un explorador en su dispositivo. Recomiende un explorador que admita pestañas personalizadas.

Pasos siguientes

Para obtener más información y ejemplos de código, consulte Elección entre un explorador web insertado y un explorador del sistema en Xamarin Android e Interfaz de usuario web integrada frente el sistema.