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.