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

En este inicio rápido se explica cómo usar el SDK de protección de MIP a fin de mostrar las plantillas de protección disponibles para el usuario.

Requisitos previos

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

Adición de lógica para mostrar las plantillas de protección

Agregue lógica para mostrar las plantillas de protección disponibles para un usuario mediante el objeto del motor de protección.

  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 para el SDK de protección (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 Main(), encima de la sección de cierre de la aplicación de la función Main() (donde lo dejara en el inicio rápido anterior), inserte el código siguiente:

// List protection templates using protectionEngine and display the list

var templates=protectionEngine.GetTemplates();

for(int i = 0; i < templates.Count; i++)
{
    Console.WriteLine("{0}: {1}", i.ToString(), templates[i].Name + " : " + templates[i].Id);
}

Console.WriteLine("Press a key to continue...");

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, la salida de la consola debe mostrar las plantillas de protección para el usuario autenticado, de forma similar al ejemplo siguiente:

0: Confidential \ All Employees : a74f5027-f3e3-4c55-abcd-74c2ee41b607
1: Highly Confidential \ All Employees : bb7ed207-046a-4caf-9826-647cff56b990
2: Confidential : 174bc02a-6e22-4cf2-9309-cb3d47142b05
3: Contoso Employees Only : 667466bf-a01b-4b0a-8bbf-a79a3d96f720
Press a key to continue.

Nota

Copie y guarde el identificador de una o más de las plantillas de protección (por ejemplo, bb7ed207-046a-4caf-9826-647cff56b990), ya que lo usará en el próximo 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.

Pasos siguientes

Ahora que ha aprendido a mostrar las plantillas de protección disponibles para el usuario autenticado, pruebe el siguiente inicio rápido: