Partager via

Tutoriel : Créer une application interpréteur de commandes .NET MAUI

  • Article

Ce tutoriel est la deuxième partie d’une série qui décrit comment créer une application interpréteur de commandes .NET Multi-Platform App UI (.NET MAUI). Dans la première partie de cette série, vous avez enregistré une application et configuré des flux d’utilisateurs dans votre locataire externe. Ce tutoriel décrit comment créer une application interpréteur de commandes .NET MAUI, ajouter une assistance pour le client Microsoft Authentication Library (MSAL) personnalisée pour initialiser le Kit de développement logiciel (SDK) MSAL, installer les bibliothèques requises et inclure une ressource d’image.

Dans ce didacticiel, vous allez :

  • Créer une application shell .NET MAUI.
  • Ajouter la prise en charge du SDK MSAL à l’aide de classes d’assistance MSAL.
  • Installer les packages nécessaires.
  • Ajouter une ressource d’image.

Prérequis

Créer une application .NET MAUI

  1. Dans la fenêtre de démarrage Visual Studio 2022, sélectionnez Créer un projet.
  2. Dans la fenêtre Créer un projet , sélectionnez MAUI dans la liste déroulante Tous les types de projets, sélectionnez le modèle application .NET MAUI, puis sélectionnez Suivant.
  3. Dans la fenêtre Configurer votre nouveau projet, le champ Nom du projet doit être défini sur SignInMaui. Mettez à jour le champ Nom de la solution par sign-in-maui et sélectionnez Suivant.
  4. Dans la fenêtre Informations complémentaires, sélectionnez .NET 7.0, puis Créer.

Attendez que le projet soit créé et ses dépendances restaurées.

Ajouter la prise en charge du SDK MSAL à l’aide de classes d’assistance MSAL

Le client MSAL permet aux développeurs d’obtenir des jetons de sécurité d’un locataire externe afin de s’authentifier et d’accéder à des API web sécurisées. Dans cette section, vous allez télécharger les fichiers qui composent MSALClient.

Téléchargez les fichiers suivants dans un dossier de votre ordinateur :

  • AzureAdConfig.cs : ce fichier permet d’obtenir et de définir les identificateurs uniques de l’application Microsoft Entra à partir du fichier de configuration d’application.
  • DownStreamApiConfig.cs : ce fichier permet d’obtenir et de définir les étendues de l’appel Microsoft Graph.
  • DownstreamApiHelper.cs : ce fichier permet de gérer les exceptions qui se produisent lors des appels d’API en aval.
  • Exception.cs : ce fichier offre plusieurs méthodes d’extension liées à la levée et à la gestion des exceptions.
  • IdentityLogger.cs : ce fichier décrit comment utiliser la journalisation MSAL.NET.
  • MSALClientHelper.cs : ce fichier contient des méthodes permettant d’initialiser le SDK MSAL.
  • PlatformConfig.cs : ce fichier contient des méthodes permettant de gérer une plateforme spécifique, comme Windows.
  • PublicClientSingleton.cs : ce fichier contient une implémentation singleton permettant d’encapsuler les classes MSALClient et associées. Cela permet de prendre en charge le modèle d’initialisation statique avec les plateformes.
  • WindowsHelper.cs : ce fichier contient des méthodes permettant de récupérer les descripteurs de fenêtre.

Important

Vous devez impérativement télécharger les fichiers MSALClient qui sont nécessaires à la réalisation de ce tutoriel.

Déplacer les fichiers MSALClient avec Visual Studio

  1. Dans le volet Explorateur de solutions, cliquez avec le bouton droit sur le projet SignInMaui, puis sélectionnez Ajouter >Nouveau dossier. Nommez le dossier MSALClient.
  2. Cliquez avec le bouton droit sur le dossier MSALClient, puis sélectionnez Ajouter >Élément existant….
  3. Accédez au dossier qui contient les fichiers MSALClient que vous avez précédemment téléchargés.
  4. Sélectionnez tous les fichiers MSALClient, puis sélectionnez Ajouter

Installer les packages nécessaires

Vous devez installer les packages suivants :

  • Microsoft.Identity.Client - Ce package contient les fichiers binaires de la bibliothèque d’authentification Microsoft pour .NET (MSAL.NET).
  • Microsoft.Extensions.Configuration.Json - Ce package contient l’implémentation du fournisseur de configuration JSON pour Microsoft.Extensions.Configuration.
  • Microsoft.Extensions.Configuration.Binder - Ce package contient une fonctionnalité permettant de lier un objet à des données dans les fournisseurs de configuration pour Microsoft.Extensions.Configuration.
  • Microsoft.Extensions.Configuration.Abstractions – Ce package contient des abstractions de la configuration avec paire clé-valeur.
  • Microsoft.Identity.Client.Extensions.Msal - Ce package contient des extensions à la bibliothèque d’authentification Microsoft pour .NET (MSAL.NET).

Gestionnaire de package NuGet

Pour utiliser le Gestionnaire de package NuGet et installer le package Microsoft.Identity.Client dans Visual Studio, procédez comme suit :

  1. Sélectionnez Outils>Gestionnaire de package NuGet>Gérer les packages NuGet pour la solution... .
  2. Sous l’onglet Parcourir, recherchez Microsoft.Identity.Client.
  3. Sélectionnez Microsoft.Identity.Client dans la liste.
  4. Sélectionnez SignInMaui dans le volet de la liste Projet.
  5. Sélectionnez Installer.
  6. Si une invite vous demande de vérifier l’installation, sélectionnez OK.

Répétez le processus pour installer les packages requis restants.

Ajouter une ressource d’image

Dans cette section, vous allez télécharger une image à utiliser dans l’application pour améliorer ses interactions utilisateur.

Téléchargez l’image suivante :

Déplacer l’image avec Visual Studio

  1. Dans le volet Explorateur de solutions de Visual Studio, développez le dossier Ressources qui comporte le dossier Images.
  2. Cliquez avec le bouton droit sur Images et sélectionnez Ajouter >Élément existant….
  3. Accédez au dossier contenant les images téléchargées.
  4. Remplacez « Filtrer par type de fichier » par Fichiers image.
  5. Sélectionnez l’image que vous avez téléchargée.
  6. Sélectionnez Ajouter.

Étape suivante

Partie 3 : connecter des utilisateurs dans l’application interpréteur de commandes .NET MAUI à l’aide d’un locataire externe