Inicio rápido: Listar etiquetas de sensibilidad - SDK de directivas (C#)

En este inicio rápido se muestra cómo usar el SDK de directivas de .NET de MIP para enumerar las etiquetas de confidencialidad configuradas para su organización.

Prerrequisitos

Si aún no lo ha hecho, asegúrese de completar los siguientes requisitos previos antes de continuar:

Agregar lógica para enumerar las etiquetas de confidencialidad

Agregue lógica para listar las etiquetas de confidencialidad de su organización mediante el objeto del motor de directivas.

  1. Abra la solución de Visual Studio que creó en el inicio rápido anterior.

  2. Una vez cargado el motor, agregue el código siguiente:

    // 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. Opcionalmente, filtre las etiquetas por formato de contenido:

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

Crear y probar la aplicación

Compile y pruebe la aplicación cliente.

  1. Usa Ctrl+Mayús+B (Compilar la solución) para compilar la aplicación. Si no tiene errores de compilación, use F5 (Iniciar depuración) para ejecutarlo.

  2. En la primera ejecución, la aplicación solicita autenticación. Proporcione credenciales para una cuenta de usuario en el inquilino.

  3. La salida muestra las etiquetas de confidencialidad configuradas para la organización, de forma similar a:

    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>

Comprobación del comportamiento de las etiquetas

También puede consultar la información del tipo de protección de la etiqueta. A partir del SDK de MIP 1.18, la Label clase proporciona propiedades para comprobar el tipo de protección:

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

Pasos siguientes

  • Last updated on