Inicio rápido: Enumerar etiquetas de confidencialidad: SDK de directivas (C++)

En este inicio rápido se muestra cómo usar el SDK de directivas 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:

• Complete el inicio rápido: Inicialización de la aplicación cliente - SDK de políticas (C++) primero, lo cual debe compilar una solución de inicio de Visual Studio.
• Opcionalmente: revise los conceptos de etiquetas de clasificación .

Agregar lógica para enumerar las etiquetas de sensibilidad

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. En la main() función , después de que el motor se cargue correctamente, agregue el código siguiente:

   // 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. Opcionalmente, filtre las etiquetas por formato de contenido (por ejemplo, "email" o "file"):

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

Crear y probar la aplicación

Compile y pruebe la aplicación cliente.

1. Utilice Ctrl+Mayús+B (Compilar solución) para construir 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 su entidad.

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 de tipo de protección de etiquetas para determinar cómo se comporta cada etiqueta. A partir del SDK de MIP 1.18, la Label clase proporciona métodos para comprobar el tipo de protección:

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

Pasos siguientes

• Acciones de directiva de proceso (C++)
• Tipos de protección de etiquetas
• Conceptos de etiquetas de clasificación
• Explore el ejemplo C++ del SDK de directivas de MIP en GitHub.