Snabbstart: Ange och hämta en känslighetsetikett (C#)

Den här snabbstarten visar hur du använder fler MIP-fil-SDK:er. Med någon av de känslighetsetiketter som du angav i föregående snabbstart använder du en filhanterare för att ange/hämta etiketten på en fil. Klassen Filhanterare exponerar olika åtgärder för att ange/hämta etiketter eller skydd för filtyper som stöds.

Förutsättningar

Om du inte redan har gjort det måste du slutföra följande krav innan du fortsätter:

• Slutför snabbstart: Lista känslighetsetiketter (C#) först, som skapar en Visual Studio-startlösning, för att visa en organisations känslighetsetiketter. Snabbstarten "Ange och hämta en känslighetsetikett" bygger på den föregående.
• Alternativt: Granska filhanterare i MIP SDK-begreppen .

Lägga till logik för att ange och hämta en känslighetsetikett

Lägg till logik för att ange och hämta en känslighetsetikett på en fil med hjälp av filmotorobjektet.

1. Använd Solution Explorer och öppna .cs-filen i projektet 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. Mot slutet av brödtexten Main() , efter var fileEngine = och ovanför kommentaren //Application Shutdown , infogar du följande kod:

     //Set paths and label ID
     string inputFilePath = "<input-file-path>";
     string actualFilePath = inputFilePath;
     string labelId = "<label-id>";
     string outputFilePath = "<output-file-path>";
     string actualOutputFilePath = outputFilePath;
   
     //Create a file handler for that file
     //Note: the 2nd inputFilePath is used to provide a human-readable content identifier for admin auditing.
     var handler = Task.Run(async () => await fileEngine.CreateFileHandlerAsync(inputFilePath, actualFilePath, true)).Result;
   
     //Set Labeling Options
     LabelingOptions labelingOptions = new LabelingOptions()
     {
          AssignmentMethod = AssignmentMethod.Standard
     };
   
     // Set a label on input file
     handler.SetLabel(fileEngine.GetLabelById(labelId), labelingOptions, new ProtectionSettings());
   
     // Commit changes, save as outputFilePath
     var result = Task.Run(async () => await handler.CommitAsync(outputFilePath)).Result;
   
     // Create a new handler to read the labeled file metadata
     var handlerModified = Task.Run(async () => await fileEngine.CreateFileHandlerAsync(outputFilePath, actualOutputFilePath, true)).Result;
   
     // Get the label from output file
     var contentLabel = handlerModified.Label;
     Console.WriteLine(string.Format("Getting the label committed to file: {0}", outputFilePath));
     Console.WriteLine(string.Format("File Label: {0} \r\nIsProtected: {1}", contentLabel.Label.Name, contentLabel.IsProtectionAppliedFromLabel.ToString()));
     Console.WriteLine("Press a key to continue.");
     Console.ReadKey();
   

3. I slutet av Main() hitta programmets avstängningsblock som skapades i den första snabbstarten och avkommentera hanteringsraden:

   // Application Shutdown
   handler = null;
   fileEngine = null;
   fileProfile = null;
   mipContext = null;
   

4. Ersätt platshållarvärdena i källkoden med hjälp av följande värden:

   Platshållare	Värde
   <input-file-path>	Den fullständiga sökvägen till en testindatafil, till exempel: c:\\Test\\Test.docx.
   <etikett-ID>	Ett känslighetsetikett-ID som kopierades från konsolens utdata i föregående snabbstart, till exempel: f42a3342-8706-4288-bd31-ebb85995028z.
   <output-file-path>	Den fullständiga sökvägen till utdatafilen, som är en märkt kopia av indatafilen, till exempel: c:\\Test\\Test_labeled.docx.

Skapa och testa programmet

Skapa och testa klientprogrammet.

1. Använd CTRL-SHIFT-B (Build Solution) för att skapa klientprogrammet. Om du inte har några byggfel använder du F5 (Starta felsökning) för att köra programmet.

2. Om projektet byggs och körs korrekt kan programmet fråga efter autentisering via ADAL varje gång SDK anropar din AcquireToken() metod. Om cachelagrade autentiseringsuppgifter redan finns uppmanas du inte att logga in och se listan med etiketter, följt av informationen på den tillämpade etiketten och den ändrade filen.

Personal : 73c47c6a-eb00-4a6a-8e19-efaada66dee6
Public : 73254501-3d5b-4426-979a-657881dfcb1e
General : da480625-e536-430a-9a9e-028d16a29c59
Confidential : 569af77e-61ea-4deb-b7e6-79dc73653959
      Recipients Only (C) : d98c4267-727b-430e-a2d9-4181ca5265b0
      All Employees (C) : 2096f6a2-d2f7-48be-b329-b73aaa526e5d
      Anyone (not protected) (C) : 63a945ec-1131-420d-80da-2fedd15d3bc0
Highly Confidential : 905845d6-b548-439c-9ce5-73b2e06be157
      Recipients Only : 05ee72d9-1a75-441f-94e2-dca5cacfe012
      All Employees : 922b06ef-044b-44a3-a8aa-df12509d1bfe
      Anyone (not protected) : c83fc820-961d-40d4-ba12-c63f72a970a3
Press a key to continue.

 Applying Label ID 074e457c-5848-4542-9a6f-34a182080e7z to c:\Test\Test.docx
 Committing changes

 Label committed to file: c:\Test\Test_labeled.docx
 Press any key to continue.

 Getting the label committed to file: c:\Test\Test_labeled.docx
 File Label: Confidential
 IsProtected: false   
 Press any key to continue.

Du kan verifiera etikettens program genom att öppna utdatafilen och visuellt granska dokumentets inställningar för informationsskydd.

Kommentar

Om du etiketterar ett Office-dokument, men inte är inloggad med ett konto från Microsoft Entra-klientorganisationen där åtkomsttoken hämtades (och känslighetsetiketter har konfigurerats), kan du uppmanas att logga in innan du kan öppna det märkta dokumentet.