Penyiapan dan konfigurasi SDK Perlindungan Informasi Microsoft (MIP)

Artikel mulai cepat dan tutorial berfokus pada pembuatan aplikasi yang menggunakan pustaka dan API MIP SDK. Artikel ini memperlihatkan kepada Anda cara menyiapkan dan mengonfigurasi langganan Microsoft 365 dan stasiun kerja klien sebelum Anda menggunakan SDK.

Prasyarat

Tinjau topik berikut sebelum memulai:

Penting

Untuk menghormati privasi pengguna, Anda harus meminta pengguna untuk menyetujui sebelum mengaktifkan pengelogan otomatis. Contoh berikut adalah pesan standar yang digunakan Microsoft untuk pemberitahuan pengelogan:

Dengan mengaktifkan pengelogan kesalahan dan performa, Anda setuju untuk mengirim data kesalahan dan performa ke Microsoft. Microsoft mengumpulkan data kesalahan dan performa melalui internet ("Data"). Microsoft menggunakan Data ini untuk menyediakan dan meningkatkan kualitas, keamanan, dan integritas produk dan layanan Microsoft. Misalnya, Microsoft menganalisis performa dan keandalan, seperti fitur apa yang Anda gunakan, seberapa cepat fitur merespons, performa perangkat, interaksi antarmuka pengguna, dan masalah apa pun yang Anda alami dengan produk. Data juga mencakup informasi tentang konfigurasi perangkat lunak Anda seperti perangkat lunak yang saat ini Anda jalankan, dan alamat IP.

Mendaftar langganan Office 365

Banyak sampel SDK memerlukan akses ke langganan Office 365. Daftar untuk salah satu jenis langganan berikut:

Nama Mendaftar
Office 365 Enterprise E3 Versi Uji Coba (uji coba gratis 30 hari) https://go.microsoft.com/fwlink/p/?LinkID=403802
Office 365 Enterprise E3 atau E5 https://www.microsoft.com/microsoft-365/enterprise/office-365-e3
Enterprise Mobility and Security E3 atau E5 https://www.microsoft.com/security
Perlindungan Informasi Azure Premium P1 atau P2 Panduan lisensi Microsoft 365 untuk keamanan & kepatuhan
Microsoft 365 E3, E5, atau F1 https://www.microsoft.com/microsoft-365/enterprise/microsoft365-plans-and-pricing

Catatan

Perlindungan Informasi Azure Premium P1 atau P2 tidak lagi disertakan sebagai penawaran mandiri. Anda dapat membelinya sebagai bagian dari Microsoft 365 E3 atau E5, atau Enterprise Mobility and Security E3 atau E5.

Mengonfigurasikan label sensitivitas

Jika saat ini Anda menggunakan konfigurasi label warisan, Anda harus memigrasikan label Anda ke Microsoft Purview. Untuk informasi selengkapnya tentang proses ini, lihat Membuat dan mengonfigurasi label sensitivitas dan kebijakannya.

Mengonfigurasi stasiun kerja klien Anda

Selanjutnya, selesaikan langkah-langkah berikut untuk menyiapkan dan mengonfigurasi komputer klien Anda dengan benar.

  1. Jika Anda menggunakan stasiun kerja Windows 10:

    Gunakan Windows Update untuk memperbarui komputer Anda ke Windows 10 Fall Creators Update (versi 1709) atau yang lebih baru. Untuk memverifikasi versi Anda saat ini:

    • Pilih ikon Windows di kiri bawah.
    • Ketik Tentang PC Anda dan tekan Enter.
    • Gulir ke bawah ke spesifikasi Windows dan lihat di bawah Versi.

  2. Jika Anda menggunakan stasiun kerja Windows 11 atau Windows 10:

    Aktifkan Mode Pengembang di stasiun kerja Anda:

    • Pilih ikon Windows di kiri bawah.
    • Ketik Gunakan fitur pengembang, dan tekan Enter saat item Gunakan fitur pengembang muncul.
    • Pada dialog Pengaturan , pada tab Untuk pengembang , di bawah Gunakan fitur pengembang, pilih opsi Mode pengembang .
    • Tutup dialog Pengaturan.

  3. Instal Visual Studio 2022, dengan beban kerja dan komponen opsional berikut:

    • Pengembangan Platform Windows Universal beban kerja Windows, ditambah komponen opsional berikut:

      • Alat C++ untuk Platform Windows Universal
      • Windows 10 SDK 10.0.16299.0 SDK atau yang lebih baru, jika tidak disertakan secara default

    • Pengembangan desktop dengan beban kerja C++ Windows, ditambah komponen opsional berikut:

      • Windows 10 SDK 10.0.16299.0 SDK atau yang lebih baru, jika tidak disertakan secara default

      Visual Studio penyiapan.

  4. Instal Modul PowerShell MSAL.PS:

    • Karena penginstalan memerlukan hak administrator, gunakan salah satu opsi berikut:

      • Masuk ke komputer Anda dengan akun yang memiliki hak administrator.
      • Jalankan sesi Windows PowerShell dengan hak yang ditinggikan (Jalankan sebagai Administrator).

    • Jalankan Install-Module -Name MSAL.PS cmdlet:

      PS C:\WINDOWS\system32> Install-Module -Name MSAL.PS

Untrusted repository
You are installing the modules from an untrusted repository. If you trust this repository, change its
InstallationPolicy value by running the Set-PSRepository cmdlet. Are you sure you want to install the modules from
'PSGallery'?
[Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "N"): A

PS C:\WINDOWS\system32>

  5. Unduh file:

    MIP SDK didukung pada platform berikut, dengan unduhan terpisah untuk setiap platform dan bahasa yang didukung:

    Sistem operasi Versi Unduhan Catatan
    Ubuntu 22.04 tar.gz C++
    Tar.gz Java (Pratinjau)
    .NET Core
    Ubuntu 24/04 tar.gz C++
    Tar.gz Java (Pratinjau)
    .NET Core
    RedHat Enterprise Linux 8 dan 9 tar.gz C++
    Debian 10 dan 11 tar.gz C++
    macOS Semua versi yang didukung C++ .zip Pengembangan Xcode membutuhkan 13 atau lebih besar.
    Windows Semua versi yang didukung, 32/64 bit C++
    C++/.NET NuGet
    Java (Pratinjau) .zip
    Android 9.0 dan yang lebih baru C++ .zip SDK Perlindungan dan Kebijakan saja.
    Ios Semua versi yang didukung C++ .zip SDK Perlindungan dan Kebijakan saja.

    unduhan Tar.gz/.zip

    Tar.gz dan unduhan .zip berisi file terkompresi, satu untuk setiap API. File terkompresi menggunakan konvensi penamaan berikut, di mana <API> = file, protection, atau upe, dan <OS> = platform: mip_sdk_<API>_<OS>_1.0.0.0.zip (or .tar.gz). Misalnya, berkas biner dan header untuk Protection SDK di Debian adalah mip_sdk_protection_debian9_1.0.0.0.tar.gz. Setiap file .tar.gz/.zip yang terkandung dibagi menjadi tiga direktori:

    • Bins: Biner yang dikompilasi untuk setiap arsitektur platform, jika berlaku.
    • Sertakan: File header (C++).
    • Sampel: Kode sumber untuk aplikasi sampel.

    Paket NuGet

    Jika Anda melakukan pengembangan Visual Studio, Anda juga dapat menginstal SDK dengan menggunakan NuGet Package Manager Console:

    Install-Package Microsoft.InformationProtection.File
Install-Package Microsoft.InformationProtection.Policy
Install-Package Microsoft.InformationProtection.Protection

  6. Jika Anda tidak menggunakan paket NuGet, tambahkan jalur biner SDK ke variabel lingkungan PATH. Variabel PATH memungkinkan aplikasi klien menemukan biner dependen (DLL) pada runtime. Langkah ini bersifat opsional.

    Jika Anda menggunakan stasiun kerja Windows 11 atau Windows 10:

    • Pilih ikon Windows di kiri bawah.

    • Ketik Jalur, dan tekan Enter saat item Edit variabel lingkungan sistem muncul.

    • Pada dialog Properti Sistem , pilih Variabel Lingkungan.

    • Pada dialog Variabel Lingkungan , pilih baris Variabel jalur di bawah Variabel pengguna untuk <pengguna>, lalu pilih Edit.

    • Pada dialog Edit variabel lingkungan , pilih Baru, yang membuat baris yang dapat diedit. Tambahkan baris baru untuk setiap jalur lengkap ke subdirektori file\bins\debug\amd64, protection\bins\debug\amd64, dan upe\bins\debug\amd64 . Direktori SDK disimpan dalam <API>\bins\<target>\<platform> format, di mana:

      • <API> = file, protection, upe
      • <target> = debug, release
      • <platform> = amd64 (x64), x86, dll.

    • Setelah Anda selesai memperbarui variabel Jalur , pilih OK. Lalu pilih OK saat Anda kembali ke dialog Variabel Lingkungan .

  7. Unduh sampel SDK dari GitHub. Langkah ini bersifat opsional.

Mendaftarkan aplikasi klien dengan ID Microsoft Entra

Sebagai bagian dari proses provisi langganan Microsoft 365, Microsoft membuat penyewa Microsoft Entra terkait. Penyewa Microsoft Entra menyediakan manajemen identitas dan akses untuk akun pengguna dan akun aplikasi Microsoft 365. Aplikasi yang memerlukan akses ke API aman (seperti API MIP) memerlukan akun aplikasi.

Untuk autentikasi dan otorisasi saat runtime, prinsipal keamanan merepresentasikan sebuah akun dan diturunkan dari informasi identitas akun tersebut. Prinsip keamanan yang mewakili akun aplikasi disebut perwakilan layanan.

Untuk mendaftarkan akun aplikasi di Microsoft Entra ID agar dapat digunakan dalam panduan mulai cepat dan contoh MIP SDK:

Penting

Untuk mengakses manajemen penyewa Microsoft Entra untuk pembuatan akun, masuk ke portal Azure dengan akun pengguna yang merupakan anggota peran Pemilik pada langganan. Bergantung pada konfigurasi penyewa, Anda mungkin juga perlu menjadi anggota peran direktori Administrator Global untuk mendaftarkan aplikasi. Uji dengan akun terbatas. Berikan kepada akun tersebut hanya hak akses yang diperlukan untuk mengakses titik akhir SCC yang diperlukan. Sistem pengelogan mungkin mengumpulkan kata sandi cleartext yang diteruskan melalui baris perintah.

  1. Ikuti langkah-langkah di bagian Daftarkan aplikasi baru . Untuk tujuan pengujian, gunakan nilai berikut untuk properti yang diberikan saat Anda melalui langkah-langkah panduan:

    • Jenis akun yang didukung - Pilih Akun hanya di direktori organisasi ini.
    • URI Pengalihan - Atur jenis URI pengalihan ke Klien publik (seluler & desktop). Jika aplikasi Anda menggunakan Pustaka Autentikasi Microsoft (MSAL), gunakan http://localhost. Jika tidak, gunakan sesuatu dalam format <app-name>://authorize.

  2. Setelah selesai, Anda kembali ke halaman Aplikasi terdaftar untuk pendaftaran aplikasi baru Anda. Salin dan simpan GUID di bidang ID Aplikasi (klien), karena Anda membutuhkannya untuk mulai cepat.

  3. Pilih izin API untuk menambahkan API dan izin yang perlu diakses klien. Pilih Tambahkan izin untuk membuka panel Minta izin API .

  4. Tambahkan API DAN izin MIP yang diperlukan aplikasi saat runtime:

    • Pada halaman Pilih API, pilih Azure Rights Management Services.
    • Pada halaman AZURE Rights Management Services API, pilih Izin yang didelegasikan.
    • Di bagian Pilih izin , pilih izin user_impersonation . Hak ini memungkinkan aplikasi membuat dan mengakses konten yang dilindungi atas nama pengguna.
    • Pilih Tambahkan izin untuk disimpan.

  5. Ulangi langkah 4, tetapi kali ini saat Anda masuk ke halaman Pilih API , cari API.

    • Pada halaman Pilih API , pilih API yang digunakan organisasi saya. Kemudian di kotak pencarian, ketik Microsoft Information Protection Sync Service, dan pilih.
    • Pada halaman Microsoft Information Protection Sync Service API, pilih Izin yang didelegasikan.
    • Perluas simpul UnifiedPolicy , dan pilih UnifiedPolicy.User.Read.
    • Pilih Tambahkan izin untuk disimpan.

  6. Saat Anda kembali ke halaman izin API , pilih Berikan persetujuan admin untuk (Nama Penyewa), lalu Ya. Langkah ini memberikan pra-persetujuan kepada aplikasi yang menggunakan pendaftaran ini untuk mengakses API berdasarkan izin yang ditentukan. Jika Anda masuk sebagai administrator global, persetujuan dicatat untuk semua pengguna di penyewa yang menjalankan aplikasi. Jika tidak, ini hanya berlaku untuk akun pengguna Anda.

Setelah selesai, pendaftaran aplikasi dan izin API akan terlihat mirip dengan contoh berikut:

Pendaftaran aplikasi Microsoft Entra. Izin API aplikasi Microsoft Entra.

Untuk informasi selengkapnya tentang menambahkan API dan izin yang diperlukan oleh aplikasi klien, lihat Mengonfigurasi aplikasi klien untuk mengakses API web.

Meminta Perjanjian Integrasi Perlindungan Informasi (IPIA)

Sebelum merilis aplikasi yang dikembangkan dengan MIP ke publik, Anda harus mengajukan permohonan dan menyelesaikan perjanjian formal dengan Microsoft.

Catatan

Anda tidak memerlukan perjanjian ini untuk aplikasi yang hanya ditujukan untuk penggunaan internal.

  1. Dapatkan IPIA Anda dengan mengirim email ke IPIA@microsoft.com dengan informasi berikut:

    Subjek: Meminta IPIA untuk Nama Perusahaan

    Dalam isi email, meliputi:

    • Nama aplikasi dan produk
    • Nama depan dan belakang pemohon
    • Alamat email pemohon

  2. Setelah Microsoft menerima permintaan IPIA Anda, Microsoft mengirimkan formulir sebagai dokumen Word. Tinjau syarat dan ketentuan IPIA, dan kembalikan formulir ke IPIA@microsoft.com dengan menyertakan informasi berikut:

    • Nama hukum perusahaan
    • Negara bagian/provinsi (AS/Kanada) atau negara/wilayah pendirian
    • URL Perusahaan
    • Alamat email orang kontak
    • Alamat lain perusahaan (opsional)
    • Nama aplikasi perusahaan
    • Deskripsi singkat tentang aplikasi
    • ID Penyewa Azure
    • ID Aplikasi bagi aplikasi
    • Kontak perusahaan, email, dan telepon untuk korespondensi situasi kritis

  3. Setelah Microsoft menerima formulir Anda, Microsoft mengirimkan tautan final IPIA kepada Anda untuk ditandatangani secara digital. Setelah Anda menandatangani, perwakilan Microsoft yang sesuai menandatangani perjanjian.

Sudah memiliki IPIA yang ditandatangani?

Jika Anda sudah memiliki IPIA yang ditandatangani dan ingin menambahkan ID Aplikasi baru untuk aplikasi yang Anda rilis, kirim email ke IPIA@microsoft.com dan berikan informasi berikut:

  • Nama aplikasi perusahaan
  • Deskripsi singkat tentang aplikasi
  • ID Penyewa Azure (bahkan jika yang sama seperti sebelumnya)
  • ID Aplikasi untuk aplikasi
  • Kontak perusahaan, email, dan telepon untuk korespondensi situasi kritis

Setelah Anda mengirim email, tunggu hingga 72 jam untuk pengakuan tanda terima.

Pastikan aplikasi Anda memiliki dependensi yang diperlukan

Aplikasi yang dibangun dengan MIP SDK pada Windows memerlukan komponen Visual C++ Runtime jika belum diinstal:

Dependensi ini hanya berfungsi jika Anda membuat aplikasi sebagai Rilis. Jika Anda membangun aplikasi sebagai Debug, sertakan DLL debug runtime Visual C++ dengan aplikasi atau instal di komputer.

Aplikasi yang dibangun dengan MIP SDK di Linux memerlukan versi dependensi ini yang didukung:

Berkas biner menyertakan folder contoh dengan berkas how-to-build-and-run.txt yang berisi perintah untuk menginstal dependensi yang diperlukan untuk setiap sistem operasi.

Langkah berikutnya

  • Terakhir diperbarui pada