Microsoft Information Protection (MIP) SDK – gyakori kérdések és problémák

Ez a cikk választ ad a gyakori kérdésekre (GYIK), és hibaelhárítási útmutatást nyújt az ismert problémákhoz és gyakori hibákhoz.

Gyakori kérdések

Metaadatok tárterületének változásai

Bejelentettük, hogy módosítjuk az Office-fájlok (Word, Excel, PowerPoint) címke metaadat-tárolási helyét az Office 365, a SharePoint Online és más szolgáltatások új funkcióinak támogatása érdekében.

Metaadatok – gyakori kérdések

Kérdés: Vannak más formátumok is, például PDF?

• Nem, csak Office-fájlok, különösen Word-, Excel- és PowerPoint-fájlok.

Kérdés: Szükség van a MIP SDK adott verziójára?

• A MIP SDK 1.7 és újabb verziói teljes mértékben kompatibilisek.

Kérdés: Az Office-ügyfélnek van egy adott verziója, amelyre szükség van a tárolási hely használatához?

• A 2021 szeptembere után kiadott összes Microsoft 365-alkalmazások ügyfél támogatja ezt az új metaadat-helyet. Az új tárolási hely csak akkor lesz használatban, ha a bérlői rendszergazdák engedélyezik a védett társszerzőség funkciót.

Kérdés: A meglévő metaadatok egyéni tulajdonságként vannak tárolva custom.xml naprakészek?

• Szám Amikor a dokumentumot az új tárolási hely engedélyezése után először menti a rendszer, a címke metaadatai átkerülnek az új helyre. A custom.xml maradnak meg a metaadatokLabelingOptions.ExtendedProperties.

Kérdés: Lehetséges a címke metaadatainak olvasása MIP SDK nélkül?

• Igen, de saját kódot kell implementálnia a fájl elemzéséhez és az információk kinyeréséhez.

Kérdés: Jelenleg egyszerűen "olvasható" a címke a kulcs-érték pár sztringjeinek kinyerésével a fájlból. Továbbra is olvashatók a metaadatok?

• Igen, a metaadatok továbbra is elérhetők az olvasható Office-fájl XML-fájljában. Az alkalmazásnak be kell olvasnia a társszerzőségi beállítást a szabályzatfájlból, hogy tudja, az új funkciókészlet engedélyezve van. Ez a beállítás határozza meg a címkeadatok olvasási/írási helyét (custom.xml és labelinfo.xml). Az MS-OFFCRYPTO: LabelInfo és az egyéni dokumentumtulajdonságok áttekintése | Microsoft Docs. a megvalósítás részleteiért.

Kérdés: Hogyan határozza meg, hogy engedélyezve van-e a társszerzőség a címkeszabályzatban? A társszerzőség beállításának állapotát a szabályzatmotor adja vissza. Az alkalmazások beolvashatják a nyers bájtokat a szabályzatmotorból a társszerzőség állapotának meghatározásához.

Kérdés: Hogyan migrálják a címkéket az új helyre?

• Az alábbi logika határozza meg, hogy melyik szakaszt olvassa be, és melyik szakaszt használja a címkeadatok olvasásához vagy írásához.

Művelet	A funkció nincs engedélyezve	Funkció engedélyezve
Olvasás	Címke custom.xml (nem védett) vagy Doc SummaryInfo (védett).	Ha a címke labelinfo.xml létezik, akkor az érvényes címke. Ha nincs címke a labelinfo.xml, akkor a custom.xml vagy a Doc SummaryInfo címkéje a tényleges címke.
Írás	Minden új címke custom.xml (nem védett) vagy Doc SummaryInfo (védett) fájlba lesz írva.	Minden új címke labelinfo.xml lesz megírva.

Fájlelemzés

Kérdés: Írhatok ugyanarra a fájlra, amelyet éppen olvasok a Fájl SDK-val?

A MIP SDK nem támogatja ugyanazon fájl egyidejű olvasását és írását. A címkézett fájlok a bemeneti fájl másolatát eredményezik a címkeműveletek alkalmazásával. Az alkalmazásnak az eredetit a címkézett fájlra kell cserélnie.

SDK-sztring kezelése

Kérdés: Hogyan kezeli az SDK a sztringeket, és milyen sztringtípust használjak a kódban?

Az SDK platformfüggetlen, és UTF-8 (Unicode-átalakítási formátum – 8 bites) sztringkezelést használ. A konkrét útmutatás a használt platformtól függ:

Platform	Útmutató
Windows natív	A C++ SDK-ügyfelek esetében a C++ Standard kódtártípust std::string használják a sztringek API-függvények felé vagy onnan történő továbbításához. A MIP SDK belsőleg kezeli az UTF-8-ra/ről való átalakítást. Ha egy API-ból ad vissza egy std::string UTF-8 kódolást, és ennek megfelelően kell kezelnie a sztring konvertálását. Bizonyos esetekben egy sztring egy vektor (például közzétételi uint8_t licenc (PL) részeként jelenik meg, de átlátszatlan blobként kell kezelni. További információkért és példákért lásd: A WideCharToMultiByte függvény segítséget nyújt a széles karaktersorozatok többbájtossá, például UTF-8-assá alakításához. Az SDK letöltésében szereplő alábbi mintafájlok: Minta sztring segédprogramfüggvények file\samples\common\string_utils.cppszéles UTF-8 sztringekké alakításához. Az in file\samples\file\main.cppimplementációjawmain(int argc, wchar_t *argv[]), amely az előző sztringkonvertálási függvényeket használja.
.NET	A .NET SDK-ügyfelek esetében minden sztring az alapértelmezett UTF-16 kódolást használja, és nincs szükség speciális átalakításra. A MIP SDK belsőleg kezeli az UTF-16-ra/ről való átalakítást.
Más platformok	A MIP SDK által támogatott összes többi platform natív támogatást nyújt az UTF-8-hoz.

Tartalom megjelölése

Kérdés: Támogatja a MIP SDK a tartalomjelölést?

A MIP SDK nem támogatja a tartalomjelölés közvetlen alkalmazását, beleértve az élőfejet, az élőlábat vagy a vízjelet egyetlen fájlon sem. Ha a címke metaadatait egy fájlba írja, a Fájl SDK a contentBits metaadat-tulajdonságát írja, jelezve, hogy a védelem alkalmazva lett (ha konfigurálva van). Nem írja meg az élőfejet, élőlábat vagy vízjelet jelző tulajdonságokat. Amikor a fájl meg van nyitva egy alkalmazásban, a tartalomjelölés konfigurációját az alkalmazásnak ki kell értékelnie, és a fájlba kell írnia a mentéskor.

Protection and Policy SDK on Android

Kérdés: Melyik megosztott kódtárat érdemes használni a MIP SDK Android-alkalmazásba való integrálásához?

A MIP SDK Android bináris fájljai közé tartozik libmip_core.soaz , libmip_protection_sdk.solibmip_upe_sdk.so és lipmip_unified.so. libmip_unified.so az ajánlott kódtár, amely magában foglalja az alapvető, a védelmi és a szabályzatalapú megosztott kódtárakat.

Megfelelőség

Kérdés: Megfelel a Microsoft Information Protection SDK Federal Information Processing Standard (FIPS) 140-2 szabványnak?

Lásd: FIPS 140-2 ellenőrzés.

Problémák és hibák referenciája

Hiba: "A fájlformátum nem támogatott"

Kérdés: Miért jelenik meg a következő hiba a PDF-fájlok védelmének vagy címkézésének megkísérlésekor?

A fájlformátum nem támogatott

Ez a kivétel egy digitálisan aláírt vagy jelszóval védett PDF-fájl védelmének vagy címkézésének megkísérlését eredményezi. A PDF-fájlok védelmével és címkézésével kapcsolatos további információkért lásd : A PDF-titkosítás új támogatása a Microsoft Information Protection szolgáltatással.

Hiba: "NoPolicyException: A címkeszabályzat nem tartalmaz adatokat"

Kérdés: Miért jelenik meg a következő hibaüzenet, amikor a MIP SDK-val próbálok címkéket vagy listafeliratokat olvasni?

NoPolicyException: A címkeszabályzat nem tartalmaz adatokat, CorrelationId=GUID, CorrelationId.Description=PolicyProfile, NoPolicyError.Category=SyncFile, NoPolicyError.Category=SyncFile

Ez a hiba azt jelzi, hogy a címkeszabályzat nincs közzétéve a Microsoft Purview megfelelőségi portál. Kövesse a bizalmassági címkék és szabályzataik létrehozását és konfigurálását a címkézési szabályzat konfigurálásához.

Ha közzétettek egy címkézési szabályzatot, győződjön meg arról, hogy a felhasználói fiók szerepel a címkeszabályzat konfigurációjának szakaszában közzétett csoportokban. További információ: Bizalmassági címkék létrehozása és közzététele.

A külső felhasználók, köztük a vendégfelhasználók nem férhetnek hozzá egy másik szervezet címkeszabályzataihoz. A felhasználók elhelyezéséhez implementáljon egy újrapróbálkozásos mechanizmust. Ha egy NoPolicyException dobás történik, állítsa a FileEngineSettings ProtectionOnlyEngine tulajdonságot igaz értékre, és próbálkozzon újra a kéréssel. A címkézési műveletek nem lesznek elérhetők az adott IFileEngine példányhoz, de a védelmi műveletek elérhetők lesznek.

Hiba: "System.ComponentModel.Win32Exception: LoadLibrary failed"

Kérdés: Miért jelenik meg a következő hiba a MIP SDK .NET Burkoló használatakor?

System.ComponentModel.Win32Exception: A LoadLibrary nem sikerült: [sdk_wrapper_dotnet.dll] a MIP hívása során. Inicializálás().

Az alkalmazás nem rendelkezik a szükséges futtatókörnyezetével, vagy nem kiadásként lett létrehozva. További információ: Győződjön meg arról, hogy az alkalmazás rendelkezik a szükséges futtatókörnyezetel .

Hiba: "ProxyAuthError exception"

Kérdés: Miért jelenik meg a következő hiba a MIP SDK használatakor?

"ProxyAuthenticatonError: A proxyhitelesítés nem támogatott"

A MIP SDK nem támogatja a hitelesített proxyk használatát. Az üzenet javításához a proxygazdáknak a proxy megkerülésére kell beállítaniuk a Microsoft Purview információvédelem szolgáltatásvégpontokat. A végpontok listája az Office 365 URL-címeinek és IP-címtartományainak lapján érhető el. A MIP SDK megköveteli, hogy *.protection.outlook.com (9. sor) és az Azure Information Protection szolgáltatásvégpontjai (73. sor) megkerüljék a proxyhitelesítést.

Hiba: "Ismeretlen hiba" képfájl streamkimenettel történő címkézésekor

Kérdés: Miért kapok "ismeretlen hibát", amikor egy címkét vagy védelmet próbálok hozzáadni vagy eltávolítani egy képfájltípusból egy stream használatával a kimenethez?

Amikor streamet használ a kimenethez, a streamnek olvasási és írási hozzáféréssel kell rendelkeznie a képfájl címkéjének vagy védelmének módosításához.

Kérdés: Vannak szolgáltatásalapú szabályozási korlátozások a MIP SDK használatakor?

A védelmi szolgáltatás, amelyet a védelmi SDK vagy a Fájl SDK védelmi műveletei használnak, 10 másodpercenként 7500 kérést engedélyez egy teljes szervezet számára. Vagyis ha az A alkalmazás 4000 kérést generál 10 másodpercenként, és a B alkalmazás ugyanabban a szervezetben 4000 kérést generál 10 másodpercenként, akkor mindkét alkalmazás elkezdhet válaszokat kapni HTTP 429 Too Many Requests . A fejlesztőknek visszalépési időszakot kell implementálniuk, amikor ezek a kivételek érkeznek.