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_GUID
yeni 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