Démarrage rapide : Répertorier les étiquettes de sensibilité - Kit de développement logiciel (SDK) de stratégie (C#)

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

Prerequisites

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 la logique permettant de lister les étiquettes de sensibilité de votre organisation à l’aide de l’objet Policy engine.

  1. Ouvrez la solution Visual Studio que vous avez créée dans le guide de démarrage rapide précédent.

  2. Une fois le moteur chargé, ajoutez le code suivant :

    // List sensitivity labels
Console.WriteLine("\nSensitivity labels for your organization:");
var labels = engine.ListSensitivityLabels();
foreach (var label in labels)
{
    Console.WriteLine($"{label.Name} : {label.Id}");

    foreach (var child in label.Children)
    {
        Console.WriteLine($"->  {child.Name} : {child.Id}");
    }
}

  3. Si vous le souhaitez, filtrez les étiquettes par format de contenu :

    // List labels for email content only
var emailLabels = engine.ListSensitivityLabels(new string[] { "email" });

Concevoir et tester l’application

Générez et testez votre application cliente.

  1. Utilisez Ctrl+Maj+B (Build Solution) pour générer l’application. Si vous n’avez pas d’erreurs de build, utilisez F5 (Démarrer le débogage) pour s’exécuter.

  2. Lors de la première exécution, l’application demande l’authentification. Fournissez des informations d’identification pour un compte d’utilisateur dans votre locataire.

  3. La sortie affiche les étiquettes de confidentialité configurées pour votre organisation, comme suit :

    Sensitivity labels for your organization:
Public : <label-id>
General : <label-id>
->  Anyone (unrestricted) : <label-id>
Confidential : <label-id>
->  All Employees : <label-id>
->  Recipients Only : <label-id>
Highly Confidential : <label-id>
->  All Employees : <label-id>
->  Recipients Only : <label-id>

Vérification du comportement des étiquettes

Vous pouvez également interroger les informations sur le type de protection d'étiquette. À compter du SDK MIP 1.18, la Label classe fournit des propriétés pour vérifier le type de protection :

foreach (var label in labels)
{
    Console.Write(label.Name);

    if (label.HasDoNotForwardProtection)
        Console.Write(" [Do Not Forward]");
    else if (label.HasEncryptOnlyProtection)
        Console.Write(" [Encrypt Only]");
    else if (label.HasAdhocProtection)
        Console.Write(" [Custom Protection]");

    Console.WriteLine();
}

Étapes suivantes

  • Last updated on