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

Panduan mulai cepat ini menunjukkan cara menggunakan lebih banyak MIP File SDK. Dengan menggunakan salah satu label sensitivitas yang Anda cantumkan di panduan mulai cepat sebelumnya, Anda menggunakan handler file untuk mengatur dan mengambil label pada file. Kelas handler file mengekspos berbagai operasi untuk mengatur dan mendapatkan label, atau perlindungan, untuk jenis file yang didukung.

Prasyarat

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

Menyertakan logika guna mengatur dan mendapatkan label sensitivitas

Gunakan objek mesin File untuk menambahkan logika yang menetapkan dan mengambil label sensitivitas pada file.

  1. Di Penjelajah Solusi, buka file .cs dalam proyek Anda yang berisi implementasi Main() metode . 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. Pada akhir Main(), temukan blok penghentian aplikasi yang dibuat dalam panduan mulai cepat pertama dan hapus tanda komentar pada baris handler:

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

  4. Ganti nilai placeholder dalam kode sumber dengan 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 merupakan 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 build tidak memiliki kesalahan, gunakan F5 (Mulai penelusuran kesalahan) untuk menjalankan aplikasi Anda.

  2. Jika proyek Anda berhasil dibangun dan berjalan, aplikasi mungkin meminta autentikasi setiap kali SDK memanggil metode Anda AcquireToken() (biasanya melalui MSAL.NET). 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.

Verifikasi aplikasi label dengan membuka file output dan memeriksa pengaturan perlindungan informasi dokumen secara visual.

Nota

Jika Anda memberi label pada dokumen Office tetapi belum masuk menggunakan akun dari tenant Microsoft Entra yang menerbitkan token akses (dan label sensitivitas dikonfigurasi), Anda mungkin diminta untuk masuk sebelum dapat membuka dokumen yang telah diberi label.

Langkah berikutnya

  • Last updated on