Den här artikeln besvarar vanliga frågor om Microsoft Information Protection (MIP) SDK. Kända problem och felmeddelanden finns i MIP SDK-felsökning.
Allmänt
Hur många etiketter stöds av MIP SDK?
MIP SDK stöder upp till 500 krypterade känslighetsetiketter. Etiketter som inte använder kryptering omfattas inte av den här gränsen. Klienter med ett stort antal känslighetsetiketter kan uppleva viss prestandapåverkan. Mer information finns i Begränsningar för känslighetsetiketter.
Har MIP SDK stöd för ommärkning av .pfile-typer med klassificeringsetiketter?
Nej, detta är avsiktligt eftersom pfiles är skyddade filtyper. Dekryptera med Microsoft Purview Information Protection-filetiketten före klassificeringen.
Varför går det inte att dekryptera skyddade filer som laddats ned från Microsoft Teams?
Det här är ett känt problem i versioner av MIP SDK som inte stöds. Uppgradera till den senaste versionen av MIP SDK.
Hur kontrollerar jag vilka etiketter som används när flera etiketter från olika klientorganisationer tillämpas på en fil?
Anropa metoden GetLabel i användarens kontext för varje klientorganisation.
Ändringar i metadatalagring
Påverkas andra format, till exempel PDF?
Microsoft meddelade en ändring av lagringsplatsen för etikettmetadata för Office-filer (Word, Excel och PowerPoint) för att stödja nya funktioner i Office 365, SharePoint Online och andra tjänster. Inga andra filformat påverkas, endast Office-filer, särskilt Word, Excel och PowerPoint filer.
Finns det en specifik version av MIP SDK som krävs?
MIP SDK 1.7 och senare är helt kompatibla.
Finns det en specifik version av Office-klienten som krävs för att använda den här lagringsplatsen?
Alla Microsoft 365-applikationer klienter som släppts efter september 2021 stöder den här nya metadataplatsen. Den nya lagringsplatsen används inte förrän klientadministratören aktiverar funktionen för skyddad medautentisering.
Lagras befintliga metadata som en anpassad egenskap i *custom.xml* uppdaterade?
No. Första gången du sparar dokumentet när du har aktiverat den nya lagringsplatsen flyttas etikettmetadata till den nya platsen. Metadata som har skrivits med hjälp av LabelingOptions.ExtendedProperties finns kvar i custom.xml.
Går det att läsa etikettmetadata utan MIP SDK?
Ja, men du måste implementera din egen kod för att parsa filen och extrahera informationen.
För närvarande är det enkelt att "läsa" etiketten genom att extrahera nyckel-/värdeparsträngarna från filen. Kan metadata fortfarande läsas på det här sättet?
Ja, metadata är fortfarande tillgängliga i Office-filens XML som ska läsas. Programmet måste läsa medautentiseringsinställningen från principfilen för att veta att den nya funktionsuppsättningen är aktiverad. Den här inställningen definierar var etikettdata ska läsas/skrivas (custom.xml jämfört medlabelinfo.xml). Granska MS-OFFCRYPTO: LabelInfo jämfört med anpassade dokumentegenskaper för implementeringsinformation.
Hur avgör jag om samskrivning är aktiverad i etikettprincipen?
Principmotorn returnerar tillståndet för inställningen för samskrivning utifrån värdet för nyckeln enableLabelCoauth. Ett program kan läsa rå byte från principmotorn för att fastställa medförfattarens status.
Hur migreras etiketter till den nya platsen?
MIP SDK använder följande logik för att avgöra vilket avsnitt det läser och använder för att läsa eller skriva etikettdata.
| Action | Funktionen är inte aktiverad | Funktionen är aktiverad |
|---|---|---|
| Läs | Etikett i custom.xml (oskyddad) eller Doc SummaryInfo (skyddad). | Om det finns en etikett i labelinfo.xmlär det den effektiva etiketten. Om det inte finns någon etikett i labelinfo.xmlär etiketten i custom.xml eller Doc SummaryInfo den effektiva etiketten. |
| Write | MIP SDK skriver alla nya etiketter till custom.xml (oskyddad) eller Doc SummaryInfo (skyddad). | MIP SDK:n skriver alla nya etiketter till labelinfo.xml. |
Tolkning av filer
Kan jag skriva till samma fil som jag läser med fil-SDK:t?
MIP SDK stöder inte samtidig läsning och skrivning av samma fil. Alla märkta filer resulterar i en kopia av indatafilen med de etikettåtgärder som tillämpas. Ditt program måste ersätta originalet med den märkta filen.
SDK-stränghantering
Hur hanterar SDK:t strängar och vilken strängtyp ska jag använda i min kod?
SDK:t är avsett att användas plattformsoberoende och använder UTF-8 (Unicode Transformation Format – 8-bitars) för stränghantering. Specifik vägledning beror på vilken plattform du använder:
| Platform | Riktlinjer |
|---|---|
| Windows-inbyggd funktion | För C++ SDK-klienter använder du C++ standardbibliotekstypen std::string för att skicka strängar till/från API-funktioner. MIP SDK hanterar internt konvertering till/från UTF-8. När ett API returnerar en std::stringmåste du förvänta dig UTF-8-kodning och hantera i enlighet med detta om du konverterar strängen. I vissa fall returnerar ett API en sträng som en del av en uint8_t vektor (till exempel en publiceringslicens (PL)), men du bör behandla den som en ogenomskinlig blob.Mer information och exempel finns i:
|
| .NET | För .NET SDK-klienter använder alla strängar standardkodningen UTF-16 och ingen särskild konvertering krävs. MIP SDK hanterar internt konvertering till/från UTF-16. |
| Andra plattformar | Alla andra plattformar som stöds av MIP SDK har inbyggt stöd för UTF-8. |
Innehållsmarkering
Stöder MIP SDK innehållsmärkning?
MIP SDK stöder inte direkt tillämpning av innehållsmärkning, inklusive sidhuvud, sidfot eller vattenstämpel, på några filer. När File SDK skriver etikettmetadata till en fil skriver den metadataegenskapen contentBits för att indikera att File SDK tillämpade skydd (om det konfigurerades). Den skriver inte de egenskaper som anger att programmet har tillämpat ett sidhuvud, en sidfot eller en vattenstämpel. När ett program öppnar filen bör programmet utvärdera konfigurationen av innehållsmarkeringen och skriva den till filen när den sparas.
Skydd och policy-SDK på Android
Vilket delat bibliotek ska jag använda för att integrera MIP SDK i mitt Android-program?
MIP SDK Android-binärfilerna inkluderar libmip_core.so, libmip_protection_sdk.so, libmip_upe_sdk.sooch libmip_unified.so.
libmip_unified.so är det bibliotek som rekommenderas och innehåller kärnbiblioteket, skyddsbiblioteket och de delade biblioteken för principer.
Compliance
Är Microsoft Information Protection SDK Federal Information Processing Standard (FIPS) 140-2 kompatibel?
Strypning
Finns det några tjänstbaserade begränsningar för hastighetsbegränsning när man använder MIP SDK:t?
Rights Management-tjänsten, som används av Protection SDK eller av skyddsåtgärder i File SDK, har en gräns på 7 500 begäranden per 10 sekunder för en hel organisation. Om Program A genererar 4 000 begäranden per 10 sekunder och Program B i samma organisation genererar 4 000 begäranden per 10 sekunder kan båda programmen börja ta emot HTTP 429 Too Many Requests svar. Utvecklare måste implementera en backoff-period när de får dessa undantag. Framtida versioner av MIP SDK implementerar den här backoff-perioden internt.