Inicio rápido: Inicialización de aplicaciones cliente para SDK de protección (C#)

Esta guía de inicio rápido le mostrará cómo implementar el patrón de inicialización del cliente, que usa el contenedor .NET del SDK de MIP en tiempo de ejecución.

Prerrequisitos

Si aún no lo ha hecho, asegúrese de:

• Complete los pasos descritos en Configuración y configuración del SDK de Microsoft Information Protection (MIP). Este inicio rápido de configuración del perfil y motor de protección se basa en la instalación y configuración de SDK adecuados.
• Opcionalmente:
  • Revise Objetos de perfil y motor. Los objetos de perfil y motor son conceptos universales, requeridos por los clientes que usan los SDK de archivo/política/protección de MIP.
  • Revise Conceptos de autenticación para obtener información sobre cómo el SDK y la aplicación cliente implementan la autenticación y el consentimiento.

Creación de una solución y un proyecto de Visual Studio

En primer lugar, se crearán y configurarán la solución y el proyecto iniciales de Visual Studio, en los que se basan los demás inicios rápidos.

1. Abra Visual Studio 2019 o posterior, seleccione el menú Archivo , Nuevo, Proyecto. En el cuadro de diálogo Nuevo proyecto

   • En el panel de la izquierda, en Instalados, Visual C#, seleccione Escritorio de Windows.

   • En el panel del centro, seleccione Aplicación de consola (.NET Framework).

   • En el panel inferior, actualice el nombre del proyecto, la ubicación y el nombre de la solución contenedora en consecuencia.

   • Cuando termine, haga clic en el botón Aceptar en la parte inferior derecha.

     

2. Agregue el paquete NuGet para el SDK de archivos MIP al proyecto:

   • En el Explorador de soluciones, haga clic con el botón derecho en el nodo del proyecto (directamente debajo del nodo principal o de la solución) y seleccione Administrar paquetes NuGet…:
   • Cuando se abra la pestaña Administrador de paquetes NuGet en el área de pestañas del grupo de editores:
     • Selecciona Examinar.
     • Escriba "Microsoft.InformationProtection" en el cuadro de búsqueda.
     • Seleccione el paquete "Microsoft.InformationProtection.File".
     • Haga clic en "Instalar" y, a continuación, haga clic en "Aceptar" cuando se muestre el cuadro de diálogo de confirmación Vista previa de cambios .

3. Repita los pasos anteriores para agregar el paquete del SDK de protección de MIP, pero agregue "Microsoft.IdentityModel.Clients.ActiveDirectory" a la aplicación.

Implementación de un delegado de autenticación y un delegado de consentimiento

Si aún no se ha implementado, siga los pasos indicados en Inicialización de la aplicación del SDK de archivos para implementar la autenticación y el delegado de consentimiento.

Inicialización del contenedor administrado del SDK de MIP

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

2. Quite la implementación generada de main().

3. El contenedor administrado incluye una clase estática, Microsoft.InformationProtection.MIP, que se usa para inicializar, crear MipContext, cargar perfiles y liberar recursos. Para inicializar el contenedor para las operaciones del SDK de archivo, llame a MIP.Initialize(), pasando MipComponent.Protection para cargar las bibliotecas necesarias para las operaciones de protección.

4. En Main(), en Program.cs, añada lo siguiente, sustituyendo <application-id> por el identificador del registro de aplicaciones de Microsoft Entra creado anteriormente.

using System;
using System.Threading.Tasks;
using Microsoft.InformationProtection;
using Microsoft.InformationProtection.Exceptions;
using Microsoft.InformationProtection.Protection;

namespace mip_sdk_dotnet_quickstart
{
    class Program
    {
        private const string clientId = "<application-id>";
        private const string appName = "<friendly-name>";

        static void Main(string[] args)
        {
            //Initialize Wrapper for Protection SDK operations
            MIP.Initialize(MipComponent.Protection);
        }
    }
}

Construcción de un perfil de protección y un motor

Como se mencionó, los objetos de perfil y motor son necesarios para los clientes del SDK que usan API de MIP. Complete la parte de codificación de este inicio rápido agregando código para cargar los archivos DLL nativos y, a continuación, cree una instancia de los objetos de perfil y motor.

using System;
using System.Threading.Tasks;
using Microsoft.InformationProtection;
using Microsoft.InformationProtection.Exceptions;
using Microsoft.InformationProtection.Protection;

namespace mip_sdk_dotnet_quickstart
{
     class Program
     {
          private const string clientId = "<application-id>";
          private const string appName = "<friendly-name>";

          static void Main(string[] args)
          {
               // Initialize Wrapper for Protection SDK operations.
               MIP.Initialize(MipComponent.Protection);

               // Create ApplicationInfo, setting the clientID from Azure AD App Registration as the ApplicationId.
               ApplicationInfo appInfo = new ApplicationInfo()
               {
                    ApplicationId = clientId,
                    ApplicationName = appName,
                    ApplicationVersion = "1.0.0"
               };

               // Instantiate the AuthDelegateImpl object, passing in AppInfo.
               AuthDelegateImplementation authDelegate = new AuthDelegateImplementation(appInfo);

               // Create MipConfiguration Object
               MipConfiguration mipConfiguration = new MipConfiguration(appInfo, "mip_data", LogLevel.Trace, false);

               // Create MipContext using Configuration
               mipContext = MIP.CreateMipContext(mipConfiguration);
                
               // Initialize and instantiate the ProtectionProfile.
               // Create the ProtectionProfileSettings object.
               // Initialize protection profile settings to create/use local state.
               var profileSettings = new ProtectionProfileSettings(mipContext,
                                        CacheStorageType.OnDiskEncrypted,                                        
                                        new ConsentDelegateImplementation());

               // Load the Profile async and wait for the result.
               var protectionProfile = Task.Run(async () => await MIP.LoadProtectionProfileAsync(profileSettings)).Result;

               // Create a ProtectionEngineSettings object, then use that to add an engine to the profile.
               var engineSettings = new ProtectionEngineSettings("user1@tenant.com", authDelegate, "", "en-US");
               engineSettings.Identity = new Identity("user1@tenant.com");
               var protectionEngine = Task.Run(async () => await protectionProfile.AddEngineAsync(engineSettings)).Result;

               // Application Shutdown
               // handler = null; // This will be used in later quick starts.
               protectionEngine = null;
               protectionProfile = null;
               mipContext = null;
          }
     }
}

3. Reemplace los valores de marcador de posición en el código fuente en el que se pegaron por los valores siguientes:

   Marcador de posición	Importancia	Ejemplo
   <application-id>	El identificador de aplicaciones de Microsoft Entra asignado a la aplicación registrada en “Instalación y configuración del SDK de MIP” (2 instancias).	0edbblll-8773-44de-b87c-b8c6276d41eb
   <nombre fácil de usar>	Nombre fácil de reconocer definido por el usuario para su aplicación.	AppInitialization

4. Ahora realice una compilación final de la aplicación y resuelva los errores. El código debe crearse correctamente.

Pasos siguientes

Ahora que el código de inicialización está completo, está listo para el siguiente inicio rápido, donde empezará a experimentar los SDK de protección de MIP.