Démarrage rapide : Répertorier les modèles (C#)

Ce guide de démarrage rapide vous montre comment utiliser le Kit de développement logiciel (SDK) MIP Protection pour répertorier les modèles de protection disponibles pour l’utilisateur.

Prerequisites

Remplissez les conditions préalables suivantes avant de continuer :

• Suivez le Démarrage rapide : initialisation des applications clientes - kit de développement logiciel (SDK) Protection (C#), pour créer une solution Visual Studio de démarrage. Ce guide de démarrage rapide « Répertorier les modèles de protection » s’appuie sur le guide de démarrage rapide précédent pour créer correctement la solution de démarrage.
• Facultatif : passez en revue les concepts des modèles RMS .

Ajouter une logique pour répertorier les modèles de protection

Ajoutez une logique pour répertorier les modèles de protection disponibles pour un utilisateur à l’aide de l’objet moteur de protection.

1. Ouvrez la solution Visual Studio que vous avez créée dans l’article précédent « Démarrage rapide - Initialisation de l’application cliente - Kit de développement logiciel (SDK) Protection (C#) ».

2. Dans 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.

3. Vers la fin du corps Main(), au-dessus de la section d’arrêt d’application de la fonction Main() (là où vous vous êtes arrêté dans le précédent démarrage rapide), insérez le code suivant :

// List protection templates using protectionEngine and display the list

var templates=protectionEngine.GetTemplates();

for(int i = 0; i < templates.Count; i++)
{
    Console.WriteLine("{0}: {1}", i.ToString(), templates[i].Name + " : " + templates[i].Id);
}

Console.WriteLine("Press a key to continue...");

Concevoir et tester l’application

Générez et testez votre application cliente.

1. Utilisez Ctrl+Maj+B (Build Solution) pour générer votre application cliente. Si la build n’a aucune erreur, utilisez F5 (Démarrer le débogage) pour exécuter votre application.

2. Si votre projet génère et s’exécute correctement, l’application peut demander l’authentification à l’aide de MSAL chaque fois que le SDK appelle votre AcquireToken() méthode. Si des informations d’identification mises en cache existent déjà, vous n’êtes pas invité à vous connecter et voir la liste des étiquettes.

   

   • Vous devrez peut-être également donner son consentement pour autoriser l’application à accéder aux API MIP lors de l’exécution sous le compte de connexion. Cela se produit lorsque l’inscription de l’application Microsoft Entra n’est pas préalablement consentée (comme indiqué dans « Configuration et configuration du SDK MIP ») ou que vous vous connectez avec un compte à partir d’un autre locataire (autre que celui où votre application est inscrite). Sélectionnez Accepter pour enregistrer votre consentement.

     

3. Après l’authentification, la sortie de votre console doit afficher les modèles de protection pour l’utilisateur authentifié, comme dans l’exemple suivant :

0: Confidential \ All Employees : a74f5027-f3e3-4c55-abcd-74c2ee41b607
1: Highly Confidential \ All Employees : bb7ed207-046a-4caf-9826-647cff56b990
2: Confidential : 174bc02a-6e22-4cf2-9309-cb3d47142b05
3: Contoso Employees Only : 667466bf-a01b-4b0a-8bbf-a79a3d96f720
Press a key to continue.

Résolution des problèmes

Problèmes lors de l’exécution de l’application C#

Étapes suivantes

Maintenant que vous avez appris à répertorier les modèles de protection disponibles pour un utilisateur authentifié, essayez le guide de démarrage rapide suivant :

• Explorez l’exemple de sdk MIP Protection .NET sur GitHub.