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

Den här snabbstarten visar hur du använder fler MIP-fil-SDK:er. Genom att använda någon av de känslighetsetiketter som du angav i föregående snabbstart använder du en filhanterare för att ange och hämta etiketten på en fil. Filhanterarklassen exponerar olika åtgärder för att ange och 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:

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

Använd objektet File engine för att lägga till logik som ställer in och hämtar en känslighetsetikett på en fil.

  1. I Prieskumník riešení öppnar du filen .cs 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() hittar du programavslutningsblocket som skapades i den första snabbstartsguiden och avkommentera hanterarraden:

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

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

    Platshållare Värde
    <inmatningsfil-sökväg> 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.
    <utdatafilssökväg> 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 versionen inte har några fel 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 varje gång SDK anropar din AcquireToken() metod (vanligtvis via MSAL.NET). 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.

Verifiera etikettprogrammet genom att öppna utdatafilen och visuellt granska dokumentets inställningar för informationsskydd.

Anmärkning

Om du etiketterar ett Office-dokument men inte är inloggad med hjälp av ett konto från den Microsoft Entra klientorganisation som utfärdade åtkomsttoken (och känslighetsetiketter har konfigurerats) kan du uppmanas att logga in innan du kan öppna det märkta dokumentet.

Nästa steg

  • Last updated on