Schnellstart: Auflisten von Vertraulichkeitslabels – Policy SDK (C++)

In dieser Schnellstartanleitung erfahren Sie, wie Sie das MIP-Richtlinien-SDK verwenden, um die für Ihre Organisation konfigurierten Vertraulichkeitsbezeichnungen auflisten zu können.

Voraussetzungen

Falls noch nicht geschehen, stellen Sie sicher, dass Sie die folgenden Voraussetzungen erfüllen, bevor Sie fortfahren:

Hinzufügen von Logik zum Auflisten der Vertraulichkeitskennzeichnungen

Fügen Sie Logik hinzu, um die Vertraulichkeitsbezeichnungen Ihrer Organisation mithilfe des Richtlinienmodulobjekts auflisten zu können.

  1. Öffnen Sie die Visual Studio-Projektmappe, die Sie in der vorherigen Schnellstartanleitung erstellt haben.

  2. Fügen Sie in der main()-Funktion, nachdem die Engine erfolgreich geladen wurde, den folgenden Code hinzu:

    // 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. Optional können Sie Bezeichnungen nach Inhaltsformat filtern (z. B "email" . oder "file"):

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

Erstellen und Testen der Anwendung

Erstellen und testen Sie Ihre Clientanwendung.

  1. Verwenden Sie STRG+UMSCHALT+B (Lösung erstellen), um die Anwendung zu kompilieren. Wenn keine Buildfehler auftreten, verwenden Sie F5 (Debuggen starten), um auszuführen.

  2. Bei der ersten Ausführung fordert die Anwendung zur Authentifizierung auf. Geben Sie Anmeldeinformationen für ein Benutzerkonto in Ihrem Mandanten an.

  3. Die Ausgabe zeigt die für Ihre Organisation konfigurierten Vertraulichkeitsbezeichnungen an, ähnlich wie:

    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>
    

Überprüfen des Bezeichnungsverhaltens

Sie können auch Informationen zum Schutztyp von Labels abfragen, um zu bestimmen, wie sich die einzelnen Labels verhalten. Ab MIP SDK 1.18 stellt die Label Klasse Methoden zum Überprüfen des Schutztyps bereit:

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;
}

Nächste Schritte