Panduan Cepat: Mengatur dan Mengambil Label Sensitivitas (C#)

Panduan Cepat ini menunjukkan kepada Anda cara memanfaatkan berbagai SDK File MIP. Dengan menggunakan salah satu label sensitivitas yang Anda cantumkan di Mulai Cepat sebelumnya, Anda menggunakan handler File untuk mengatur/mendapatkan label pada file. Kelas Handler file mengekspos berbagai operasi untuk mengatur/mendapatkan label, atau perlindungan, untuk jenis file yang didukung.

Prasyarat

Jika Anda belum melakukannya, pastikan untuk menyelesaikan prasyarat berikut sebelum melanjutkan:

• Selesaikan Mulai Cepat: Mencantumkan label sensitivitas (C#) terlebih dahulu, yang membangun solusi Visual Studio pemula, untuk mencantumkan label sensitivitas organisasi. Panduan cepat "Atur dan dapatkan label sensitivitas" ini dibangun di atas panduan sebelumnya.
• Opsional: Tinjau konsep Pengelola file di MIP SDK.

Menyertakan logika guna mengatur dan mendapatkan label sensitivitas

Tambahkan logika untuk mengatur dan mendapatkan label sensitivitas pada file, menggunakan objek Mesin file.

1. Menggunakan Penjelajah Solusi, buka file .cs dalam proyek Anda yang berisi implementasi metode Main()'. Ini menggunakan nama default yang sama dengan proyek yang memuatnya, yang Anda tentukan selama pembuatan proyek.

2. Menjelang akhir bagian Main(), setelah var fileEngine = dan di //Application Shutdown atas komentar, sisipkan kode berikut:

     //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. Di akhir Main() temukan blok penghentian aplikasi yang dibuat di quickstart pertama dan hapus komentar pada baris handler.

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

4. Ganti nilai placeholder dalam kode sumber dengan menggunakan nilai berikut:

   Placeholder	Value
   <input-file-path>	Jalur lengkap ke file input pengujian, misalnya: c:\\Test\\Test.docx.
   <label-id>	ID label sensitivitas, disalin dari output konsol di Quickstart sebelumnya, misalnya: f42a3342-8706-4288-bd31-ebb85995028z.
   <output-file-path>	Jalur lengkap ke file output, yang akan menjadi salinan berlabel file input, misalnya: c:\\Test\\Test_labeled.docx.

Membangun dan menguji aplikasi

Buat dan uji aplikasi klien Anda.

1. Gunakan CTRL-SHIFT-B (Build Solution) untuk membangun aplikasi klien Anda. Jika tidak ada kesalahan build, gunakan F5 (Mulai debugging) untuk menjalankan aplikasi Anda.

2. Jika proyek Anda berhasil membangun dan berjalan, aplikasi dapat meminta autentikasi melalui ADAL setiap kali SDK memanggil metode Anda AcquireToken() . Jika kredensial yang di-cache sudah ada, Anda tidak akan diminta untuk masuk dan melihat daftar label, diikuti dengan informasi tentang label yang diterapkan dan file yang dimodifikasi.

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.

Anda dapat memverifikasi aplikasi label, dengan membuka file output dan memeriksa pengaturan perlindungan informasi dokumen secara visual.