Démarrage rapide : Répertorier les étiquettes de confidentialité (C#)

Ce guide de démarrage rapide vous montre comment utiliser le Kit de développement logiciel (SDK) de fichier MIP pour répertorier les étiquettes de confidentialité configurées pour votre organisation.

Prérequis

Si ce n’est déjà fait, veillez à remplir les conditions préalables suivantes avant de continuer :

Ajouter une logique pour répertorier les étiquettes de confidentialité

Ajoutez une logique pour répertorier les étiquettes de confidentialité de votre organisation à l’aide de l’objet moteur de fichiers.

  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 (C#) ».

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

  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 sensitivity labels from fileEngine and display name and id
foreach(var label in fileEngine.SensitivityLabels)
{
    Console.WriteLine(string.Format("{0} : {1}", label.Name, label.Id));

    if (label.Children.Count != 0)
    {
        foreach (var child in label.Children)
        {
            Console.WriteLine(string.Format("{0}{1} : {2}", "\t",child.Name, child.Id));
        }
    }
}

Concevoir et tester l’application

Enfin, générez et testez votre application cliente.

  1. 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.

  2. Si votre projet génère et s’exécute correctement, l’application peut demander l’authentification à l’aide de Microsoft Authentication Library (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.

    Acquisition de jeton de connexion dans Visual Studio

    • 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.

      Consentement de Visual Studio

  3. Après l’authentification, la sortie de votre console doit afficher les étiquettes de confidentialité, comme dans l’exemple suivant :

Personal : 73c47c6a-eb00-4a6a-8e19-efaada66dee6
Public : 73254501-3d5b-4426-979a-657881dfcb1e
General : da480625-e536-430a-9a9e-028d16a29c59
Confidential : 569af77e-61ea-4deb-b7e6-79dc73653959
      Recipients Only (C) : d98c4267-727b-430e-a2d9-4181ca5265b0
      All Employees (C) : 2096f6a2-d2f7-48be-b329-b73aaa526e5d
      Anyone (not protected) (C) : 63a945ec-1131-420d-80da-2fedd15d3bc0
Highly Confidential : 905845d6-b548-439c-9ce5-73b2e06be157
      Recipients Only : 05ee72d9-1a75-441f-94e2-dca5cacfe012
      All Employees : 922b06ef-044b-44a3-a8aa-df12509d1bfe
      Anyone (not protected) : c83fc820-961d-40d4-ba12-c63f72a970a3
Press a key to continue.

Remarque

Copiez et enregistrez l’ID d’une ou plusieurs étiquettes de confidentialité (par exemple, f42a3342-8706-4288-bd31-ebb85995028z), car 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 API : profile_add_engine_async a échoué avec : [class mip::PolicySyncException] Échec de l’acquisition de la stratégie, la requête a échoué avec le code d’état HTTP 401, x-ms-diagnostics : [2000001;reason="Le jeton OAuth envoyé avec la requête ne peut pas être analysé.";error_category="invalid_token"], correlationId:[aaaa0000-bb11-2222-33cc-444444dddddd]

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 est correctement généré, mais que la sortie est similaire à l’exemple à gauche, il est probable que votre méthode AcquireOAuth2Token() soit invalide et ait expiré. 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.
Les étiquettes de confidentialité ne sont pas configurées n/a Si votre projet s’exécute correctement, mais que vous n’avez pas de sortie dans la fenêtre de console, vérifiez que les étiquettes de confidentialité de votre organisation sont correctement configurées. Pour plus d’informations, consultez la configuration et la configuration du SDK MIP, sous « Définir les paramètres de taxonomie et de protection des étiquettes ».

Prochaines étapes

Maintenant que vous avez appris à répertorier les étiquettes de confidentialité de votre organisation, essayez le guide de démarrage rapide suivant :

Définir et obtenir une étiquette de confidentialité

  • Last updated on