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

S’applique à : Locataires de main-d’œuvre Locataires externes (en savoir plus)

Ce tutoriel fait partie 1 d’une série qui montre comment créer une application shell d’interface utilisateur d’application multiplateforme .NET (.NET MAUI). Ce tutoriel montre comment créer une application shell .NET MAUI, ajouter un helper client MSAL (Microsoft Authentication Library) personnalisé pour initialiser le SDK MSAL, installer les bibliothèques requises et inclure une ressource d’image.

Dans ce tutoriel, vous allez :

• Créez une application shell .NET MAUI.
• Ajoutez la prise en charge du Kit de développement logiciel (SDK) MSAL en utilisant des classes d’assistance MSAL.
• Installez les packages requis.
• Ajouter une ressource d’image.

Conditions préalables

• Inscrivez une nouvelle application dans le Centre d’administration Microsoft Entra, configurée pour les comptes dans cet annuaire organisationnel uniquement. Pour plus d’informations, reportez-vous à l'enregistrement d'une application. Enregistrez les valeurs suivantes à partir de la page Vue d’ensemble de l’application pour une utilisation ultérieure :
  • ID d’application (client)
  • ID d’annuaire (locataire)
• Associez votre application à un flux utilisateur dans le Centre d’administration Microsoft Entra. Ce flux utilisateur peut être utilisé sur plusieurs applications. Pour plus d’informations, consultez Créer des flux d’utilisateurs d’inscription en libre-service pour les applications dans des locataires externes et ajouter votre application au flux utilisateur.
• Kit de développement logiciel (SDK) .NET 7.0
• Visual Studio 2022 avec la charge de travail MAUI installée :
  • Instructions pour Windows
  • Instructions pour macOS

Créer une application .NET MAUI

1. Dans la fenêtre de démarrage de 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, et 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 supplémentaires , choisissez .NET 7.0, puis sélectionnez Créer.

Attendez que le projet soit créé et que ses dépendances soient 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’acquérir des jetons de sécurité auprès d’un locataire externe pour authentifier et accéder aux API web sécurisées. Dans cette section, vous téléchargez des fichiers qui composent MSALClient.

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

• AzureAdConfig.cs : ce fichier obtient et définit les identificateurs uniques de l’application Microsoft Entra à partir de votre fichier de configuration d’application.
• DownStreamApiConfig.cs - Ce fichier obtient et définit les étendues de l’appel Microsoft Graph.
• DownstreamApiHelper.cs : ce fichier gère les exceptions qui se produisent lors de l’appel de l’API en aval.
• Exception.cs - Ce fichier offre quelques 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 Kit de développement logiciel (SDK) MSAL.
• PlatformConfig.cs - Ce fichier contient des méthodes pour gérer une plateforme spécifique. Par exemple, Windows.
• PublicClientSingleton.cs : ce fichier contient une implémentation singleton pour encapsuler MSALClient et les classes associées pour prendre en charge le modèle d’initialisation statique pour les plateformes.
• WindowsHelper.cs - Ce fichier contient des méthodes pour récupérer le handle de fenêtre.

Important

N’ignorez pas le téléchargement des fichiers MSALClient, ils sont nécessaires pour suivre ce didacticiel.

Déplacer les fichiers MSALClient avec Visual Studio

1. Dans le volet de l’Explorateur de solutions , cliquez avec le bouton droit sur le projet SignInMaui, puis sélectionnez Ajouternouveau 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 téléchargés précédemment.
4. Sélectionnez tous les fichiers MSALClient, puis sélectionnez Ajouter

Installer les packages requis

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 des fonctionnalités permettant de lier un objet à des données dans des fournisseurs de configuration pour Microsoft.Extensions.Configuration.
• Microsoft.Extensions.Configuration.Abstractions - Ce package contient des abstractions de la configuration basée sur une paire clé-valeur.
• Microsoft.Identity.Client.Extensions.Msal - Ce package contient des extensions de la bibliothèque d’authentification Microsoft pour .NET (MSAL.NET).

Gestionnaire de package NuGet

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

1. Sélectionnez Tools>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 vous êtes invité à 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 téléchargez une image que vous utilisez dans votre application pour améliorer la façon dont les utilisateurs interagissent avec celui-ci.

Téléchargez l’image suivante :

• icône : Microsoft Entra ID : cette image est utilisée comme icône dans la page principale.

Déplacer l’image avec Visual Studio

1. Dans le volet de l’Explorateur de solutions de Visual Studio, étendez le dossier Resources, ce qui révèle le dossier Images.
2. Cliquez avec le bouton droit sur Images, puis sélectionnez Ajouter>élément existant....
3. Accédez au dossier qui contient 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 : Connexion des utilisateurs dans l’application shell .NET MAUI à l’aide d’un tenant externe