Migrer des applications Android qui utilisent un répartiteur d’ADAL.NET vers MSAL.NET
Si vous avez une application Xamarin Android qui utilise actuellement Bibliothèque d’authentification Azure Active Directory pour .NET (ADAL.NET) et un répartiteur d’authentification, il est temps de migrer vers le bibliothèque d’authentification Microsoft pour .NET (MSAL.NET).
Prérequis
- Une application Xamarin Android déjà intégrée à un répartiteur (Microsoft Authenticator ou Portail d’entreprise Intune) et ADAL.NET que vous devez migrer vers 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.
Étape 1 : Activer le répartiteur
Code ADAL actuel : | Contrepartie MSAL : |
Dans ADAL.NET, la prise en charge du répartiteur est activée pour chaque contexte d’authentification.
Pour appeler le répartiteur, vous deviez définir un indicateur
Dans le code de rendu de page spécifique à la plateforme pour Android, vous définissez l’indicateur
Ensuite, incluez les paramètres dans l’appel d’acquisition de jeton :
|
Dans MSAL.NET, la prise en charge du répartiteur est activée pour chaque application cliente publique (PublicClientApplication).
Utilisez le paramètre
Ensuite, dans l’appel AcquireToken :
|
Étape 2 : Définir une activité
Dans ADAL.NET, vous avez passé une activité (généralement MainActivity) dans le cadre de PlatformParameters, comme indiqué dans Étape 1 : Activer le répartiteur.
MSAL.NET utilise également une activité, mais elle n’est pas requise dans le cas d’une utilisation Android normale sans répartiteur. Pour pouvoir utiliser le répartiteur, définissez l’activité pour qu’elle envoie et reçoive des réponses du répartiteur.
Code ADAL actuel : | Contrepartie MSAL : |
L’activité est transmise dans l’élément PlatformParameters de la plateforme spécifique à Android.
|
Dans MSAL.NET, effectuez deux opérations pour définir l’activité pour Android :
Par exemple : Dans App.cs :
Dans MainActivity.cs :
Dans l’appel AcquireToken :
|
Étapes suivantes
Pour plus d’informations sur les considérations spécifiques à Android lors de l’utilisation de MSAL.NET avec Xamarin, consultez Configuration requise et conseils de dépannage pour Xamarin Android avec MSAL.NET.
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour