Guida introduttiva: Visualizzare le etichette di sensibilità - Policy SDK (C++)

Questa guida introduttiva illustra come usare MIP Policy SDK per elencare le etichette di riservatezza configurate per l'organizzazione.

Prerequisiti

Se non è già stato fatto, assicurarsi di completare i prerequisiti seguenti prima di continuare:

Aggiungere la logica per elencare le etichette di riservatezza

Aggiungi la logica per elencare le etichette di riservatezza della tua organizzazione usando l'oggetto motore dei criteri.

  1. Aprire la soluzione di Visual Studio creata nell'avvio rapido precedente.

  2. main() Nella funzione, dopo il caricamento del motore, aggiungere il codice seguente:

    // 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. Facoltativamente, filtrare le etichette in base al formato del contenuto (ad esempio, "email" o "file"):

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

Compilare e testare l'applicazione

Compilare e testare l'applicazione client.

  1. Usare CTRL+MAIUSC+B (Compila soluzione) per compilare l'applicazione. Se non si verificano errori di compilazione, usare F5 (Avvia debug) per l'esecuzione.

  2. Alla prima esecuzione, l'applicazione richiede l'autenticazione. Fornire le credenziali per un account utente nel proprio tenant.

  3. L'output visualizza le etichette di riservatezza configurate per la tua organizzazione, simili alle seguenti:

    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>
    

Controllo del comportamento dell'etichetta

È anche possibile eseguire query sulle informazioni sul tipo di protezione delle etichette per determinare il comportamento di ogni etichetta. A partire da MIP SDK 1.18, la Label classe fornisce metodi per controllare il tipo di protezione:

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

Passaggi successivi