Bagikan melalui

Mulai Cepat: Templat Daftar (C#)

  • Artikel

Mulai Cepat ini memperlihatkan kepada Anda cara menggunakan SDK Perlindungan MIP untuk mencantumkan templat perlindungan yang tersedia untuk pengguna.

Prasyarat

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

Menambahkan logika untuk mencantumkan templat perlindungan

Tambahkan logika ke templat perlindungan daftar yang tersedia untuk pengguna, menggunakan objek Mesin perlindungan.

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

  2. Dengan menggunakan Penjelajah Solusi, buka file .cs dalam proyek Anda yang berisi implementasi Main() metode . Ini default ke nama yang sama dengan proyek yang berisinya, yang Anda tentukan selama pembuatan proyek.

  3. Menjelang akhir Main() isi, di atas bagian matikan aplikasi fungsi Main() (tempat Anda meninggalkan di Mulai Cepat sebelumnya), sisipkan kode berikut:

// List protection templates using protectionEngine and display the list

var templates=protectionEngine.GetTemplates();

for(int i = 0; i < templates.Count; i++)
{
    Console.WriteLine("{0}: {1}", i.ToString(), templates[i].Name + " : " + templates[i].Id);
}

Console.WriteLine("Press a key to continue...");

Membangun dan menguji aplikasi

Terakhir, bangun 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 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.

    Visual Studio acquire token sign-in

    • Anda mungkin juga perlu memberikan persetujuan, untuk memungkinkan aplikasi mengakses API MIP, saat berjalan di bawah akun masuk. Ini terjadi ketika pendaftaran aplikasi Microsoft Entra tidak disetujui sebelumnya (seperti yang diuraikan dalam "penyiapan dan konfigurasi SDK MIP"), atau Anda masuk dengan akun dari penyewa yang berbeda (selain yang mana aplikasi Anda terdaftar). Cukup klik Terima untuk merekam persetujuan Anda.

      Visual Studio consent

  3. Setelah autentikasi, output konsol Anda harus menampilkan templat perlindungan untuk pengguna yang diautentikasi, mirip dengan contoh berikut:

0: Confidential \ All Employees : a74f5027-f3e3-4c55-abcd-74c2ee41b607
1: Highly Confidential \ All Employees : bb7ed207-046a-4caf-9826-647cff56b990
2: Confidential : 174bc02a-6e22-4cf2-9309-cb3d47142b05
3: Contoso Employees Only : 667466bf-a01b-4b0a-8bbf-a79a3d96f720
Press a key to continue.

Catatan

Salin dan simpan ID dari satu atau beberapa templat perlindungan (misalnya, bb7ed207-046a-4caf-9826-647cff56b990), karena Anda akan menggunakannya di Mulai Cepat berikutnya.

Pemecahan Masalah

Masalah selama eksekusi aplikasi C#

Ringkasan Pesan kesalahan Solusi
Token akses buruk Terjadi pengecualian... apakah token akses salah/kedaluwarsa?

Panggilan API gagal: profile_add_engine_async Gagal dengan: [class mip::P olicySyncException] Gagal memperoleh kebijakan, Permintaan gagal dengan kode status http: 401, x-ms-diagnostics: [2000001; reason="Token OAuth yang dikirimkan dengan permintaan tidak dapat diurai."; error_category="invalid_token"], correlationId:[35bc0023-3727-4eff-8062-000006d5d672]'

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

Tekan tombol apa pun untuk menutup jendela ini . . .		 Jika proyek Anda berhasil dibangun, tetapi Anda melihat output yang mirip dengan sebelah kiri, Anda mungkin memiliki token yang tidak valid atau kedaluwarsa dalam metode Anda AcquireOAuth2Token() . 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, menggunakan aplikasi web halaman tunggal jwt.ms .

Langkah berikutnya

Sekarang setelah Anda mempelajari cara mencantumkan templat perlindungan yang tersedia untuk pengguna terautentikasi, coba mulai cepat berikutnya:

Mulai Cepat - Mengenkripsi dan Mendekripsi teks