Szybki start: ustawianie i uzyskiwanie etykiety wrażliwości (C#)

W tym przewodniku Szybki start pokazano, jak korzystać z większej liczby zestawów SDK plików MIP. Za pomocą jednej z etykiet wrażliwości wymienionych w poprzednim przewodniku Szybki start można ustawić/pobrać etykietę pliku za pomocą programu obsługi plików. Klasa obsługi plików udostępnia różne operacje ustawienia/uzyskiwania etykiet lub ochrony dla obsługiwanych typów plików.

Wymagania wstępne

Jeśli jeszcze tego nie zrobić, przed kontynuowaniem upewnij się, że są spełnione następujące wymagania wstępne:

• Pełny przewodnik Szybki start: Najpierw listy etykiet wrażliwości (C#), które tworzy rozwiązanie startowe Visual Studio, aby wyświetlić etykiety wrażliwości organizacji. Ten przewodnik Szybki start "Ustaw i uzyskaj etykietę wrażliwości" opiera się na poprzedniej.
• Opcjonalnie: Przegląd programów obsługi plików w pojęciach zestawu SDK miP.

Dodawanie logiki w celu ustawienia i uzyskania etykiety wrażliwości

Dodaj logikę, aby ustawić i uzyskać etykietę wrażliwości na plik przy użyciu obiektu Aparat plików.

1. Za pomocą Eksploratorarozwiązań otwórz plik cs w projekcie, który zawiera implementację metody Main()'. Domyślna nazwa jest taka sama jak nazwa projektu zawierającego projekt, która jest określona podczas tworzenia projektu.

2. Na końcu treści, poniżej i powyżej (miejsca, w którym ten szybki start został wcześniej Main()Console.ReadKey()} wyłączony), wstaw następujący 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. Na końcu znajdź blok zamykania aplikacji utworzony w pierwszym przewodniku szybkiego startu i Main() wyłącz obsługę wiersza programu obsługi:

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

4. Zamień wartości zastępcze w kodzie źródłowym na następujące wartości:

   Symbol zastępczy	Wartość
   <input-file-path>	Pełna ścieżka do pliku wprowadzania testowego, na przykład: c:\\Test\\Test.docx .
   <label-id>	Identyfikator etykiety wrażliwości skopiowany z danych wyjściowych konsoli w poprzednim przewodniku Szybki start, na przykład: f42a3342-8706-4288-bd31-ebb85995028z .
   <output-file-path>	Pełna ścieżka do pliku wyjściowego, który będzie kopią pliku wejściowego oznaczoną etykietą, na przykład: c:\\Test\\Test_labeled.docx .

Tworzenie i testowanie aplikacji

Skompilowanie i testowanie aplikacji klienckiej.

1. Do tworzenia aplikacji klienckiej użyj klawiszy CTRL-SHIFT-B(rozwiązaniekompilacji). Jeśli nie występują błędy kompilacji, użyj klawisza F5(Rozpocznijdebugowanie), aby uruchomić aplikację.

2. Jeśli projekt zostanie pomyślnie skompilowany i uruchomiony, aplikacja może za każdym razem, gdy zestaw SDK wywoła metodę, może zostać wyświetlony monit o uwierzytelnienie za pośrednictwem usługi ADAL. Jeśli poświadczenia buforowane już istnieją, nie zostanie wyświetlony monit o zalogowanie się i wyświetlanie listy etykiet oraz informacji na zastosowanej etykiecie i zmodyfikowanym pliku.

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
 Name: Confidential
 Id: 074e457c-5848-4542-9a6f-34a182080e7z
 Press any key to continue . . .

Możesz sprawdzić aplikację etykiety, otwierając plik wyjściowy i przeglądając wizualnie ustawienia ochrony informacji w dokumencie.