Microsoft Information Protection SDK - Metadata

Microsoft Information Protection SDK menghasilkan kumpulan metadata yang harus diterapkan ke file. Metadata ini adalah representasi label. Dokumen ini menjelaskan metadata yang dihasilkan SDK untuk diterapkan ke email, dokumen, dan rekaman lainnya.

Label

Label dalam SDK Perlindungan Informasi Microsoft diterapkan ke informasi untuk menjelaskan sensitivitas informasi tersebut. Data label disimpan ke file atau rekaman dalam sekumpulan pasangan kunci-nilai yang menjelaskan label. Nama metadata dibangun pada struktur berikut:

DefinedPrefix_ElementType_GlobalIdentifier_AttributeName

Saat diterapkan ke data berlabel Perlindungan Informasi Microsoft Purview, hasilnya adalah:

MSIP_Label_GUID_Enabled = true

GUID adalah pengidentifikasi unik untuk setiap label dalam organisasi. Objek hanya dapat memiliki satu label dari organisasi yang sama. Beberapa label dari organisasi yang sama tidak dapat ditulis ke file atau objek.

Metadata SDK Perlindungan Informasi Microsoft

MIP SDK menerapkan kumpulan metadata berikut.

Atribut Jenis atau Nilai Deskripsi Wajib
Diaktifkan Benar atau Salah Atribut ini menunjukkan apakah klasifikasi yang diwakili oleh sekumpulan pasangan kunci-nilai ini diaktifkan untuk item data. Produk DLP biasanya memvalidasi keberadaan kunci ini untuk mengidentifikasi label klasifikasi. Ya
SiteId GUID ID penyewa Microsoft Entra Ya
ActionId (Dihapus di MIP SDK 1.8 dan yang lebih baru) GUID ActionID diperbarui setiap kali label ditetapkan. Log audit mencakup actionID lama dan baru untuk memungkinkan penautan aktivitas pelabelan ke item data. Ya
Metode Standar atau Istimewa Atur melalui mip::AssignmentMethod. Standar menyiratkan bahwa label diterapkan secara default atau otomatis. Hak istimewa menyiratkan bahwa label dipilih secara manual. Tidak
SetDate Format Tanggal ISO 8601 diperpanjang Tanda waktu saat label diatur. Tidak
Nama string Beri label nama unik dalam penyewa. Ini tidak selalu sesuai dengan nama tampilan. Tidak
ContentBits bilangan bulat ContentBits adalah bitmask yang menjelaskan jenis penandaan konten yang diterapkan ke konten berdasarkan kebijakan dan kemampuan klien. CONTENT_HEADER = 0X1, CONTENT_FOOTER = 0X2, WATERMARK = 0X4, ENCRYPT = 0x8 Tidak

Saat diterapkan ke file, hasilnya mirip dengan tabel di bawah ini.

Kunci Nilai
MSIP_Label_2096f6a2-d2f7-48be-b329-b73aaa526e5d_Enabled benar
MSIP_Label_2096f6a2-d2f7-48be-b329-b73aaa526e5d_SetDate 2018-11-08T21:13:16-0800
MSIP_Label_2096f6a2-d2f7-48be-b329-b73aaa526e5d_Method Istimewa
MSIP_Label_2096f6a2-d2f7-48be-b329-b73aaa526e5d_Name Rahasia
MSIP_Label_2096f6a2-d2f7-48be-b329-b73aaa526e5d_SiteId cb46c030-1825-4e81-a295-151c039dbf02
MSIP_Label_2096f6a2-d2f7-48be-b329-b73aaa526e5d_ContentBits 2
MSIP_Label_2096f6a2-d2f7-48be-b329-b73aaa526e5d_ActionId 88124cf5-1340-457d-90e1-0000a9427c99

ContentBits

Properti contentBits metadata di MIP SDK digunakan untuk menunjukkan tindakan pengubahan konten mana yang diambil pada file oleh aplikasi pelabelan.

contentBits dapat dibaca oleh aplikasi hilir untuk memahami tindakan mana yang diterapkan ke file. Menggunakan properti ini, aplikasi seperti Word, Excel, atau PowerPoint dapat membandingkan nilai pada metadata file dengan nilai yang dihitung berdasarkan kebijakan. Jika terdapat perbedaan, mungkin akan melengkapi informasi yang hilang.

Ambil contoh, misalnya SDK File MIP. Ini tidak mendukung penerapan langsung header, footer, atau tanda air ke file. Ketika file diberi label dengan MIP SDK, satu-satunya hasil untuk contentBits adalah 0x0 jika file tidak terlindungi atau 0x8 jika file dilindungi. Ini berlaku bahkan jika kebijakan label memiliki header, footer, dan marka air yang dikonfigurasi.

Saat file dibuka di Microsoft Word, header, footer, dan tanda air akan hilang. Ketika pengguna mengklik simpan kebijakan dievaluasi ulang dan contentBits pada file dibandingkan dengan hasil kebijakan. Jika ada perbedaan, aplikasi menerapkan penandaan konten yang hilang.

Catatan

Fitur ini memerlukan klien Perlindungan Informasi Microsoft Purview saat ini, dan hanya berfungsi di Word, Excel, atau PowerPoint. Ini tidak berlaku untuk Outlook.

Memperluas Metadata dengan Atribut Kustom

Metadata kustom dapat ditambahkan melalui File dan Policy SDK. Atribut kustom harus mempertahankan awalan dasar MSIP_Label_GUID .

Misalnya, aplikasi yang ditulis oleh Contoso Corporation harus menerapkan metadata yang menunjukkan sistem mana yang menghasilkan file berlabel. Aplikasi dapat membuat label baru, diawali dengan MSIP_Label_GUID. Nama vendor perangkat lunak dan atribut kustom ditambahkan ke awalan untuk menghasilkan metadata kustom.

LabelingOptions options = new()
{
    AssignmentMethod = AssignmentMethod.Standard
};

options.ExtendedProperties = new List<KeyValuePair<string, string>>();
options.ExtendedProperties.Add(new KeyValuePair<string, string>("GeneratedBy", "HRReportingSystem"));

MSIP_Label_f048e7b8-f3aa-4857-bf32-a317f4bc3f29_GeneratedBy = HRReportingSystem

Catatan

Untuk mempertahankan kompatibilitas di seluruh aplikasi umum, panjang maksimum untuk setiap kunci dan nilai adalah 255 karakter.

Catatan

Ketika pengalaman penulisan bersama yang dilindungi diaktifkan, properti metadata kustom akan ditulis ke komponen custom.xml dari jenis file Office yang didukung.

Pengelolaan Versi

Seiring waktu, atribut akan diperkenalkan, dimodifikasi, atau dihentikan. Diharapkan aplikasi terus menangani atribut lama atau yang sudah dihentikan ini, karena mengganti nilai di seluruh perusahaan mungkin memakan waktu bertahun-tahun.

Saat mengganti atribut dengan versi yang lebih baru, akhiran versi harus ditambahkan ke atribut :

MSIP_Label_GUID_EnabledV2 = True | False | Condition

Dukungan untuk Penulisan Bersama yang Dilindungi

Saat penulisan bersama untuk file yang dienkripsi dengan label sensitivitas diaktifkan, lokasi dan format penyimpanan metadata label untuk file Word, Excel, dan PowerPoint berubah.

Saat fitur penulisan bersama diaktifkan, SDK secara otomatis membaca dan menulis informasi ke dan dari lokasi penyimpanan metadata yang diperbarui. Jika metadata label tidak ada di lokasi baru, SDK akan mencoba membaca metadata dari lokasi penyimpanan warisan. Jika ditemukan, label tersedia melalui operasi pengambilan label. Lain kali operasi label yang ditetapkan dilakukan, metadata ditulis ke lokasi LabelInfo yang diperbarui.

Tujuan properti seperti yang dijelaskan sebelumnya tidak berubah.

Referensi berikut menjelaskan format dan lokasi penyimpanan:

Email

Metadata yang diterapkan ke email mempertahankan format pasangan kunci/nilai yang mirip dengan dokumen. Perbedaan utamanya adalah bahwa semua atribut diserialisasikan ke satu header email yang disebut MSIP_Labels. Pasangan kunci/nilai dibatasi oleh titik koma dan spasi kosong, dan ditempatkan di header baru.

Menggunakan metadata sampel di atas:

MSIP_Labels: MSIP_Label_2096f6a2-d2f7-48be-b329-b73aaa526e5d_Enabled=true; MSIP_Label_2096f6a2-d2f7-48be-b329-b73aaa526e5d_SetDate=2018-11-08T21:13:16-0800; MSIP_Label_2096f6a2-d2f7-48be-b329-b73aaa526e5d_Method=Privileged; MSIP_Label_2096f6a2-d2f7-48be-b329-b73aaa526e5d_Name=Confidential; MSIP_Label_2096f6a2-d2f7-48be-b329-b73aaa526e5d_SiteId=cb46c030-1825-4e81-a295-151c039dbf02; MSIP_Label_2096f6a2-d2f7-48be-b329-b73aaa526e5d_ContentBits=2; MSIP_Label_2096f6a2-d2f7-48be-b329-b73aaa526e5d_ActionId=88124cf5-1340-457d-90e1-0000a9427c99
  • Last updated on