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 l'obsolescence dans Annonce de l'obsolescence à 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
Courageux 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 Navigateur Résultats
Huawei/One+ Chrome* Réussite
Huawei/One+ Bord* Réussite
Huawei/One+ Firefox* Réussite
Huawei/One+ Courageux* Réussite
Un+ Ecosia* Réussite
Un+ Kiwi* Réussite
Huawei/One+ Opéra Réussite
Huawei OperaMini Réussite
Huawei/One+ InBrowser Réussite
Un+ Maxthon Réussite
Huawei/One+ DuckDuckGo Authentification annulée par l’utilisateur
Huawei/One+ Navigateur UC Authentification annulée par l’utilisateur
Un+ Dauphin Authentification annulée par l’utilisateur
Un+ Navigateur CM 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.