Partager via


Considérations sur les navigateurs système Xamarin Android pour l’utilisation de MSAL.NET

Cet article aborde les points à prendre en compte pour utiliser le navigateur système sur Xamarin Android avec la Bibliothèque d’authentification Microsoft pour .NET (MSAL.NET).

Remarque

MSAL.NET versions 4.61.0 et ultérieures ne prennent pas en charge la plateforme Windows universelle (UWP), Xamarin Android et Xamarin iOS. Nous vous recommandons de migrer vos applications Xamarin vers des infrastructures modernes comme MAUI. En savoir plus sur la dépréciation dans Annonce de la dépréciation à venir de MSAL.NET pour Xamarin et UWP.

À compter de MSAL.NET 2.4.0 (préversion), MSAL.NET prend en charge des navigateurs autres que Chrome. Il n’est plus nécessaire d’installer Chrome sur l’appareil Android pour l’authentification.

Nous vous recommandons d’utiliser les navigateurs qui prennent en charge les onglets personnalisés. Voici quelques exemples de ces navigateurs :

Navigateurs prenant en charge les onglets personnalisés Nom du package
Chrome com.android.chrome
Microsoft Edge com.microsoft.emmx
Firefox org.mozilla.firefox
Ecosia com.ecosia.android
Kiwi com.kiwibrowser.browser
Brave com.brave.browser

Outre l’identification des navigateurs qui offrent une prise en charge des onglets personnalisés, nos tests indiquent que quelques navigateurs qui ne prennent pas en charge les onglets personnalisés fonctionnent également pour l’authentification. Ces navigateurs incluent Opera, Opera Mini, InBrowser et Maxthon.

Appareils et navigateurs testés

Le tableau suivant répertorie les appareils et les navigateurs dont la compatibilité avec l’authentification a été testée.

Appareil Browser Résultats
Huawei/One+ Chrome* Réussite
Huawei/One+ Edge* Réussite
Huawei/One+ Firefox* Réussite
Huawei/One+ Brave* Réussite
One+ Ecosia* Réussite
One+ Kiwi* Réussite
Huawei/One+ Opera Réussite
Huawei OperaMini Réussite
Huawei/One+ InBrowser Réussite
One+ Maxthon Réussite
Huawei/One+ DuckDuckGo Authentification annulée par l’utilisateur
Huawei/One+ UC Browser Authentification annulée par l’utilisateur
One+ Dolphin Authentification annulée par l’utilisateur
One+ CM Browser Authentification annulée par l’utilisateur
Huawei/One+ Aucun installé Exception AndroidActivityNotFound

* Prend en charge des onglets personnalisés

Problèmes connus

Si l’utilisateur ne dispose d’aucun navigateur sur son appareil, MSAL.NET enverra une exception AndroidActivityNotFound.

  • Atténuation : Demandez à l’utilisateur d’activer un navigateur sur son appareil. Recommandez un navigateur prenant en charge les onglets personnalisés.

Si l’authentification échoue (par exemple, si l’authentification est lancée avec DuckDuckGo), MSAL.NET retourne AuthenticationCanceled MsalClientException.

  • Problème racine : Aucun navigateur prenant en charge les onglets personnalisés n’a été activé sur l’appareil. L’authentification a été lancée avec un navigateur qui n’a pas pu terminer l’authentification.
  • Atténuation : Demandez à l’utilisateur d’activer un navigateur sur son appareil. Recommandez un navigateur prenant en charge les onglets personnalisés.

Étapes suivantes

Pour plus d’informations et d’exemples de code, consultez les rubriques Choix entre le navigateur web incorporé et le navigateur système sur Xamarin Android et Interface utilisateur web incorporée ou système.