Nejčastější dotazy a problémy sady MICROSOFT Information Protection (MIP) SDK

Tento článek obsahuje odpovědi na nejčastější dotazy a pokyny k řešení potíží se známými problémy a běžnými chybami.

Nejčastější dotazy

Změny úložiště metadat

Oznámili jsme, že provádíme změnu umístění úložiště metadat popisků pro soubory Office (Word, Excel, PowerPoint), abychom podporovali nové funkce v Office 365, SharePointu Online a dalších službách.

Nejčastější dotazy k metadatem

Otázka: Ovlivňují se jiné formáty, například PDF?

• Ne, jenom soubory Office, konkrétně wordové, excelové a powerpointové soubory.

Otázka: Vyžaduje se konkrétní verze sady MIP SDK?

• Sada MIP SDK 1.7 a novější jsou plně kompatibilní.

Otázka: 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ávci tenanta nepovolí chráněnou funkci spoluvytváření.

Otázka: Jsou existující metadata uložena jako vlastní vlastnost v custom.xml být aktuální?

• 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á prostřednictvím LabelingOptions.ExtendedProperties zůstávají v custom.xml.

Otázka: Je možné číst metadata popisků bez sady MIP SDK?

• Ano, ale k analýze souboru a extrahování informací musíte implementovat vlastní kód.

Otázka: 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). Kontrola MS-OFFCRYPTO: LabelInfo a vlastní vlastnosti dokumentu | Microsoft Docs. podrobnosti o implementaci.

Otázka: Návody určit, jestli je v zásadách popisků povolené spoluvytváření? Stav nastavení spoluvytváření se vrátí z modulu zásad. Aplikace může číst nezpracované bajty z modulu zásad, aby určila stav spoluvytváření.

Otázka: Jak se popisky migrují do nového umístění?

• Následující logika slouží k určení oddílu, který se čte a používá ke čtení nebo zápisu dat popisků.

Akce	Funkce není povolená	Funkce povolená
Čteno	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.xml není žádný popisek, popisek v custom.xml nebo Doc SummaryInfo je efektivní popisek.
Write	Všechny nové popisky se zapisují do custom.xml (nechráněné) nebo Doc SummaryInfo (chráněné).	Všechny nové popisky se zapisují do labelinfo.xml.

Analýza souborů

Otázka: Můžu zapisovat do stejného souboru, který právě čtete pomocí sady File SDK?

Sada MIP SDK nepodporuje souběžné čtení a zápis stejného souboru. Všechny označené soubory mají za následek kopii vstupního souboru s použitými akcemi popisku. Aplikace musí nahradit původní soubor s popiskem.

Zpracování řetězců sady SDK

Otázka: Jak sada SDK zpracovává řetězce a jaký typ řetězce mám v kódu používat?

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	Pokyny
Nativní pro Windows	Pro klienty sady C++ SDK se typ std::string standardní knihovny jazyka C++ používá k předávání řetězců do a z funkcí rozhraní API. SADA MIP SDK interně spravuje převod na/z UTF-8. std::string Při vrácení z rozhraní API musíte při převodu řetězce očekávat kódování UTF-8 a odpovídajícím způsobem spravovat. V některých případech se řetězec vrátí jako součást vektoru uint8_t (například licence pro publikování (PL)), ale měl by se považovat za neprůhlený objekt blob. Další informace a příklady najdete tady: Funkce WideCharToMultiByte pro pomoc s převodem širokého znakového řetězce na vícebajtové, například UTF-8. Následující ukázkové soubory zahrnuté ve stažení sady SDK: Ukázkové řetězcové funkce v file\samples\common\string_utils.cpp, pro převod na/z širokých řetězců UTF-8. Implementace in wmain(int argc, wchar_t *argv[]) file\samples\file\main.cpp, která používá předchozí funkce převodu řetězců.
.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. SADA 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

Otázka: 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ů. Při zápisu metadat popisků do souboru zapíše sada File SDK vlastnost metadat contentBits , která indikuje, že byla použita ochrana (pokud je nakonfigurovaná). Nezapisuje vlastnosti, které označují použití záhlaví, zápatí nebo vodoznaku. Při otevření souboru v aplikaci by měla být konfigurace označení obsahu vyhodnocena aplikací a zapsána do souboru při uložení.

Ochrana a sada SDK zásad v Androidu

Otázka: Kterou sdílenou knihovnu mám použít k integraci sady MIP SDK do aplikace pro Android?

Binární soubory SADY MIP SDK pro Android zahrnují libmip_core.so, libmip_upe_sdk.so libmip_protection_sdk.soa lipmip_unified.so. libmip_unified.so je doporučená knihovna, která zahrnuje základní knihovny, ochranu a sdílené knihovny zásad.

Kompatibilita

Otázka: Je kompatibilní sada MICROSOFT Information Protection SDK Federal Information Processing Standard (FIPS) 140-2?

Viz ověření FIPS 140-2.

Referenční informace k problémům a chybám

Chyba: Formát souboru není podporován.

Otázka: Proč se při pokusu o ochranu nebo označení souboru PDF zobrazí následující chyba?

Formát souboru není podporován.

Výsledkem této výjimky je pokus o ochranu nebo označení souboru PDF, který je digitálně podepsaný nebo chráněný heslem. Další informace o ochraně a označování souborů PDF najdete v tématu Nová podpora šifrování PDF pomocí služby Microsoft Information Protection .

Chyba: NoPolicyException: Zásady popisku neobsahují data

Otázka: Proč se při pokusu o přečtení popisku nebo popisků seznamu prostřednictvím sady MIP SDK zobrazí následující chyba?

NoPolicyException: Zásada popisku neobsahovala data, CorrelationId=GUID, CorrelationId.Description=PolicyProfile, NoPolicyError.Category=SyncFile, NoPolicyError.Category=SyncFile

Tato chyba značí, že zásady popisků nejsou publikovány v Portál dodržování předpisů Microsoft Purview. Postupujte podle pokynů k vytvoření a konfiguraci popisků citlivosti a jejich zásad a nakonfigurujte zásady popisování.

Pokud byly publikovány zásady popisování, ujistěte se, že je uživatelský účet součástí všech skupin, které jsou součástí oddílu publikované v konfiguraci zásad popisků. Další informace najdete v tématu Vytvoření a publikování popisků citlivosti.

Externí uživatelé, včetně uživatelů typu host, nemají přístup k zásadám popisků jiné organizace. Pokud chcete těmto uživatelům vyhovět, implementujte mechanismus opakování. NoPolicyException Pokud je vyvolána, nastavte FileEngineSettings vlastnost ProtectionOnlyEngine na true a zkuste požadavek zopakovat. Operace popisování nebudou pro danou IFileEngine instanci dostupné, ale budou k dispozici operace ochrany.

Chyba: System.ComponentModel.Win32Exception: LoadLibrary selhalo

Otázka: Proč se při použití obálky .NET SDK MIP zobrazí následující chyba?

System.ComponentModel.Win32Exception: LoadLibrary selhal pro: [sdk_wrapper_dotnet.dll] při volání MIP. Inicializace().

Vaše aplikace nemá požadovaný modul runtime nebo nebyl sestavený jako verze. Další informace najdete v tématu Zajištění, že vaše aplikace má požadovaný modul runtime .

Chyba: Výjimka ProxyAuthError

Otázka: Proč se při použití sady MIP SDK zobrazí následující chyba?

ProxyAuthenticatonError: Ověřování proxy serveru není podporováno

Sada MIP SDK nepodporuje použití ověřených proxy serverů. Pokud chcete tuto zprávu vyřešit, měli by správci proxy serveru nastavit koncové body služby Microsoft Purview Information Protection tak, aby proxy vynechali. Seznam těchto koncových bodů je k dispozici na stránce adres URL a rozsahů IP adres Office 365. Sada MIP SDK vyžaduje, aby *.protection.outlook.com (řádek 9) a koncové body služby Azure Information Protection (řádek 73) obešly ověřování proxy serveru.

Chyba: Neznámá chyba při označování souboru obrázku pomocí výstupu datového proudu

Otázka: Proč se při pokusu o přidání nebo odebrání popisku nebo ochrany z typu souboru obrázku pomocí datového proudu pro výstup zobrazí neznámá chyba?

Při použití datového proudu pro výstup musí mít stream přístup pro čtení i zápis, aby mohl upravit popisek nebo ochranu souboru obrázku.

Otázka: Existují nějaká omezení na základě služeb při používání sady MIP SDK?

Služba ochrany používaná sadou SDK ochrany nebo operacemi ochrany v sadě File SDK má limit 7 500 požadavků na 10 sekund pro celou organizaci. To znamená, že 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, obě aplikace mohou začít přijímat HTTP 429 Too Many Requests odpovědi. Vývojáři musí při přijetí těchto výjimek implementovat období zpětného odsud.