Microsoft Information Protection SDK – Metadata

Sada Microsoft Information Protection SDK vygeneruje sadu metadat, která by se měla použít u souboru. Tato metadata jsou reprezentací popisku. Tento dokument popisuje metadata, která sada SDK generuje, aby se použila pro poštu, dokumenty a další záznamy.

Popisky

Popisky v sadě Microsoft Information Protection SDK se aplikují na informace, aby popsaly citlivost těchto informací. Data o popisku jsou uložena v souboru nebo záznamu formou párů klíč-hodnota, které popisují popisek. Název metadat je založený na následující struktuře:

DefinedPrefix_ElementType_GlobalIdentifier_AttributeName

Při použití na data označená službou Microsoft Purview Information Protection je výsledkem:

MSIP_Label_GUID_Enabled = true

Identifikátor GUID je jedinečný identifikátor pro každý štítek v organizaci. Objekt může mít pouze jeden popisek ze stejné organizace. Do souboru nebo objektu nelze zapsat více popisků ze stejné organizace.

Metadata sady Microsoft Information Protection SDK

Sada MIP SDK používá následující sadu metadat.

Atribut Typ nebo hodnota Popis Povinné
Povoleno Pravda nebo Nepravda Tento atribut označuje, zda je pro datovou položku povolená klasifikace reprezentovaná touto sadou párů klíč-hodnota. Produkty ochrany před únikem informací obvykle ověřují existenci tohoto klíče a identifikují popisek klasifikace. Ano
SiteId GUID Identifikátor tenanta Microsoft Entra Ano
ActionId (odebráno v MIP SDK verze 1.8 a pozdější) GUID ActionID se změní pokaždé, když je nastaven popisek. Protokoly auditu zahrnují staré i nové ID akce, které umožňují propojení aktivity označování dat s datovou položkou. Ano
Metoda Standard nebo Privileged Nastavte pomocí mip::AssignmentMethod. Standardně to znamená, že popisek se používá výchozím způsobem nebo automaticky. Označení 'privilegované' naznačuje, že štítek byl vybrán ručně. No
Nastavit datum Rozšířený formát dat ISO 8601 Časové razítko, kdy byl štítek nastaven. No
Název řetězec Označení jedinečného názvu v rámci prostředí. Nemusí nutně odpovídat zobrazovaného názvu. No
ContentBits integer ContentBits je bitová maska, která popisuje typy označení obsahu použitého u obsahu na základě zásad a možností klienta. CONTENT_HEADER = 0X1, CONTENT_FOOTER = 0X2, WATERMARK = 0X4, ENCRYPT = 0x8 No

Pokud se použije u souboru, výsledek se podobá následující tabulce.

Klíč Hodnota
MSIP_Label_2096f6a2-d2f7-48be-b329-b73aaa526e5d_Povoleno true
MSIP_Label_2096f6a2-d2f7-48be-b329-b73aaa526e5d_SetDate 2018-11-08T21:13:16-0800
MSIP_Label_2096f6a2-d2f7-48be-b329-b73aaa526e5d_Method Privilegované
MSIP_Label_2096f6a2-d2f7-48be-b329-b73aaa526e5d_Name Důvěrné
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

Vlastnost contentBits metadat v sadě MIP SDK se používá k označení, které akce úpravy obsahu byly u souboru provedena aplikací popisků.

contentBits mohou číst následné aplikace, aby pochopily, které akce byly na soubor použity. Pomocí této vlastnosti může aplikace, jako je Word, Excel nebo PowerPoint, porovnat hodnotu metadat souboru s hodnotou, kterou vypočítá na základě zásad. Pokud existuje rozdíl, může se použít chybějící informace.

Vezměme si například sadu MIP File SDK. Nepodporuje použití záhlaví, zápatí ani vodoznaku přímo u souboru. Pokud je soubor označený MIP SDK, jedinými výsledky pro contentBits jsou 0x0 , pokud je soubor nechráněný nebo 0x8 , pokud je soubor chráněný. To platí, i když je politika popisků nakonfigurována se záhlavím, zápatím a vodoznakem.

Po otevření souboru v Microsoft Wordu chybí záhlaví, zápatí a vodoznak. Když uživatel klikne na uložit, zásada se znovu vyhodnotí a obsahové bity v souboru se porovnají s výsledkem zásady. Pokud existuje rozdíl, aplikace použije chybějící označení obsahu.

Poznámka:

Tato funkce vyžaduje dnes klienta Microsoft Purview Information Protection a funguje jenom ve Wordu, Excelu nebo PowerPointu. Nevztahuje se na Aplikaci Outlook.

Rozšíření metadat o vlastní atributy

Vlastní metadata mohou být připojena prostřednictvím File a Policy SDK. Vlastní atributy musí udržovat základní MSIP_Label_GUID předponu.

Například aplikace napsaná společností Contoso Corporation musí používat metadata označující, který systém vygeneroval označený soubor. Aplikace může vytvořit nový popisek s předponou MSIP_Label_GUID. K předponě se připojí název dodavatele softwaru a vlastní atribut, aby se vygenerovala vlastní metadata.

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

Poznámka:

Kvůli zachování kompatibility mezi běžnými aplikacemi je maximální délka každého klíče a hodnota 255 znaků.

Poznámka:

Pokud je povoleno chráněné spoluvytváření, vlastní vlastnosti metadat budou zapsány do komponenty custom.xml podporovaných typů souborů aplikace Office.

Vytváření verzí

V průběhu času se budou zavádět, upravovat nebo vyřazovat atributy. Očekává se, že aplikace budou dál zpracovávat tyto staré nebo vyřazené atributy, protože nahrazení hodnoty v rámci podniku může trvat roky.

Při nahrazení atributu novější verzí by se k atributu měla přidat přípona verze:

MSIP_Label_GUID_EnabledV2 = True | False | Condition

Podpora pro chráněné spoluvytváření

Při spoluvytváření souborů zašifrovaných pomocí popisků citlivosti se změní umístění a formát úložiště metadat popisků pro soubory Wordu, Excelu a PowerPointu.

Když je povolená funkce spoluvytváření, sada SDK automaticky čte a zapisuje informace do a z aktualizovaného umístění úložiště metadat. Pokud metadata popisků v novém umístění neexistují, sada SDK se pokusí přečíst metadata ze staršího umístění úložiště. Pokud se tento popisek najde, je k dispozici prostřednictvím operací získání popisku. Při příštím provedení operace nastavení popisku se metadata zapíšou do aktualizovaných umístění LabelInfo.

Účel vlastností, jak jsme popsali dříve, se nezmění.

Následující odkazy popisují formát a umístění úložiště:

Email

Metadata použitá u e-mailu udržují formát páru klíč/hodnota podobný formátu dokumentů. Primární rozdíl spočívá v tom, že všechny atributy jsou serializovány do jedné hlavičky e-mailu s názvem MSIP_Labels. Páry klíč/hodnota jsou oddělené středníkem a prázdným znakem a umístí se do nové hlavičky.

Použití ukázkových metadat výše:

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