Snabbstart: Initiering av klientprogram för Skydds-SDK:er (C#)

Den här snabbstarten visar hur du implementerar det klientinitieringsmönster som MIP SDK .NET wrapper använder vid körning.

Anmärkning

Alla klientprogram som använder MIP-.NET wrapperns Skydds-SDK kräver stegen i den här snabbstarten. Slutför dessa snabbstarter seriellt efter programinitiering och implementering av klasser för autentiseringsdelegat och medgivandedelegering.

Förutsättningar

Om du inte redan har gjort det bör du:

• Slutför stegen i Installation och konfiguration av Microsoft Information Protection (MIP) SDK. Den här snabbstarten "Skyddsprofil och motorkonfiguration" bygger på korrekt SDK-konfiguration.
• Valfritt:
  • Granska profil- och motorobjekt. Profil- och engine-objekten är universella begrepp som krävs av klienter som använder SDK:er för MIP-fil/policy/skydd.
  • Läs Autentiseringsbegrepp för att lära dig hur autentisering och medgivande implementeras av SDK och klientprogrammet.

Skapa en Visual Studio-lösning och ett projekt

Skapa och konfigurera först den första Visual Studio lösning och projekt som de andra snabbstarterna bygger på.

1. Öppna Visual Studio 2022 eller senare, välj Arkiv-menyn, Nytt, Projekt. I dialogrutan Nytt projekt :

   • I den vänstra rutan, under Installerad, Visual C#, väljer du Windows Desktop.

   • I mittenfönstret väljer du Konsolapp (.NET Framework).

   • I den nedre rutan uppdaterar du projektets namn, plats och det innehållande lösningsnamnet i enlighet med detta.

   • När du är klar väljer du OK i det nedre högra hörnet.

     

2. Lägg till NuGet-paketet för MIP Protection SDK i projektet:

   • I Prieskumník riešení högerklickar du på projektnoden direkt under den översta lösningsnoden och väljer sedan Hantera NuGet-paket...:
   • När fliken NuGet Správca balíkov öppnas i området Redigerargruppflikar:
     • Välj bläddra.
     • Ange Microsoft.InformationProtection i sökrutan.
     • Välj paketet Microsoft.InformationProtection.Protection .
     • Välj Installera och välj sedan OK när bekräftelsedialogrutan Förhandsgranskningsändringar visas.

3. Upprepa föregående steg, men lägg i stället till Microsoft.Identity.Client (MSAL) i programmet.

Implementera en autentiseringsdelegat och ett medgivandedelegat

Om det inte redan har implementerats följer du stegen i Initieringen av File SDK-programmet för att implementera autentiserings- och medgivandedelegaten.

Initiera den hanterade MIP SDK-wrappern

1. Från Prieskumník riešení, öppna .cs-filen i ditt projekt som innehåller implementeringen av Main()-metoden. Det är som standard samma namn som det projekt som innehåller det, som du angav när projektet skapades.

2. Ta bort den genererade implementeringen av main().

3. Det hanterade omslaget innehåller en statisk klass, Microsoft.InformationProtection.MIP, för initiering, skapande av en MipContext, inläsning av profiler och frigöring av resurser. Om du vill initiera wrappern för Protection SDK-åtgärder anropar du MIP.Initialize() och skickar med MipComponent.Protection för att läsa in de bibliotek som behövs för skyddsoperationer.

4. I Main()Program.cs lägger du till följande kod och ersätter <program-ID> med ID:t för den Microsoft Entra programregistrering som du skapade tidigare.

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);
        }
    }
}

Skapa en skyddsprofil och -motor

Som nämnts kräver SDK-klienter som använder MIP-API:er profil- och motorobjekt. Slutför kodningsdelen av den här snabbstarten genom att lägga till kod för att läsa in de interna DLL:erna och sedan instansiera profil- och motorobjekten.

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. Ersätt platshållarvärdena i källkoden som du klistrade in med hjälp av följande värden:

   Placeholder	Värde	Example
   <application-id>	Microsoft Entra-program-ID som tilldelats programmet registrerat i "MIP SDK-installation och -konfiguration" (2 instanser).	00001111-aaaa-2222-bbbb-3333cccc4444
   <vänligt namn>	Ett användardefinierat eget namn för ditt program.	AppInitialisering

4. Gör nu en slutlig version av programmet och lös eventuella fel. Din kod bör bygga framgångsrikt.

Nästa steg

Nu när initieringskoden är klar är du redo för nästa snabbstart, där du börjar uppleva MIP Protection SDK:erna.

Lista skyddsmallar

• Utforska MIP Protection SDK .NET exempel på GitHub.