Rychlý start: Nastavení a získání popisku citlivosti (C#)

Tento rychlý start vám ukáže, jak používat více ze sady SDK MIP File. Pomocí jednoho z označení citlivosti, které jste uvedli v předchozím rychlém startu, použijete manipulátor souborů k nastavení/získání označení na souboru. Třída zpracování souborů poskytuje různé operace pro nastavování/získávání štítků nebo ochrany pro podporované typy souborů.

Požadavky

Pokud jste to ještě neudělali, nezapomeňte před pokračováním dokončit následující požadavky:

• Úplný rychlý start: Nejprve vypíše popisky citlivosti (C#), které sestaví počáteční řešení sady Visual Studio a zobrazí seznam popisků citlivosti organizace. Tato rychlá příručka "Nastavit a získat značení citlivosti" staví na té předchozí.
• Volitelně: Zkontrolujte obslužné rutiny souborů v konceptech sady MIP SDK .

Přidejte logiku k nastavení a získání citlivostního označení

Přidejte logiku pro nastavení a získání štítku citlivosti na souboru pomocí objektu File engine.

1. Pomocí Průzkumníka řešení otevřete v projektu soubor .cs, který obsahuje implementaci metody Main(). V rámci výchozího nastavení se použije stejný název jako projekt, který ho obsahuje a který jste zadali při vytváření projektu.

2. Na konec Main() textu vložte následující kód za var fileEngine = komentář a nad //Application Shutdown něj:

     //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. Na konci Main() vyhledejte blok vypnutí aplikace vytvořený v prvním rychlém startu a odkomentujte řádek obslužné rutiny:

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

4. Zástupné hodnoty ve zdrojovém kódu nahraďte následujícími hodnotami:

   Zástupný text	Hodnota
   <cesta k vstupnímu souboru>	The full path to a test input file, for example: c:\\Test\\Test.docx.
   <identifikátor štítku>	A sensitivity label ID, copied from the console output in the previous Quickstart, for example: f42a3342-8706-4288-bd31-ebb85995028z.
   <cesta k výstupnímu souboru>	Úplná cesta k výstupnímu souboru, což bude označená kopie vstupního souboru, například: c:\\Test\\Test_labeled.docx.

Sestavení a otestování aplikace

Sestavte a otestujte klientskou aplikaci.

1. K sestavení klientské aplikace stiskněte kombinaci kláves CTRL +SHIFT-B (Build Solution). Pokud nemáte žádné chyby sestavení, spusťte aplikaci pomocí klávesy F5 (spustit ladění).

2. Pokud se projekt sestaví a úspěšně spustí, aplikace může při každém volání vaší AcquireToken() metody vyžadovat ověření prostřednictvím knihovny ADAL. Pokud přihlašovací údaje uložené v mezipaměti už existují, nebudete vyzváni k přihlášení a zobrazí se seznam popisků a informace o použitém popisku a upraveném souboru.

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.

You can verify the application of the label, by opening the output file and visually inspecting the document's information protection settings.

Poznámka:

Pokud označujete dokument Office, ale nejste přihlášení pomocí účtu z tenanta Microsoft Entra, kde byl přístupový token získán (a popisky citlivosti jsou nakonfigurované), můžete být před otevřením označeného dokumentu vyzváni k přihlášení.