Vanliga frågor och svar om SDK för Microsoft Information Protection (MIP) och problem

Den här artikeln innehåller svar på vanliga frågor och svar och felsökningsvägledning för kända problem och vanliga fel.

Vanliga frågor och svar

Fråga: Hur många etiketter stöds av MIP SDK?

• MIP SDK kan hantera upp till 500 skyddsetiketter och det finns ingen gräns för etiketter utan skydd.

Fråga: 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 MPIP-filetiketten före klassificeringen.

Fråga: Varför går skyddade filer som laddats ner från Microsoft Teams inte att dekryptera?

• 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.

Fråga: Hur kontrollerar jag vilka etiketter som används när flera etiketter från olika hyresgäster tillämpas på en fil?

• Fråga efter GetLabel i användarens kontext för varje hyresgäst.

Fråga: Varför misslyckas mitt webbprogram med att initiera med "InternalError: 'KeyStoreWin32::OpenKey failure: NCryptOpenKey:-2147024894'"?

• Policy-SDK:n kan misslyckas med att läsa in en profil under apparens start. Ange WEBSITE_LOAD_USER_PROFILE=1 i miljövariabelinställningen för webbappen och starta om programmet.
  • Namn : WEBBPLATS_LADDA_ANVÄNDARPROFIL
  • Värde: 1

Fråga: Varför misslyckas mitt program med "KeyStoreWin32::OpenKey failure: NCryptOpenKey:-2146893788" när OnDiskEncrypted cachelagring har konfigurerats?

• Windows kan skapa tillfälliga profiler när inloggningsprofilen inte är tillgänglig. Läsning från Windows-registret för OnDiskEncrypted cachelagring Link med den här tillfälliga profilen orsakar OpenKey-fel i MIP SDK-loggen och registreras av Händelseloggen för Windows-operativsystemet med händelse-ID 1511 & 1515. Lös problemet genom att kontakta administratören för att åtgärda problemet med att skapa tillfälliga profiler.

Ändringar i metadatalagring

Vi meddelade att vi gör en ändring av lagringsplatsen för etikettmetadata för Office-filer (Word, Excel, PowerPoint) för att stödja nya funktioner i Office 365, SharePoint Online och andra tjänster.

Vanliga frågor och svar om metadata

Fråga: Påverkas andra format, till exempel PDF?

• Nej, endast Office-filer, särskilt Word-, Excel- och PowerPoint-filer.

Fråga: Finns det en specifik version av MIP SDK som krävs?

• MIP SDK 1.7 och senare är helt kompatibla.

Fråga: 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örerna aktiverar funktionen för skyddad medautentisering.

Fråga: Lagras befintliga metadata som en anpassad egenskap i custom.xml hållas uppdaterade?

• Nej. Första gången dokumentet sparas efter att den nya lagringsplatsen har aktiverats flyttas etikettmetadata till den nya platsen. Metadata som skrivs via LabelingOptions.ExtendedProperties finns kvar i custom.xml.

Fråga: 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.

Fråga: 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 med labelinfo.xml). Granska MS-OFFCRYPTO: LabelInfo jämfört med anpassade dokumentegenskaper | Microsoft Docs. för implementeringsinformation.

Fråga: Hur gör jag för att avgöra om medförfattare är aktiverat i etikettprincipen? Medförfattarens tillstånd returneras från principmotorn. Ett program kan läsa rå byte från principmotorn för att fastställa medförfattarens status.

Fråga: Hur migreras etiketter till den nya platsen?

• Följande logik används för att avgöra vilket avsnitt som läss och används för att läsa eller skriva etikettdata.

Åtgärd	Funktionen är inte aktiverad	Funktionen är aktiverad
Lästa	Etikett i custom.xml (oskyddad) eller Doc SummaryInfo (skyddad).	Om etiketten finns 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.
Skriva	Alla nya etiketter skrivs till custom.xml (oskyddade) eller Doc SummaryInfo (skyddade).	Alla nya etiketter skrivs till labelinfo.xml.

Filparsning

Fråga: Kan jag skriva till samma fil som jag läser med File SDK?

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

Fråga: 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:

Plattform	Vägledning
Windows-inbyggd funktion	För C++ SDK-klienter används typen std::string i C++ Standardbiblioteket för att skicka strängar till/från API-funktioner. MIP SDK hanterar internt konvertering till/från UTF-8. När en std::string returneras från ett API måste du förvänta dig UTF-8-kodning och hantera i enlighet med detta om du konverterar strängen. I vissa fall returneras en sträng som en del av en uint8_t vektor (till exempel en publiceringslicens (PL)), men bör behandlas som en ogenomskinlig blob. Mer information och exempel finns i: WideCharToMultiByte-funktionen för hjälp med att konvertera breda teckensträngar till flera byte, till exempel UTF-8. Följande exempelfiler som ingår i SDK-nedladdningen: Exempel på strängverktygsfunktioner i file\samples\common\string_utils.cpp, för konvertering till/från breda UTF-8-strängar. En implementering av wmain(int argc, wchar_t *argv[]) i file\samples\file\main.cpp, som använder de föregående strängkonverteringsfunktionerna.
.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

Fråga: 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 etikettmetadata skrivs till en fil skriver File SDK egenskapen contentBits metadata för att indikera att skyddet tillämpades (om det konfigurerades). Den skriver inte de egenskaper som anger att sidhuvud, sidfot eller vattenstämpel har tillämpats. När filen öppnas i ett program bör konfigurationen för innehållsmarkering utvärderas av programmet och skrivas till filen när den sparas.

Skydd och policy-SDK på Android

Fråga: 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.solibmip_upe_sdk.so och libmip_unified.so. libmip_unified.so är det rekommenderade biblioteket som innehåller de delade biblioteken core, protection och policy.

Regelefterlevnad

Fråga: Är Microsoft Information Protection SDK Federal Information Processing Standard (FIPS) 140-2 kompatibel?

Se FIPS 140-2-validering.

Referens för problem och fel

Fel: "Filformatet stöds inte"

Fråga: Varför får jag följande fel när jag försöker skydda eller märka en PDF-fil?

Filformat stöds inte

Det här undantaget beror på försök att skydda eller märka en PDF-fil som är digitalt signerad eller lösenordsskyddad. Mer information om hur du skyddar och etiketterar PDF-filer finns i Nytt stöd för PDF-kryptering med Microsoft Information Protection .

Fel: "NoPolicyException: Label policy innehöll inte data"

Fråga: Varför får jag följande fel när jag försöker läsa en etikett eller listetiketter via MIP SDK?

NoPolicyException: Etikettpolicy innehöll inte data, CorrelationId=GUID, CorrelationId.Description=PolicyProfile, NoPolicyError.Category=SyncFile, NoPolicyError.Category=SyncFile

Det här felet anger att en etikettprincip inte publiceras i Microsoft Purview-portalen. Följ Skapa och konfigurera etiketter för känslighet och deras policyer för att konfigurera etikettpolicyn.

Om en etikettprincip har publicerats kontrollerar du att användarkontot ingår i alla grupper som ingår i det publicerade avsnittet i etikettprincipkonfigurationen. Mer information finns i Skapa och publicera känslighetsetiketter.

Externa användare, inklusive gästanvändare, kan inte komma åt en annan organisations etikettprinciper. För att hantera dessa användare implementerar du en mekanism för återförsök. Om en NoPolicyException genereras anger du FileEngineSettings egenskapen ProtectionOnlyEngine till true och försöker igen. Etiketteringsåtgärder kommer inte att vara tillgängliga för den IFileEngine instansen, men skyddsåtgärder kommer att vara tillgängliga.

Fel: "System.ComponentModel.Win32Exception: LoadLibrary misslyckades"

Fråga: Varför får jag följande fel när jag använder MIP SDK .NET Wrapper?

System.ComponentModel.Win32Exception: LoadLibrary misslyckades för: [sdk_wrapper_dotnet.dll] när MIP.Initialize() anropas.

Applikationen har inte den nödvändiga körmiljön eller har inte byggts som Release. Mer information finns i Kontrollera att appen har de beroenden som krävs .

Fel: "ProxyAuthError-undantag"

Fråga: Varför får jag följande fel när jag använder MIP SDK?

"ProxyAuthenticatonError: Proxyautentisering stöds inte"

MIP SDK stöder inte användning av autentiserade proxyservrar. För att åtgärda det här meddelandet bör proxyadministratörer ange tjänstslutpunkterna för Microsoft Purview Information Protection för att kringgå proxyn. En lista över dessa slutpunkter finns på sidan För Office 365-URL:er och IP-adressintervall . MIP SDK kräver att *.protection.outlook.com (rad 9) och Microsoft Purview Information Protection-tjänstens slutpunkter (rad 73) kringgår proxyautentisering.

Fel: "Okänt fel" när du märker en bildfil med hjälp av strömmande utdata

Fråga: Varför får jag ett "okänt fel" när jag försöker lägga till eller ta bort en etikett eller ett skydd från en bildfiltyp med hjälp av en ström för utdata?

När du använder en ström för utdata måste strömmen ha både läs- och skrivåtkomst för att ändra etiketten eller skyddet för en bildfil.

Begränsningsgränser

Fråga: Finns det några tjänstbaserade begränsningar av hastighet när du använder MIP SDK?

Rights Management-tjänsten, som används av skydds-SDK eller 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 dessa undantag tas emot. Framtida versioner av MIP SDK implementerar internt den här backoff-perioden.