Inicio rápido: Mostrar etiquetas de confidencialidad (C#)

En este inicio rápido se muestra cómo usar el SDK de archivo de MIP a fin de crear una lista de las etiquetas de confidencialidad configuradas para su organización.

Requisitos previos

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

Agregar una lógica para mostrar una lista de las etiquetas de confidencialidad

Agregue una lógica para mostrar una lista de las etiquetas de confidencialidad de la organización con el objeto del motor de archivo.

  1. Abra la solución de Visual Studio que ha creado en el artículo anterior “Inicio rápido: Inicialización de la aplicación cliente (C#)”.

  2. Desde el Explorador de soluciones, abra el archivo .cs en el proyecto que contiene la implementación del método . El valor predeterminado es el mismo nombre que el proyecto que lo contiene, el cual ha especificado al crear el proyecto.

  3. Cerca del final del cuerpo de Main(), encima de la sección de cierre de la aplicación de la función Main() (donde haya terminado 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

Compile y pruebe la aplicación cliente.

  1. Presione CTRL-SHIFT-B (Compilar solución) para compilar la aplicación cliente. Si no aparece ningún error de compilación, presione 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 autenticación vía ADAL cada vez que el SDK llame al método . Si ya existen credenciales almacenadas en caché, no se pedirá que inicie sesión y vea la lista de etiquetas.

    Inicio de sesión para la obtención del token por Visual Studio

    • Puede que también necesite conceder permiso para que la aplicación acceda a las API de MIP mientras se ejecuta con la cuenta de inicio de sesión. Esto ocurre cuando no se concede de forma previa el registro de la aplicación de Azure AD (como se indica en “Instalación y configuración del SDK de MIP”), o bien si ha iniciado sesión con una cuenta desde otro inquilino (un inquilino donde no se ha registrado la aplicación). Solo tiene que hacer clic en Aceptar para registrar el consentimiento.

      Consentimiento de Visual Studio

  3. Después de la autenticación, en la salida de la consola se mostrarán las etiquetas de confidencialidad, de forma 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 más de las etiquetas de confidencialidad (por ejemplo, f42a3342-8706-4288-bd31-ebb85995028z), ya que las usará en la próxima guía de inicio rápido.

Solución de problemas

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

Resumen Mensaje de error Solución
Token de acceso incorrecto Se ha producido una excepción... ¿El token de acceso es incorrecto o ha expirado?

Error de llamada API: profile_add_engine_async Error con: [class mip::PolicySyncException] Error en la adquisición de la directiva, Error en la solicitud web 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:[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 se muestra un resultado similar al que aparece a la izquierda, es probable que tenga un token no válido o expirado en el método AcquireOAuth2Token(). Vuelva al paso Compilar y probar la aplicación y genere de nuevo el token de acceso, vuelva a actualizar y, por último, repita la compilación y las pruebas. También puede examinar y verificar el token y sus notificaciones con la aplicación web de una página jwt.ms.
Las etiquetas de confidencialidad no se han configurado n/a Si el proyecto se compila correctamente, pero no se muestra ningún resultado en la ventana de la consola, asegúrese de que las etiquetas de confidencialidad de la organización se hayan configurado correctamente. Para obtener más información, vea Instalación y configuración del SDK de MIP en “Definir la configuración de protección y taxonomía de etiquetas”.

Pasos siguientes

Ahora que ya conoce cómo mostrar una lista de las etiquetas de confidencialidad de la organización, pruebe la siguiente guía de inicio rápido: