Inicio rápido: Enumeración de etiquetas de confidencialidad (C#)

Artículo
01/30/2024

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

Requisitos previos

Si todavía no lo ha hecho, complete los siguientes requisitos previos antes de continuar:

Complete primero el Inicio rápido: Inicialización de aplicaciones cliente (C#), que compila una solución de inicio de Visual Studio. Este inicio rápido "Enumeración de etiquetas de confidencialidad" se basa en el anterior para crear correctamente la solución de inicio.
Opcional: revise los conceptos de etiquetas de clasificación.

Incorporación de lógica para enumerar etiquetas de confidencialidad

Agregue lógica para enumerar las etiquetas de confidencialidad de su organización con el objeto del motor de archivos.

Abra la solución de Visual Studio que creó en el artículo anterior "Inicio rápido: Inicialización de la aplicación cliente (C#)".
Con el Explorador de soluciones, abra el archivo .cs del proyecto que contiene la implementación del método Main(). De manera predeterminada, tiene el mismo nombre que el proyecto que lo contiene, que especificó al crear el proyecto.
Hacia la parte final del cuerpo de Main(), encima de la sección de apagado de la aplicación de la función Main() (donde lo ha dejado en el inicio rápido anterior), inserte el código siguiente:

// List sensitivity labels from fileEngine and display name and id
foreach(var label in fileEngine.SensitivityLabels)
{
    Console.WriteLine(string.Format("{0} : {1}", label.Name, label.Id));

    if (label.Children.Count != 0)
    {
        foreach (var child in label.Children)
        {
            Console.WriteLine(string.Format("{0}{1} : {2}", "\t",child.Name, child.Id));
        }
    }
}

Compilar y probar la aplicación

Finalmente, compile y pruebe la aplicación cliente.

Presione CTRL-MAYÚS-B (Compilar solución) para compilar la aplicación cliente. Si no hay errores de compilación, presione F5 (Iniciar depuración) para ejecutar la aplicación.
Si el proyecto se compila y ejecuta correctamente, es posible que la aplicación solicite autenticación mediante la biblioteca de autenticación de Microsoft (MSAL) cada vez que el SDK llame al método AcquireToken(). Si ya existen credenciales en caché, no se le pedirá que inicie sesión y verá la lista de etiquetas.
- Es posible que también deba dar su consentimiento para permitir que la aplicación acceda a las API de MIP mientras se ejecuta en la cuenta de inicio de sesión. Esto ocurre cuando el consentimiento al registro de la aplicación de Microsoft Entra no se ha dado previamente (como se describe en “Instalación y configuración del SDK de MIP”) o está iniciando sesión con una cuenta de otro inquilino (que no es donde está registrada la aplicación). Simplemente haga clic en Aceptar para registrar su consentimiento.
Después de la autenticación, la salida de la consola debe mostrar las etiquetas de confidencialidad, de manera similar al ejemplo siguiente:

Personal : 73c47c6a-eb00-4a6a-8e19-efaada66dee6
Public : 73254501-3d5b-4426-979a-657881dfcb1e
General : da480625-e536-430a-9a9e-028d16a29c59
Confidential : 569af77e-61ea-4deb-b7e6-79dc73653959
      Recipients Only (C) : d98c4267-727b-430e-a2d9-4181ca5265b0
      All Employees (C) : 2096f6a2-d2f7-48be-b329-b73aaa526e5d
      Anyone (not protected) (C) : 63a945ec-1131-420d-80da-2fedd15d3bc0
Highly Confidential : 905845d6-b548-439c-9ce5-73b2e06be157
      Recipients Only : 05ee72d9-1a75-441f-94e2-dca5cacfe012
      All Employees : 922b06ef-044b-44a3-a8aa-df12509d1bfe
      Anyone (not protected) : c83fc820-961d-40d4-ba12-c63f72a970a3
Press a key to continue.

Nota:

Copie y guarde el identificador de una o varias de las etiquetas de confidencialidad (por ejemplo, f42a3342-8706-4288-bd31-ebb85995028z), ya que lo usará en el inicio rápido siguiente.

Solución de problemas

Problemas durante la ejecución de la aplicación de C#

Resumen	Mensaje de error	Solución
Token de acceso incorrecto	Error de excepción… ¿el token de acceso es incorrecto o ha expirado? Error en la llamada API: profile_add_engine_async Error con: [class mip::PolicySyncException] Error al adquirir la directiva, Error de solicitud con código de estado HTTP: 401, x-ms-diagnostics: [2000001;reason="El token de OAuth enviado con la solicitud no se puede analizar.";error_category="invalid_token"], correlationId:[35bc0023-3727-4eff-8062-000006d5d672]' C:\VSProjects\MipDev\Quickstarts\AppInitialization\x64\Debug\AppInitialization.exe (proceso 29924) se cerró con el código 0. Presione cualquier tecla para cerrar esta ventana. . .	Si el proyecto se compila correctamente, pero observa resultados similares a la izquierda, es probable que tenga un token no válido o expirado en el método `AcquireOAuth2Token()`. Vuelva a Compilación y prueba de la aplicación y vuelva a generar el token de acceso, actualice de nuevo `AcquireOAuth2Token()` y vuelva a compilarla y probarla. También puede examinar y comprobar el token y sus notificaciones con la aplicación web de una sola página jwt.ms.
Las etiquetas de confidencialidad no están configuradas	N/D	Si el proyecto se compila correctamente, pero no tiene ningún resultado en la ventana de la consola, asegúrese de que las etiquetas de confidencialidad de su organización están configuradas correctamente. Consulte Instalación y configuración del SDK de MIP,en "Definición de la taxonomía de etiquetas y la configuración de protección" para más información.

Pasos siguientes

Ahora que aprendió a enumerar las etiquetas de confidencialidad de su organización, pruebe el inicio rápido siguiente:

Establecimiento y obtención de una etiqueta de confidencialidad

Compartir a través de