Quickstart: Een vertrouwelijkheidslabel instellen en ophalen (C#)

In deze quickstart ziet u hoe u meer VAN de MIP-bestands-SDK's gebruikt. Met behulp van een van de vertrouwelijkheidslabels die u in de vorige quickstart hebt vermeld, gebruikt u een bestandshandler om het label op een bestand in te stellen/op te halen. De klasse Bestandshandler bevat verschillende bewerkingen voor het instellen/verkrijgen van labels of beveiliging voor ondersteunde bestandstypen.

Vereisten

Als u dat nog niet hebt gedaan, moet u de volgende vereisten voltooien voordat u doorgaat:

• Volledige quickstart: Vertrouwelijkheidslabels (C#) eerst vermelden, waarmee een eenvoudige Visual Studio-oplossing wordt gemaakt om de vertrouwelijkheidslabels van een organisatie weer te geven. Deze quickstart 'Een vertrouwelijkheidslabel instellen en ophalen' bouwt voort op de vorige.
• Optioneel: Controleer bestandshandlers in de MIP SDK-concepten .

Logica toevoegen om een vertrouwelijkheidslabel in te stellen en op te halen

Voeg logica toe om een vertrouwelijkheidslabel in een bestand in te stellen en op te halen met behulp van het object File Engine.

1. Open met Solution Explorer het .cs-bestand in uw project dat de implementatie van de methode Main() bevat. Deze wordt standaard ingesteld op dezelfde naam als het project dat het bevat, die u hebt opgegeven tijdens het maken van het project.

2. Voeg aan het einde van de Main() hoofdtekst, na var fileEngine = en boven de //Application Shutdown opmerking, de volgende code in:

     //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. Aan het einde van het zoeken naar het afsluitblok van Main() de toepassing dat in de eerste quickstart is gemaakt en de opmerkingen bij de handlerregel ongedaan maken:

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

4. Vervang de tijdelijke aanduidingen in de broncode met behulp van de volgende waarden:

   Tijdelijke aanduiding	Waarde
   <input-file-path>	Het volledige pad naar een testinvoerbestand, bijvoorbeeld: c:\\Test\\Test.docx.
   <label-id>	Een vertrouwelijkheidslabel-id, gekopieerd uit de console-uitvoer in de vorige quickstart, bijvoorbeeld: f42a3342-8706-4288-bd31-ebb85995028z.
   <output-file-path>	Het volledige pad naar het uitvoerbestand, een gelabelde kopie van het invoerbestand, bijvoorbeeld: c:\\Test\\Test_labeled.docx

De toepassing bouwen en testen

Bouw en test uw clienttoepassing.

1. Gebruik Ctrl-Shift-B (build solution) om uw clienttoepassing te bouwen. Als u geen buildfouten hebt, gebruikt u F5 (Foutopsporing starten) om uw toepassing uit te voeren.

2. Als uw project wordt gebouwd en uitgevoerd, kan de toepassing telkens wanneer de SDK uw AcquireToken() methode aanroept, om verificatie vragen via ADAL. Als er al referenties in de cache aanwezig zijn, wordt u niet gevraagd u aan te melden en de lijst met labels te zien, gevolgd door de informatie over het toegepaste label en het gewijzigde bestand.

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.

U kunt de toepassing van het label controleren door het uitvoerbestand te openen en de instellingen voor gegevensbeveiliging van het document visueel te controleren.

Notitie

Als u een Office-document labelt, maar niet bent aangemeld met een account van de Microsoft Entra-tenant waar het toegangstoken is verkregen (en vertrouwelijkheidslabels zijn geconfigureerd), wordt u mogelijk gevraagd u aan te melden voordat u het gelabelde document kunt openen.