Mulai cepat: Mencantumkan label sensitivitas (C#)

Panduan memulai cepat ini menjelaskan cara menggunakan MIP File SDK untuk menampilkan daftar label sensitivitas yang dikonfigurasi untuk organisasi Anda.

Prasyarat

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

Tambahkan logika untuk mendaftar label sensitivitas

Tambahkan logika untuk mencantumkan label sensitivitas organisasi Anda dengan menggunakan objek mesin file.

  1. Buka solusi Visual Studio yang Anda buat di artikel "Mulai Cepat: Inisialisasi aplikasi klien (C#)" sebelumnya.

  2. 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.

  3. Menjelang bagian akhir isi Main(), sebelum bagian penghentian aplikasi di dalam fungsi Main() (tempat Anda berhenti pada panduan mulai cepat sebelumnya), sisipkan kode berikut:

// List sensitivity labels from fileEngine and display name and id
foreach(var label in fileEngine.SensitivityLabels)
{
    Console.WriteLine(string.Format("{0} : {1}", label.Name, label.Id));

    if (label.Children.Count != 0)
    {
        foreach (var child in label.Children)
        {
            Console.WriteLine(string.Format("{0}{1} : {2}", "\t",child.Name, child.Id));
        }
    }
}

Membangun dan menguji aplikasi

Buat dan uji aplikasi klien Anda.

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

  2. Jika proyek Anda berhasil dibangun dan berjalan, aplikasi mungkin meminta autentikasi dengan menggunakan Pustaka Autentikasi Microsoft (MSAL) setiap kali SDK memanggil metode AndaAcquireToken(). Jika kredensial yang di-cache sudah ada, Anda tidak akan diminta untuk masuk dan Anda melihat daftar label.

    Visual Studio memperoleh permintaan masuk token.

    • Anda mungkin juga perlu memberikan persetujuan untuk mengizinkan aplikasi mengakses API MIP saat berjalan di bawah akun masuk. Ini terjadi ketika pendaftaran aplikasi Microsoft Entra belum mendapatkan persetujuan sebelumnya (sebagaimana diuraikan dalam "setup dan konfigurasi MIP SDK"), atau Anda masuk dengan akun dari penyewa yang berbeda (selain yang digunakan untuk mendaftarkan aplikasi Anda). Pilih Terima untuk merekam persetujuan Anda.

      Permintaan persetujuan Visual Studio.

  3. Setelah autentikasi, output konsol Anda harus menampilkan label sensitivitas, mirip dengan contoh berikut:

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.

Nota

Salin dan simpan ID dari satu atau beberapa label sensitivitas (misalnya, f42a3342-8706-4288-bd31-ebb85995028z), karena ID tersebut akan digunakan dalam panduan mulai cepat berikutnya.

Penyelesaian Masalah

Masalah selama eksekusi aplikasi C#

Ringkasan Pesan kesalahan Solusi
Token akses salah Terjadi pengecualian... apakah token akses tidak benar/kadaluarsa?

Panggilan API gagal: profile_add_engine_async Gagal dengan: [class mip::PolicySyncException] Gagal memperoleh kebijakan, Permintaan gagal dengan kode status HTTP: 401, x-ms-diagnostics: [2000001;reason="Token OAuth yang dikirim bersama permintaan tidak dapat diurai.";error_category="invalid_token"], correlationId:[aaaa0000-bb11-2222-33cc-444444dddddd]'

C:\VSProjects\MipDev\Quickstarts\AppInitialization\x64\Debug\AppInitialization.exe (proses 29924) keluar dengan kode 0.

Tekan tombol apa saja untuk menutup jendela ini. . .		 Jika proyek Anda berhasil dibangun, tetapi Anda melihat output yang mirip dengan sebelah kiri, token dalam metode Anda AcquireOAuth2Token() kemungkinan tidak valid atau kedaluwarsa. Kembali ke Bangun dan uji aplikasi dan regenerasi token akses, perbarui AcquireOAuth2Token() lagi, dan bangun kembali/coba lagi. Anda juga dapat memeriksa dan memverifikasi token dan klaimnya dengan menggunakan aplikasi web jwt.ms satu halaman.
Label sensitivitas belum dikonfigurasi N/a Jika proyek Anda berhasil dibangun, tetapi tidak ada output yang muncul di jendela konsol, pastikan label sensitivitas organisasi Anda dikonfigurasi dengan benar. Untuk detailnya, lihat Penyiapan dan konfigurasi MIP SDK, di bawah "Tentukan taksonomi label dan pengaturan perlindungan".

Langkah berikutnya

Setelah mengetahui cara membuat daftar label sensitivitas untuk organisasi Anda, coba panduan cepat berikutnya:

Atur dan dapatkan label sensitivitas

  • Last updated on