Guida introduttiva: Elencare le etichette di riservatezza - Policy SDK (C#)

Questa guida introduttiva illustra come usare MIP .NET 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. Dopo il caricamento del motore, aggiungere il codice seguente:

    // 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. Facoltativamente, filtrare le etichette in base al formato del contenuto:

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

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. A partire da MIP SDK 1.18, la Label classe fornisce proprietà per controllare il tipo di protezione:

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

Passaggi successivi