Microsoft Information Protection SDK - Meta Veriler

Microsoft Information Protection SDK'sı bir dosyaya uygulanması gereken meta veri kümesini oluşturur. Bu meta veriler etiketin bir gösterimidir. Bu belgede, SDK'nın posta, belgeler ve diğer kayıtlara uygulamak için oluşturduğu meta veriler açıklanmaktadır.

Etiketler

Microsoft Information Protection SDK'sı etiketleri, bu bilgilerin duyarlılığını açıklamak için bilgilere uygulanır. Etiket verileri, etiketi açıklayan bir anahtar-değer çiftleri kümesindeki dosya veya kayıtta kalıcı olur. Meta veri adı aşağıdaki yapıya göre oluşturulur:

DefinedPrefix_ElementType_GlobalIdentifier_AttributeName

Microsoft Purview Bilgi Koruması etiketli verilere uygulandığında sonuç şöyledir:

MSIP_Label_GUID_Enabled = true

GUID, kuruluştaki her etiket için benzersiz bir tanımlayıcıdır. Bir nesne aynı kuruluştan yalnızca bir etikete sahip olabilir. Aynı kuruluştan birden çok etiket bir dosyaya veya nesneye yazılamaz.

Microsoft Information Protection SDK Meta Verileri

MIP SDK'sı aşağıdaki meta veri kümesini uygular.

Öznitelik	Tür veya Değer	Açıklama	Zorunlu
Etkin	Doğru veya Yanlış	Bu öznitelik, bu anahtar-değer çiftleri kümesiyle temsil edilen sınıflandırmanın veri öğesi için etkinleştirilip etkinleştirilmediğini gösterir. DLP ürünleri genellikle sınıflandırma etiketini tanımlamak için bu anahtarın varlığını doğrular.	Yes
SiteId	GUID	Microsoft Entra kiracı kimliği	Yes
ActionId (MIP SDK 1.8 ve sonraki sürümlerde kaldırıldı)	GUID	Bir etiket her ayarlandığında ActionID değiştirilir. Denetim günlükleri, etiketleme etkinliğinin veri öğesine zincirlenmesine izin vermek için hem eski hem de yeni actionID'yi içerir.	Yes
Yöntem	Standart veya Ayrıcalıklı	mip::AssignmentMethod aracılığıyla ayarlayın. Standart, etiketin varsayılan olarak veya otomatik olarak uygulandığını gösterir. Privileged, etiketin el ile seçildiğini gösterir.	Hayır
Setdate	Genişletilmiş ISO 8601 Tarih Biçimi	Etiketin ayarlandığı zaman damgası.	Hayır
Ad	Dize	Kiracı içindeki benzersiz adı etiketleyin. Görünen ada karşılık gelmez.	Hayır
ContentBits	integer	ContentBits , ilke ve istemci özelliklerine göre içeriğe uygulanan içerik işaretleme türlerini açıklayan bir bit maskesidir. CONTENT_HEADER = 0X1, CONTENT_FOOTER = 0X2, WATERMARK = 0X4, ENCRYPT = 0x8	Hayır

Bir dosyaya uygulandığında, sonuç aşağıdaki tabloya benzer.

Anahtar	Değer
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	Ayrıcalıklı
MSIP_Label_2096f6a2-d2f7-48be-b329-b73aaa526e5d_Name	Gizli
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

contentBits MIP SDK'sında meta veri özelliği, etiketleme uygulaması tarafından bir dosyada hangi içerik değiştirme eylemlerinin gerçekleştirildiğini belirtmek için kullanılır.

contentBits , dosyaya hangi eylemlerin uygulandığını anlamak için aşağı akış uygulamaları tarafından okunabilir. Bu özelliği kullanarak, Word, Excel veya PowerPoint gibi bir uygulama, dosya meta verilerindeki değeri ilkeye göre hesapdığı değerle karşılaştırabilir. Bir fark varsa, eksik bilgileri uygulayabilir.

Örneğin, MIP Dosya SDK'sını alın. Bir dosyaya doğrudan üst bilgi, alt bilgi veya filigran uygulamayı desteklemez. Bir dosya MIP SDK'sı ile etiketlendiğinde, contentBits 0x0 için tek sonuç, dosyanın korumasız olması veya 0x8 dosyanın korunmasıdır. Etiket ilkesinde üst bilgi, alt bilgi ve filigran yapılandırılmış olsa bile bu durum geçerlidir.

Dosya Microsoft Word'de açıldığında üst bilgi, alt bilgi ve filigran eksik olur. Kullanıcı kaydet'e tıkladığında ilke yeniden değerlendirilir ve dosyadaki contentBits ilke sonucuyla karşılaştırılır. Bir fark varsa, uygulama eksik içerik işaretini uygular.

Not

Bu özellik bugün Azure Information Protection istemcisini gerektirir ve yalnızca Word, Excel veya PowerPoint'te çalışır. Outlook için geçerli değildir.

Meta Verileri Özel Özniteliklerle Genişletme

Özel meta veriler Dosya ve İlke SDK'sı aracılığıyla eklenebilir. Özel öznitelikler temel MSIP_Label_GUID ön eki tutmalıdır.

Örneğin Contoso Corporation tarafından yazılan bir uygulama, hangi sistemin etiketli bir dosya oluşturduğunu gösteren meta veriler uygulamalıdır. Uygulama ile önekli MSIP_Label_GUIDyeni bir etiket oluşturabilir. Özel meta verileri oluşturmak için ön eke yazılım satıcısı adı ve özel öznitelik eklenir.

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

Not

Ortak uygulamalar arasında uyumluluğu korumak için her bir anahtar ve değer için uzunluk üst sınırı 255 karakterdir.

Not

Korumalı birlikte yazma deneyimi etkinleştirildiğinde, özel meta veri özellikleri desteklenen Office dosya türlerinin custom.xml bileşenine yazılır.

Sürüm oluşturma

Zamanla öznitelikler tanıtılır, değiştirilir veya kullanımdan kaldırılır. Bir kuruluş genelinde değerin değiştirilmesi yıllar alabileceğinden uygulamaların bu eski veya kullanımdan kaldırmış öznitelikleri işlemeye devam etmesi beklenir.

Özniteliği daha yeni bir sürümle değiştirirken, özniteliğine bir sürüm soneki eklenmelidir:

MSIP_Label_GUID_EnabledV2 = True | False | Condition

E-posta

E-postaya uygulanan meta veriler, belgelerinkine benzer bir anahtar/değer çifti biçimi tutar. Birincil fark, tüm özniteliklerin MSIP_Labels adlı tek bir e-posta üst bilgisinde seri hale getirilmiş olmasıdır. Anahtar/değer çiftleri noktalı virgülle ve boşlukla sınırlandırılır ve yeni üst bilgi içine yerleştirilir.

Yukarıdaki örnek meta verileri kullanarak:

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