Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
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
Si ce n’est déjà fait, veillez à remplir les conditions préalables suivantes avant de continuer :
- Démarrage rapide complet : Initialisation de l’application cliente - Kit de développement logiciel (SDK) Protection (C#), qui génère d’abord une solution Visual Studio de démarrage. Ce « Démarrage rapide: Liste des modèles de protection » s’appuie sur le précédent pour la création appropriée de la solution initiale.
- Si vous le souhaitez , 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.
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#) ».
À l’aide 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.Vers la fin du corps de
Main(), au-dessus de la section d'arrêt de l'application de laMain()fonction (où vous vous êtes arrêté dans le guide de démarrage rapide précédent), 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
Enfin, générez et testez votre application cliente.
Utilisez ctrl-SHIFT-B (générer la solution) pour générer votre application cliente. Si vous n’avez aucune erreur de build, utilisez F5 (Démarrer le débogage) pour exécuter votre application.
Si votre projet génère et s’exécute correctement, l’application peut demander l’authentification via MSAL chaque fois que le SDK appelle votre
AcquireToken()méthode. Si des informations d’identification mises en cache existent déjà, vous ne serez pas invité à vous connecter et à voir la liste des étiquettes.Vous devrez peut-être également donner votre consentement pour autoriser l’application à accéder aux API MIP, tout en s’exécutant 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). Cliquez simplement sur Accepter pour enregistrer votre consentement.
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.
Note
Copiez et enregistrez l’ID d’un ou plusieurs des modèles de protection (par exemple), bb7ed207-046a-4caf-9826-647cff56b990car vous l’utiliserez dans le guide de démarrage rapide suivant.
Résolution des problèmes
Problèmes lors de l’exécution de l’application C#
| Résumé | Message d'erreur | Solution |
|---|---|---|
| Jeton d’accès incorrect |
Une exception s’est produite... Le jeton d’accès est-il incorrect/expiré ? Échec de l’appel d’API : profile_add_engine_async Échoué avec : [class mip::PolicySyncException] Échec de l’acquisition de la stratégie, la demande a échoué avec le code d'état HTTP : 401, x-ms-diagnostics : [2000001 ; raison="Le jeton OAuth soumis avec la demande ne peut pas être analysé." ; erreur_catégorie="invalid_token"], correlationId:[35bc0023-3727-4eff-8062-000006d5d672] C:\VSProjects\MipDev\Quickstarts\AppInitialization\x64\Debug\AppInitialization.exe (processus 29924) quitté avec le code 0. Appuyez sur n’importe quelle touche pour fermer cette fenêtre. . . |
Si votre projet se génère correctement, mais que vous voyez une sortie similaire à celle de gauche, vous avez probablement un jeton non valide ou expiré dans la méthode AcquireOAuth2Token(). Revenez à Build et testez l’application et régénérez le jeton d’accès, mettez à jour AcquireOAuth2Token() à nouveau et retestez/régénérez. Vous pouvez également examiner et vérifier le jeton et ses revendications à l’aide de l’application web à page unique jwt.ms. |
Prochaines étapes
Maintenant que vous avez appris à répertorier les modèles de protection disponibles pour l’utilisateur authentifié, essayez le guide de démarrage rapide suivant :