Inicio rápido: Enumerar plantillas (C#)

En este inicio rápido se muestra cómo usar el SDK de protección de MIP para enumerar las plantillas de protección disponibles para el usuario.

Prerrequisitos

Complete los siguientes requisitos previos antes de continuar:

Agregar lógica para enumerar las plantillas de protección

Agregue lógica para enumerar 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 creó en el artículo anterior "Inicio rápido: inicialización de aplicaciones cliente : SDK de protección (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(), sobre la sección de cierre 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 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...");

Crear y probar la aplicación

Compile y pruebe la aplicación cliente.

  1. Usa Ctrl+Mayús+B (Compilar solución) para compilar la aplicación cliente. Si la compilación no tiene errores, use F5 (Iniciar depuración) para ejecutar la aplicación.

  2. Si el proyecto se compila y se ejecuta correctamente, es posible que la aplicación solicite autenticación mediante MSAL cada vez que el SDK llame al AcquireToken() método . Si ya existen credenciales almacenadas en caché, no se le pedirá que inicie sesión y vea la lista de etiquetas.

    Inicio de sesión mediante token de Visual Studio.

    • 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.

      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 varias de las plantillas de protección (por ejemplo, bb7ed207-046a-4caf-9826-647cff56b990), al usarlo 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?

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) salió con el código 0.

Presione cualquier tecla para cerrar esta ventana . . .		 Si su proyecto se compila correctamente, pero ve una salida similar a la mostrada a la izquierda, es probable que tenga un token no válido o expirado en el método AcquireOAuth2Token(). 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 verificar el token y sus afirmaciones mediante la aplicación web de página única jwt.ms.

Pasos siguientes

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

Inicio rápido: Cifrado y descifrado de texto

  • Se actualizó por última vez el