Tento článek odpovídá na běžné otázky týkající se sady SDK Microsoft Information Protection (MIP). Známé problémy a chybové zprávy najdete v tématu Řešení potíží se sadou MIP SDK.
Obecný
Kolik popisků podporuje sada MIP SDK?
Sada MIP SDK podporuje až 500 šifrovaných popisků citlivosti. Popisky, které nepoužívají šifrování, se na tento limit nevztahují. U tenantů s velkým počtem popisků citlivosti může docházet k určitému dopadu na výkon. Další informace najdete v tématu Omezení popisků citlivosti.
Podporuje MIP SDK přeznačení typů .pfile klasifikačními popisky?
Ne, je to záměrně, protože pfiles jsou chráněné typy souborů. Před klasifikací dešifrujte pomocí nástroje Microsoft Purview Information Protection File Labeler.
Proč nelze chráněné soubory stažené z Microsoft Teams dešifrovat?
Jedná se o známý problém v nepodporovaných verzích sady MIP SDK. Upgradujte na nejnovější verzi sady MIP SDK.
Jak zjistím, jaké popisky se použijí, když se u souboru použije více popisků z různých tenantů?
Zadejte dotaz na metodu GetLabel v kontextu uživatele pro každého tenanta.
Změny úložiště metadat
Ovlivňují se jiné formáty, například PDF?
Microsoft oznámil změnu umístění, kde se ukládají metadata popisků pro soubory Office (Word, Excel a PowerPoint), s cílem podpořit nové funkce v Office 365, SharePoint Online a dalších službách. Nejsou ovlivněny žádné jiné formáty souborů, pouze soubory Office, konkrétně Word, Excel a PowerPoint soubory.
Vyžaduje se konkrétní verze sady MIP SDK?
Sada MIP SDK 1.7 a novější jsou plně kompatibilní.
Je pro použití tohoto umístění úložiště potřeba konkrétní verze klienta Office?
Toto nové umístění metadat podporují všichni klienti Microsoft 365 Apps vydané po září 2021. Nové umístění úložiště se nepoužívá, dokud správce tenanta nepovolí funkci chráněného spoluvytváření.
Jsou existující metadata uložená jako vlastní vlastnost v *custom.xml* průběžně aktualizována?
Ne. Při prvním uložení dokumentu po povolení nového umístění úložiště se metadata popisků přesunou do nového umístění. Metadata zapsaná pomocí použití LabelingOptions.ExtendedProperties zůstávají v custom.xml.
Je možné číst metadata popisků bez sady MIP SDK?
Ano, ale musíte implementovat vlastní kód pro parsování souboru a extrahování informací.
V současné době je snadné "číst" popisek extrahováním řetězců páru klíč/hodnota ze souboru. Dají se metadata tímto způsobem stále číst?
Ano, metadata jsou stále k dispozici ve formátu XML souboru Office, který se má přečíst. Aby aplikace věděla, že je nová sada funkcí povolená, musí z souboru zásad přečíst nastavení spoluvytváření. Toto nastavení definuje, kde číst a zapisovat data popisku (custom.xml vs. labelinfo.xml). Pro podrobnosti implementace si prostudujte MS-OFFCRYPTO: LabelInfo versus vlastní vlastnosti dokumentu.
Jak zjistím, jestli je v zásadách popisků povoleno spoluautorství?
Modul pro vyhodnocování zásad vrátí stav nastavení spoluvytváření z hodnoty klíče enableLabelCoauth. Aplikace může číst nezpracované bajty z modulu zásad, aby určila stav spoluvytváření.
Jak se popisky migrují do nového umístění?
MIP SDK používá následující logiku k určení, který oddíl čte a používá pro čtení nebo zápis dat štítků.
| Action | Funkce není povolená | Povolená funkce |
|---|---|---|
| Přečíst | Popisek v custom.xml (nechráněný) nebo Doc SummaryInfo (chráněný). | Pokud popisek existuje v labelinfo.xml, je to efektivní popisek. Pokud v labelinfo.xmlnení žádný popisek, popisek v custom.xml nebo Doc SummaryInfo je efektivní popisek. |
| Write | Sada MIP SDK zapisuje všechny nové popisky do custom.xml (nechráněné) nebo Doc SummaryInfo (chráněné). | Sada MIP SDK zapisuje všechny nové popisky do labelinfo.xml. |
Analýza souborů
Můžu zapisovat do stejného souboru, který právě čtu pomocí sady File SDK?
Sada MIP SDK nepodporuje souběžné čtení a zápis stejného souboru. Jakékoliv označené soubory vedou k kopii vstupního souboru s akcemi popisku aplikovanými. Vaše aplikace musí nahradit původní soubor označeným souborem.
Zpracování řetězců sady SDK
Jak sada SDK zpracovává řetězce a jaký typ řetězce mám použít v kódu?
Sada SDK je určená k použití pro různé platformy a pro zpracování řetězců používá UTF-8 (Formát transformace Unicode – 8bitová verze). Konkrétní pokyny závisí na platformě, kterou používáte:
| Platforma | Průvodce |
|---|---|
| Nativní pro Windows | Pro klienty C++ SDK použijte typ std::string standardní knihovny C++ pro předávání řetězců do a z funkcí rozhraní API. SADA MIP SDK interně spravuje převod na/z UTF-8. Když rozhraní API vrátí std::string, musíte očekávat kódování UTF-8 a při převodu řetězce s ním odpovídajícím způsobem zacházet. V některých případech rozhraní API vrací řetězec jako součást vektoru uint8_t (například licence pro publikování (PL)), ale měli byste s ním zacházet jako s neprůzým objektem blob.Další informace a příklady najdete tady:
|
| platforma .NET | Pro klienty sady .NET SDK používají všechny řetězce výchozí kódování UTF-16 a nevyžaduje se žádný speciální převod. MIP SDK interně spravuje převod na/z UTF-16. |
| Jiné platformy | Všechny ostatní platformy podporované sadou MIP SDK mají nativní podporu pro UTF-8. |
Označení obsahu
Podporuje sada MIP SDK označení obsahu?
Sada MIP SDK nepodporuje přímé použití označení obsahu, včetně záhlaví, zápatí nebo vodoznaku, u všech souborů. Když sada File SDK zapíše metadata popisků do souboru, zapíše vlastnost metadat contentBits , která indikuje, že sada File SDK použila ochranu (pokud je nakonfigurovaná). Nezapisuje vlastnosti, které označují, že aplikace použila záhlaví, zápatí nebo vodoznak. Když aplikace soubor otevře, měla by aplikace vyhodnotit konfiguraci označení obsahu a zapsat ji do souboru při uložení.
Ochrana a Policy SDK na Androidu
Kterou sdílenou knihovnu mám použít k integraci sady MIP SDK do aplikace pro Android?
Binární soubory MIP SDK pro Android zahrnují libmip_core.so, libmip_upe_sdk.so, libmip_protection_sdk.so a libmip_unified.so.
libmip_unified.so je doporučenou knihovnou a zahrnuje sdílené knihovny jádra, ochrany a zásad.
Compliance
Je sada SDK Microsoft Information Protection v souladu se standardem Federal Information Processing Standard (FIPS) 140-2?
Viz ověření FIPS 140-2.
Regulace výkonu
Existují při používání sady MIP SDK nějaké limity omezování na úrovni služby?
Služba Rights Management, kterou používá sada SDK ochrany nebo operace ochrany v sadě File SDK, má limit 7 500 požadavků na 10 sekund pro celou organizaci. Pokud aplikace A generuje 4 000 požadavků za 10 sekund a aplikace B ve stejné organizaci generuje 4 000 požadavků za 10 sekund, můžou obě aplikace začít přijímat HTTP 429 Too Many Requests odpovědi. Vývojáři musí zavést čekací interval, když obdrží tyto výjimky. Budoucí verze sady MIP SDK mají tuto dobu odkladu implementovanou interně.