Démarrage rapide : Initialisation de l’application cliente pour les SDK de Protection (C#)

Ce guide de démarrage rapide vous montre comment implémenter le modèle d’initialisation du client que le SDK MIP .NET wrapper utilise au moment de l’exécution.

Note

Toute application cliente qui utilise le SDK de protection du wrapper MIP .NET nécessite les étapes décrites dans ce guide de démarrage rapide. Suivez ces guides de démarrage rapide en série après l’initialisation de l’application et l’implémentation des classes de délégué d’authentification et de délégué de consentement.

Prerequisites

Si ce n’est déjà fait, veillez à :

Créer une solution et un projet Visual Studio

Tout d’abord, créez et configurez la solution Visual Studio initiale et le projet sur lesquels reposent les autres guides de démarrage rapide.

  1. Ouvrez Visual Studio 2022 ou version ultérieure, sélectionnez le menu Fichier , Nouveau, Projet. Dans la boîte de dialogue Nouveau projet :

    • Dans le volet gauche, sous Installé, Visual C#, sélectionnez Windows Desktop.

    • Dans le volet central, sélectionnez Application console (.NET Framework).

    • Dans le volet inférieur, mettez à jour le nom du projet, l’emplacement et le nom de solution contenant en conséquence.

    • Lorsque vous avez terminé, sélectionnez OK dans le coin inférieur droit.

      Création de solution Visual Studio.

  2. Ajoutez le package NuGet pour le Kit de développement logiciel (SDK) MIP Protection à votre projet :

    • Dans Explorateur de solutions, cliquez avec le bouton droit sur le nœud de projet directement sous le nœud de solution supérieur, puis sélectionnez Gérer les packages NuGet... :
    • Lorsque l’onglet Gestionnaire de package NuGet s’ouvre dans la zone onglets Groupe d’éditeurs :
      • Sélectionnez Parcourir.
      • Entrez Microsoft.InformationProtection dans la zone de recherche.
      • Sélectionnez le Microsoft.InformationProtection.Protection package.
      • Sélectionnez Installer, puis sélectionnez OK lorsque la boîte de dialogue de confirmation des modifications d’aperçu s’affiche.

  3. Répétez les étapes précédentes, mais ajoutez cette fois-ci Microsoft.Identity.Client (MSAL) à l’application.

Si cela n’est pas déjà fait, suivez les étapes indiquées dans Initialisation de l’application SDK File pour mettre en œuvre le délégué d’authentification et de consentement.

Initialiser le wrapper managé du SDK MIP

  1. À partir de l’Explorateur de solutions, ouvrez le fichier .cs dans votre projet qui contient l’implémentation de la Main() méthode. Il a par défaut le même nom que le projet qui le contient, que vous avez spécifié lors de la création du projet.

  2. Supprimez l’implémentation générée de main().

  3. Le wrapper managé inclut une classe statique, Microsoft.InformationProtection.MIP, pour l’initialisation, la création d’un MipContext, le chargement de profils et la libération des ressources. Pour initialiser l’encapsuleur pour les opérations du SDK Protection, appelez MIP.Initialize() en y passant MipComponent.Protection afin de charger les bibliothèques nécessaires aux opérations de protection.

  4. Dans Main()Program.cs, ajoutez le code suivant, en <remplaçant l’ID d’application par l’ID> de l’inscription d’application Microsoft Entra que vous avez créée précédemment.

using System;
using System.Threading.Tasks;
using Microsoft.InformationProtection;
using Microsoft.InformationProtection.Exceptions;
using Microsoft.InformationProtection.Protection;

namespace mip_sdk_dotnet_quickstart
{
    class Program
    {
        private const string clientId = "<application-id>";
        private const string appName = "<friendly-name>";

        static void Main(string[] args)
        {
            //Initialize Wrapper for Protection SDK operations
            MIP.Initialize(MipComponent.Protection);
        }
    }
}

Construire un profil de protection et un moteur

Comme mentionné, les clients du KIT de développement logiciel (SDK) qui utilisent des API MIP nécessitent des objets de profil et de moteur. Terminez la partie de codage de ce guide de démarrage rapide en ajoutant du code pour charger les DLL natives, puis instanciez les objets de profil et de moteur.

using System;
using System.Threading.Tasks;
using Microsoft.InformationProtection;
using Microsoft.InformationProtection.Exceptions;
using Microsoft.InformationProtection.Protection;

namespace mip_sdk_dotnet_quickstart
{
     class Program
     {
          private const string clientId = "<application-id>";
          private const string appName = "<friendly-name>";

          static void Main(string[] args)
          {
               // Initialize Wrapper for Protection SDK operations.
               MIP.Initialize(MipComponent.Protection);

               // Create ApplicationInfo, setting the clientID from Azure AD App Registration as the ApplicationId.
               ApplicationInfo appInfo = new ApplicationInfo()
               {
                    ApplicationId = clientId,
                    ApplicationName = appName,
                    ApplicationVersion = "1.0.0"
               };

               // Instantiate the AuthDelegateImpl object, passing in AppInfo.
               AuthDelegateImplementation authDelegate = new AuthDelegateImplementation(appInfo);

               // Create MipConfiguration Object
               MipConfiguration mipConfiguration = new MipConfiguration(appInfo, "mip_data", LogLevel.Trace, false, CacheStorageType.OnDiskEncrypted);

               // Create MipContext using Configuration
               MipContext mipContext = MIP.CreateMipContext(mipConfiguration);
                
               // Initialize and instantiate the ProtectionProfile.
               // Create the ProtectionProfileSettings object.
               // Initialize protection profile settings to create/use local state.
               var profileSettings = new ProtectionProfileSettings(mipContext,
                                        CacheStorageType.OnDiskEncrypted,                                        
                                        new ConsentDelegateImplementation());

               // Load the Profile async and wait for the result.
               var protectionProfile = Task.Run(async () => await MIP.LoadProtectionProfileAsync(profileSettings)).Result;

               // Create a ProtectionEngineSettings object, then use that to add an engine to the profile.
               var engineSettings = new ProtectionEngineSettings("user1@tenant.com", authDelegate, "", "en-US");
               engineSettings.Identity = new Identity("user1@tenant.com");
               var protectionEngine = Task.Run(async () => await protectionProfile.AddEngineAsync(engineSettings)).Result;

               // Application Shutdown
               // handler = null; // This will be used in later quick starts.
               protectionEngine = null;
               protectionProfile = null;
               mipContext = null;
          }
     }
}

  1. Remplacez dans le code source que vous avez collé les valeurs de remplacement par les valeurs suivantes :

    Placeholder Valeur Example
    <id d’application> ID d’application Microsoft Entra affecté à l’application inscrite dans « Configuration et configuration du Kit de développement logiciel (SDK) MIP » (2 instances). 0000111-aaaa-2222-bbbb-3333cccc4444
    <nom convivial> Nom convivial défini par l’utilisateur pour votre application. Initialisation de l'application

  2. Effectuez maintenant une build finale de l’application et résolvez toutes les erreurs. Votre code doit se compiler avec succès.

Étapes suivantes

Maintenant que votre code d’initialisation est terminé, vous êtes prêt pour le démarrage rapide suivant, où vous commencerez à découvrir les SDK MIP Protection.

Répertorier les modèles de protection

  • Last updated on