Aracılığıyla paylaş

Microsoft Information Protection SDK - Metaveri

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
Etkinleştirildi 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 tenant 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 bilgisi. Hayır
Ad Dize Kiracı içindeki benzersiz adı etiketleyin. Görünen ada karşılık gelmez. Hayır
ContentBits tam sayı 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_Aktif doğru
MSIP_Label_2096f6a2-d2f7-48be-b329-b73aaa526e5d_SetDate 2018-11-08T21:13:16-0800
MSIP_Label_2096f6a2-d2f7-48be-b329-b73aaa526e5d_Yöntem 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_İçerikBitişleri 2
MSIP_Label_2096f6a2-d2f7-48be-b329-b73aaa526e5d_ActionId 88124cf5-1340-457d-90e1-0000a9427c99

İçerikBitleri

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 üst bilgi, alt bilgi veya filigranı doğrudan 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, MSIP_Label_GUID önekiyle 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

Korumalı Birlikte Yazma Desteği

Duyarlılık etiketleriyle şifrelenmiş dosyalar için birlikte yazma etkinleştirildiğinde, Word, Excel ve PowerPoint dosyalarının etiket meta veri depolama konumu ve biçimi değişir.

Birlikte yazma özelliği etkinleştirildiğinde SDK, güncelleştirilmiş meta veri depolama konumundan otomatik olarak bilgi okur ve bu konumdan bilgi yazar. Etiket meta verileri yeni konumda yoksa SDK, meta verileri eski depolama konumundan okumaya çalışır. Bulunursa etiket, etiket alma işlemleri aracılığıyla kullanılabilir. Bir sonraki etiket kümesi işlemi gerçekleştirildiğinde meta veriler güncelleştirilmiş LabelInfo konumlarına yazılır.

Özelliklerin daha önce açıklandığı gibi amacı değişmez.

Aşağıdaki referanslar biçim ve depolama konumlarını açıklamaktadır.

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