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

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

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

Agregue la lógica necesaria para listar las etiquetas de confidencialidad de su organización usando el objeto de motor de archivos.

  1. Abra la solución de Visual Studio que creó en el artículo anterior "Inicio rápido: inicialización de aplicaciones cliente (C#)".

  2. En Explorador de soluciones, abra el archivo .cs en el proyecto que contiene la implementación del Main() método . El valor predeterminado es el mismo nombre que el proyecto que lo contiene, que especificó durante la creación del proyecto.

  3. Hacia el final del cuerpo de Main(), antes de la sección de apagado de la aplicación de la función Main() (donde lo dejó en la guía de inicio rápido anterior), inserte el siguiente código:

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

Crear y probar la aplicación

Compile y pruebe la aplicación cliente.

  1. Utiliza CTRL-SHIFT-B (Compilar Solución) para compilar tu aplicación cliente. Si no tiene errores de compilación, use F5 (Iniciar depuración) para ejecutar la aplicación.

  2. Si el proyecto se compila y se ejecuta correctamente, la aplicación podría solicitar la autenticación mediante Biblioteca de autenticación de Microsoft (MSAL) cada vez que el SDK llama al AcquireToken() método . Si ya existen credenciales almacenadas en caché, no se le pedirá que inicie sesión y verá la lista de etiquetas.

    Aviso de Visual Studio para iniciar sesión y adquirir el token.

    • Es posible que también tenga que 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 sucede cuando el registro de la aplicación Microsoft Entra no tiene consentimiento previo (como se describe en "Configuración y configuración del SDK de MIP"), o si inicia sesión con una cuenta de un inquilino diferente (distinto del que se registra la aplicación). Seleccione Aceptar para registrar el consentimiento.

      Aviso de consentimiento de Visual Studio.

  3. Después de la autenticación, la salida de la consola debe mostrar las etiquetas de sensibilidad, como en el siguiente ejemplo:

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 la usa en el siguiente inicio rápido.

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 Se produjo una excepción... ¿El token de acceso es incorrecto o ha expirado?

Llamada a la API fallida: profile_add_engine_async. Error: [class mip::PolicySyncException]. No se ha podido obtener la directiva. La solicitud ha fallado con el código de estado HTTP: 401, x-ms-diagnostics: [2000001;reason=No se puede analizar el token de OAuth enviado con la solicitud.; error_category=invalid_token], correlationId:[aaaa0000-bb11-2222-33cc-444444dddddd]'

C:\VSProjects\MipDev\Quickstarts\AppInitialization\x64\Debug\AppInitialization.exe (proceso 29924) salió con el código 0.

Presione cualquier tecla para cerrar esta ventana . . .		 Si el proyecto se compila correctamente, pero ve un resultado similar al de la izquierda, es probable que el token de su método AcquireOAuth2Token() sea inválido o haya expirado. Vuelva a Compilar y probar la aplicación y vuelva a generar el token de acceso, vuelva a actualizar AcquireOAuth2Token() y recompile o vuelva a probar. También puede examinar y validar el token y sus declaraciones mediante la aplicación web de una sola página jwt.ms.
Las etiquetas de confidencialidad no están configuradas n/a Si el proyecto se compila correctamente, pero no aparece ninguna salida en la ventana de la consola, asegúrese de que las etiquetas de confidencialidad de la organización están configuradas correctamente. Para obtener más información, consulte Configuración y configuración del SDK de MIP, en "Definir la taxonomía de etiquetas y la configuración de protección".

Pasos siguientes

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

Establecimiento y obtención de una etiqueta de confidencialidad

  • Last updated on