Poznámka:
Přístup k této stránce vyžaduje autorizaci. Můžete se zkusit přihlásit nebo změnit adresáře.
Přístup k této stránce vyžaduje autorizaci. Můžete zkusit změnit adresáře.
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
Otázka: Kolik popisků podporuje SDK MIP?
- Sada MIP SDK dokáže zpracovat až 500 popisků ochrany a popisky bez ochrany nejsou nijak omezeny.
otázka: Podporuje MIP SDK opětovné označení typů .pfile s popisky klasifikace?
- Ne, je to záměrně, protože pfiles jsou chráněné typy souborů. Před klasifikací dešifrujte pomocí popisovače souborů MPIP.
otázka: Proč se chráněné soubory stahované z Microsoft Teams nedaří 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.
otázka: Jak můžu zkontrolovat, jaké štítky jsou použity, když jsou aplikovány více štítků z různých tenantů na soubor?
- Vyžádejte GetLabel v kontextu uživatele pro každého nájemce.
otázka: Proč se moje webová aplikace nedaří inicializovat kvůli interní chybě "KeyStoreWin32::OpenKey failure: NCryptOpenKey:-2147024894"?
- Sada SDK pro zásady nemusí při inicializaci aplikace načíst profil. Nastavte WEBSITE_LOAD_USER_PROFILE=1 v nastavení proměnné prostředí webové aplikace a restartujte aplikaci.
- Název: WEBSITE_LOAD_USER_PROFILE
- Hodnota : 1
otázka: Proč moje aplikace selže s chybou KeyStoreWin32::OpenKey failure: NCryptOpenKey:-2146893788 při konfiguraci ukládání do mezipaměti OnDiskEncrypted?
- Systém Windows může vytvořit dočasné profily, pokud je váš profil přihlášení nedostupný. Čtení z registru Windows pro ukládání do mezipaměti onDiskEncrypted Link s tímto dočasným profilem způsobí selhání OpenKey v protokolu sady MIP SDK a zaznamenává se protokoly událostí operačního systému Windows s ID události 1511 & 1515. Pokud chcete tento problém vyřešit, obraťte se na správce a opravte problém s vytvářením dočasných profilů.
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, která jsou uložena jako vlastní vlastnost v custom.xml, udržována 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.ExtendedPropertieszů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). Prozkoumejte MS-OFFCRYPTO: LabelInfo versus vlastní vlastnosti dokumentu | Microsoft Docs. pro podrobnosti o implementaci.
Otázka: Jak zjistím, jestli je v zásadách popisků povoleno 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í, která sekce se čte a používá ke čtení nebo zápisu údajů popisků.
| Činnost | Funkce není povolená | Funkce povolená |
|---|---|---|
| Čti | 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. |
| Napiš | Všechny nové štítky se zapisují do custom.xml (bez ochrany) nebo Doc SummaryInfo (s ochranou). | Všechny nové popisky jsou zapsány 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. 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
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 | Vodítko |
|---|---|
| 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. Když je std::string vráceno z rozhraní API, musíte očekávat kódování UTF-8 a při převodu řetězce to vhodně 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ůhledný 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
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é naznačují, že bylo použito záhlaví, zápatí nebo vodoznak. 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 Policy SDK na Androidu
Otázka: 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_protection_sdk.so, libmip_upe_sdk.so a libmip_unified.so.
libmip_unified.so je doporučovaná knihovna, která zahrnuje základní knihovny, ochranné knihovny a sdílené knihovny pro politiky.
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 označování 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 štítků nejsou zveřejněny na portálu Microsoft Purview. Postupujte podle Vytvoření a konfigurace popisků citlivosti a jejich zásad a nakonfigurujte zásady označování.
Pokud byly publikovány zásady označování, ujistěte se, že je uživatelský účet součástí všech skupin, které jsou součástí části publikováno v konfiguraci zásad označování. 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 označení jiné organizace. Pokud chcete těmto uživatelům vyhovět, implementujte mechanismus opakování. Pokud je vyvolán 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ý runtime, nebo nebyla sestavena jako Release. Další informace najdete v tématu Zajištění, že vaše aplikace obsahuje požadované závislosti .
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 Microsoft Purview Information Protection (řádek 73) mohly obejít 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.
Limity omezování
Otázka: Existují nějaká omezení regulace založená na službě při použití sady MIP SDK?
Služba Rights Management, kterou používají operace sady SDK ochrany nebo ochrany v sadě File SDK, má limit 7 500 požadavků za 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 obdržení těchto výjimek implementovat čekací dobu. Budoucí verze MIP SDK budou interně implementovat tuto prodlevu.