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

Ce guide de démarrage rapide vous montre comment utiliser le Kit de développement logiciel (SDK) de stratégie 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. Dans la main() fonction, une fois le moteur chargé, ajoutez le code suivant :

    // List sensitivity labels
cout << "\nSensitivity labels for your organization:\n";
auto labels = engine->ListSensitivityLabels();
for (const auto& label : labels)
{
    cout << label->GetName() << " : " << label->GetId() << endl;

    for (const auto& child : label->GetChildren())
    {
        cout << "->  " << child->GetName() << " : " << child->GetId() << endl;
    }
}

  3. Si vous le souhaitez, filtrez les étiquettes par format de contenu (par exemple, "email" ou "file") :

    // List labels for email content only
std::vector<std::string> contentFormats = { "email" };
auto emailLabels = engine->ListSensitivityLabels(contentFormats);

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 de type de protection des étiquettes pour déterminer le comportement de chaque étiquette. À compter du SDK MIP 1.18, la Label classe fournit des méthodes pour vérifier le type de protection :

for (const auto& label : labels)
{
    cout << label->GetName();
    
    if (label->HasDoNotForwardProtection())
        cout << " [Do Not Forward]";
    else if (label->HasEncryptOnlyProtection())
        cout << " [Encrypt Only]";
    else if (label->HasAdhocProtection())
        cout << " [Custom Protection]";
    
    cout << endl;
}

Étapes suivantes

  • Last updated on