Quickstart: Een vertrouwelijkheidslabel instellen en ophalen (C#)

In deze quickstart ziet u hoe u meer mogelijkheden van de MIP File SDK's kunt gebruiken. Door een van de vertrouwelijkheidslabels te gebruiken die u in de vorige quickstart hebt vermeld, gebruikt u een bestandshandler om het label op een bestand in te stellen en op te halen. De bestandshandlerklasse biedt verschillende bewerkingen voor het instellen en verkrijgen van labels, of beveiliging, voor ondersteunde bestandstypen.

Vereiste voorwaarden

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

  • Quickstart: Vertrouwelijkheidslabels (C#) vermelden. Voltooi deze quickstart eerst. Er wordt een starter-Visual Studio-oplossing gebouwd waarin de vertrouwelijkheidslabels van een organisatie worden vermeld. Deze quickstart 'Een vertrouwelijkheidslabel instellen en ophalen' bouwt voort op de vorige quickstart.
  • Optioneel: Bekijk de bestandshandlers in de MIP SDK-concepten.

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

Gebruik het object File Engine om logica toe te voegen waarmee een vertrouwelijkheidslabel voor een bestand wordt ingesteld en opgehaald.

  1. Open in Solution Explorer het bestand .cs in uw project dat de implementatie van de Main() methode 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. Zoek aan het einde van Main() het afsluitblok van de toepassing dat in de eerste quickstart is gemaakt en haal de commentaarmarkering weg bij de handlerregel:

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

  4. Vervang de tijdelijke aanduidingen in de broncode door de volgende waarden:

    Plaatsvervanger 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.
    <uitvoer-bestand-pad> 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 cliëntapplicatie.

  1. Gebruik Ctrl-SHIFT-B (build solution) om uw clienttoepassing te bouwen. Als de build geen fouten bevat, gebruikt u F5 (Foutopsporing starten) om uw toepassing uit te voeren.

  2. Als uw project met succes wordt gebouwd en uitgevoerd, kan de toepassing telkens om verificatie vragen wanneer de SDK uw AcquireToken() methode aanroept (meestal via MSAL.NET). Als er al referenties in de cache aanwezig zijn, wordt u niet gevraagd u aan te melden, waarna u de lijst met labels kunt zien, gevolgd door de informatie over het toegepaste label en het aangepaste 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.

Controleer de labeltoepassing door het uitvoerbestand te openen en de instellingen voor gegevensbeveiliging van het document visueel te controleren.

Opmerking

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

Volgende stappen 

  • Last updated on