Snabbstart: Lista känslighetsetiketter – Policy SDK (C++)

Den här snabbstarten visar hur du använder MIP Policy SDK för att lista de känslighetsetiketter som konfigurerats för din organisation.

Förutsättningar

Om du inte redan har gjort det måste du slutföra följande krav innan du fortsätter:

• Slutför snabbstart: Initiering av klientprogram – Princip-SDK (C++) först, som skapar en Visual Studio-startlösning.
• Valfritt: Granska begrepp för klassificeringsetiketter .

Lägg till logik för att lista känslighetsetiketterna

Lägg till logik för att lista organisationens känslighetsetiketter med hjälp av principmotorobjektet.

1. Öppna Visual Studio-lösningen som du skapade i föregående snabbstart.

2. I funktionen main(), när motorn har lästs in utan problem, lägger du till följande kod:

   // 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. Du kan också filtrera etiketter efter innehållsformat (till exempel "email" eller "file"):

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

Skapa och testa programmet

Skapa och testa klientprogrammet.

1. Använd Ctrl+Skift+B (Bygglösning) för att skapa programmet. Om du inte har byggfel använder du F5 (Starta felsökning) för att köra.

2. Vid första körningen uppmanar programmet till autentisering. Ange autentiseringsuppgifter för ett användarkonto i din klientorganisation.

3. Resultatet visar de känslighetsetiketter som har konfigurerats för din organisation, ungefär så här:

   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>
   

Kontroll av etikettbeteende

Du kan också fråga efter information om etikettskyddstyp för att avgöra hur varje etikett beter sig. Från och med MIP SDK 1.18 Label tillhandahåller klassen metoder för att kontrollera skyddstypen:

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ästa steg

• Datorpolicyåtgärder (C++)
• Etikettskyddstyper
• Begrepp för klassificeringsetiketter
• Utforska MIP Policy SDK C++-exemplet på GitHub.