Inicio rápido: Enumeración de plantillas (C#)
En este inicio rápido, se muestra cómo usar el SDK de MIP para enumerar las plantillas de protección disponibles para el usuario.
Requisitos previos
Si todavía no lo ha hecho, complete los siguientes requisitos previos antes de continuar:
- Complete primero Inicio rápido: Inicialización de aplicaciones cliente para SDK de protección (C#), que compila una solución de inicio de Visual Studio. Este inicio rápido "Enumeración de plantillas de protección" se basa en el anterior para crear correctamente la solución de inicio.
- Opcional: revise los conceptos de plantillas de RMS.
Incorporación de lógica para enumerar las plantillas de protección
Agregue lógica a las plantillas de protección de lista disponibles para un usuario con el objeto de motor de Protection.
Abra la solución de Visual Studio que creó en el artículo anterior Inicio rápido: Inicialización de aplicaciones cliente para SDK de protección (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 del bloque de apagado de la aplicación de la funciónMain()(donde lo ha dejado 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
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 ADAL 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, el resultado 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 ), como 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. |
Pasos siguientes
Ahora que ha aprendido a enumerar las plantillas de protección disponibles para el usuario autenticado, pruebe la siguiente guía de inicio rápido: