Udostępnij za pośrednictwem

Często zadawane pytania i problemy dotyczące zestawu SDK usługi Microsoft Information Protection (MIP)

Ten artykuł zawiera odpowiedzi na często zadawane pytania oraz wskazówki dotyczące rozwiązywania problemów ze znanymi problemami i typowymi błędami.

Często zadawane pytania

pytanie: ile etykiet jest obsługiwanych przez zestaw MIP SDK?

  • Zestaw MIP SDK może obsługiwać maksymalnie 500 etykiet ochrony i nie ma limitu dla etykiet bez ochrony.

Pytanie: Czy zestaw MIP SDK obsługuje przetwarzanie typów .pfile z etykietami klasyfikacji?

  • Nie, jest to zgodnie z projektem, ponieważ pliki pfile są chronionymi typami plików. Odszyfruj za pomocą programu MPIP File Labeler przed klasyfikacją.

Pytanie: Dlaczego pliki chronione pobrane z usługi Microsoft Teams nie udają się odszyfrować?

  • Jest to znany problem w nieobsługiwanych wersjach zestawu MIP SDK. Uaktualnij zestaw MIP SDK do najnowszej wersji.

pytanie: Jak sprawdzić, które etykiety są stosowane, gdy do pliku zastosowano wiele etykiet z różnych dzierżawców?

  • Wykonaj zapytanie GetLabel w kontekście użytkownika dla każdego najemcy.

Pytanie: Dlaczego moja aplikacja webowa nie może się zainicjować z powodu błędu "InternalError: 'KeyStoreWin32::OpenKey failure: NCryptOpenKey:-2147024894'"?

  • Może wystąpić problem z załadowaniem profilu przez Policy SDK w trakcie inicjacji aplikacji. Ustaw WEBSITE_LOAD_USER_PROFILE=1 w ustawieniu zmiennej środowiskowej aplikacji internetowej i uruchom ponownie aplikację.
    • Nazwa : WEBSITE_LOAD_USER_PROFILE
    • wartość: 1

Pytanie: Dlaczego moja aplikacja kończy się błędem "KeyStoreWin32::OpenKey: NCryptOpenKey:-2146893788" podczas konfiguracji buforowania OnDiskEncrypted?

  • System Windows może tworzyć profile tymczasowe, gdy profil logowania jest niedostępny. Odczyt z rejestru systemu Windows dla buforowania OnDiskEncrypted Link z tym profilem tymczasowym powoduje błąd OpenKey w dzienniku MIP SDK, co jest rejestrowane przez logi zdarzeń systemu operacyjnego Windows z ID zdarzenia 1511 & 1515. Aby rozwiązać ten problem, skontaktuj się z administratorem, aby rozwiązać problem z tworzeniem profilów tymczasowych.

Zmiany magazynu metadanych

Ogłosiliśmy, że wprowadzamy zmianę w lokalizacji przechowywania metadanych etykiet dla plików pakietu Office (Word, Excel, PowerPoint) w celu obsługi nowych funkcji w usłudze Office 365, SharePoint Online i innych usługach.

Metadane — często zadawane pytania

Pytanie: Czy mają wpływ inne formaty, takie jak PDF?

  • Nie, tylko pliki pakietu Office, w szczególności pliki programów Word, Excel i PowerPoint.

Pytanie: Czy jest wymagana określona wersja zestawu MIP SDK?

  • MIP SDK 1.7 i nowsze są w pełni zgodne.

Pytanie: Czy istnieje określona wersja klienta pakietu Office, która jest wymagana do korzystania z tej lokalizacji magazynu?

  • Wszyscy klienci Aplikacje Microsoft 365 wydane po wrześniu 2021 r. obsługują tę nową lokalizację metadanych. Nowa lokalizacja przechowywania nie jest używana, dopóki administrator dzierżawy nie włączy chronionej funkcji współtworzenia.

pl-PL: Pytanie: Czy istniejące metadane przechowywane jako właściwość niestandardowa w custom.xml są utrzymywane na bieżąco?

  • Nr Przy pierwszym zapisaniu dokumentu po włączeniu nowej lokalizacji magazynu metadane etykiet są przenoszone do nowej lokalizacji. Metadane zapisywane za pośrednictwem funkcji LabelingOptions.ExtendedProperties pozostają w custom.xml.

Pytanie: Czy można odczytać metadane etykiety bez zestawu MIP SDK?

  • Tak, ale musisz zaimplementować własny kod, aby przeanalizować plik i wyodrębnić informacje.

Pytanie: Obecnie można łatwo odczytać etykietę, wyodrębniając ciągi par klucz/wartość z pliku. Czy metadane mogą być nadal odczytywane w ten sposób?

Pytanie: Jak mogę określić, czy współtworzenie jest włączone w zasadach etykiet? Stan ustawienia współtworzenia jest zwracany z modułu zasad. Aplikacja może odczytać nieprzetworzone bajty z silnika zasad, aby określić stan współtworzenia.

Pytanie: W jaki sposób etykiety są migrowane do nowej lokalizacji?

  • Poniższa logika służy do określania, która sekcja jest odczytywana i używana do odczytu lub zapisu danych etykiet.
Akcja Funkcja nie jest włączona Włączono funkcję
Przeczytaj Etykieta w custom.xml (niechroniona) lub Doc SummaryInfo (chroniona). Jeśli etykieta istnieje w labelinfo.xml, jest to efektywna etykieta.
Jeśli w labelinfo.xml nie ma etykiety, etykieta w custom.xml lub Doc SummaryInfo jest obowiązującą etykietą.
Napisz Wszystkie nowe etykiety są zapisywane w custom.xml (niechronione) lub Doc SummaryInfo (chronione). Wszystkie nowe etykiety są zapisywane w labelinfo.xml.

Analizowanie plików

Pytanie: Czy mogę zapisać w tym samym pliku, który jest obecnie odczytywany za pomocą File SDK?

Zestaw MIP SDK nie obsługuje równoczesnego odczytywania i zapisywania tego samego pliku. Wszystkie oznaczone pliki powodują kopiowanie pliku wejściowego z zastosowanymi akcjami etykiet. Aplikacja musi zastąpić oryginalny plik z etykietą.

Obsługa ciągów SDK

Pytanie: Jak zestaw SDK obsługuje ciągi i jakiego typu ciąg powinienem używać w kodzie?

Zestaw SDK ma być używany międzyplatformowo i używa formatu UTF-8 (Unicode Transformation Format — 8-bitowy) do obsługi ciągów. Konkretne wskazówki zależą od używanej platformy:

Platforma Wskazówki
Natywna dla systemu Windows W przypadku klientów zestawu SDK języka C++ typ std::string standardowej biblioteki języka C++ jest używany do przekazywania ciągów do/z funkcji interfejsu API. Zestaw MIP SDK wewnętrznie zarządza konwersją do/z utF-8. Gdy element std::string jest zwracany z interfejsu API, należy oczekiwać kodowania UTF-8 i odpowiednio zarządzać w przypadku konwertowania ciągu. W niektórych przypadkach ciąg zwracany jest jako część wektora uint8_t (na przykład licencja publikowania (PL)), ale powinien być traktowany jako nieprzezroczysty blob.

Aby uzyskać więcej informacji i przykładów, zobacz:
  • Funkcja WideCharToMultiByte pomaga w konwersji ciągów znaków szerokich na wielobajtowe, takie jak UTF-8.
  • Następujące przykładowe pliki są zawarte w pobraniu zestawu SDK:
    • Przykładowe funkcje narzędzia ciągów w programie file\samples\common\string_utils.cpp, do konwertowania na/z szerokich ciągów UTF-8.
    • Implementacja wmain(int argc, wchar_t *argv[]) w programie file\samples\file\main.cpp, która używa wcześniejszych funkcji konwersji ciągów.
.NET W przypadku klientów zestawu .NET SDK wszystkie ciągi używają domyślnego kodowania UTF-16 i nie jest wymagana żadna specjalna konwersja. MIP SDK wewnętrznie zarządza konwersją do/z UTF-16.
Inne platformy Wszystkie inne platformy obsługiwane przez zestaw MIP SDK mają natywną obsługę protokołu UTF-8.

Oznaczanie zawartości

Pytanie: Czy zestaw MIP SDK obsługuje oznaczanie zawartości?

MIP SDK nie obsługuje bezpośredniego stosowania oznaczeń zawartości, w tym nagłówka, stopki ani znaku wodnego, na żadnych plikach. Gdy metadane etykiety są zapisywane w pliku, zestaw SDK plików zapisuje właściwość metadanych contentBits , aby wskazać, że ochrona została zastosowana (jeśli została skonfigurowana). Nie zapisuje właściwości wskazujących, że zastosowano nagłówek, stopkę lub znak wodny. Po otwarciu pliku w aplikacji konfiguracja oznaczania zawartości powinna być oceniana przez aplikację i zapisywana w pliku podczas zapisywania.

Zestaw SDK ochrony i zasad w systemie Android

Pytanie: Której biblioteki udostępnionej należy używać do integrowania zestawu MIP SDK z aplikacją systemu Android?

Pliki binarne zestawu Android MIP SDK obejmują libmip_core.so, libmip_protection_sdk.so, libmip_upe_sdk.so i lipmip_unified.so. libmip_unified.so jest zalecaną biblioteką, która zawiera podstawowe, ochrony i udostępnione biblioteki zasad.

Zgodność

Pytanie: Czy zestaw Microsoft Information Protection SDK Federal Information Processing Standard (FIPS) 140-2 jest zgodny?

Zobacz Sprawdzanie poprawności ze standardem FIPS 140-2.

Dokumentacja problemów i błędów

Błąd: "Format pliku nie jest obsługiwany"

Pytanie: Dlaczego podczas próby ochrony lub etykietowania pliku PDF występuje następujący błąd?

Format pliku nie jest obsługiwany

Ten wyjątek wynika z próby ochrony lub etykietowania pliku PDF, który jest podpisany cyfrowo lub chroniony hasłem. Aby uzyskać więcej informacji na temat ochrony i etykietowania plików PDF, zobacz Nowa obsługa szyfrowania plików PDF za pomocą usługi Microsoft Information Protection .

Błąd: "NoPolicyException: zasady etykiet nie zawierały danych"

Pytanie: Dlaczego podczas próby odczytania etykiety lub etykiet listy za pomocą zestawu MIP SDK występuje następujący błąd?

NoPolicyException: polityka etykiet nie zawierała żadnych danych, CorrelationId=GUID, CorrelationId.Description=PolicyProfile, NoPolicyError.Category=SyncFile, NoPolicyError.Category=SyncFile

Ten błąd wskazuje, że zasady etykiet nie są publikowane w portal zgodności Microsoft Purview. Postępuj zgodnie z instrukcjami Tworzenie i konfigurowanie etykiet poufności i ich zasad , aby skonfigurować zasady etykietowania.

Jeśli opublikowano zasady etykietowania, upewnij się, że konto użytkownika znajduje się w dowolnych grupach, które są częścią sekcji opublikowano do w konfiguracji zasad etykiet. Aby uzyskać więcej informacji, zobacz Tworzenie i publikowanie etykiet poufności.

Użytkownicy zewnętrzni, w tym użytkownicy-goście, nie mogą uzyskać dostępu do zasad etykiet innej organizacji. Aby uwzględnić tych użytkowników, zaimplementuj mechanizm ponawiania prób. NoPolicyException Jeśli NoPolicyException zostanie rzucony, ustaw właściwość ProtectionOnlyEngine na wartość true i ponów żądanie. Operacje etykietowania nie będą dostępne dla tego IFileEngine wystąpienia, ale operacje ochrony będą dostępne.

Błąd: "System.ComponentModel.Win32Exception: LoadLibrary failed"

Pytanie: Dlaczego podczas korzystania z opakowania MIP SDK dla platformy .NET występuje następujący błąd?

System.ComponentModel.Win32Exception: Nie udało się załadować biblioteki: [sdk_wrapper_dotnet.dll] podczas wywoływania MIP.Initialize().

Aplikacja nie ma wymaganego środowiska uruchomieniowego lub nie została zbudowana jako wersja Release. Aby uzyskać więcej informacji, zobacz Zapewnianie, że aplikacja ma wymagane środowisko uruchomieniowe .

Błąd: "Wyjątek ProxyAuthError"

Pytanie: Dlaczego podczas korzystania z zestawu MIP SDK występuje następujący błąd?

"ProxyAuthenticatonError: uwierzytelnianie serwera proxy jest nieobsługiwane"

Zestaw MIP SDK nie obsługuje używania uwierzytelnionych serwerów proxy. Aby rozwiązać ten problem, administratorzy serwera proxy powinni ustawić punkty końcowe usługi Microsoft Purview Information Protection w celu obejścia serwera proxy. Lista tych punktów końcowych jest dostępna na stronie Adresy URL i zakresy adresów IP usługi Office 365. Pakiet SDK MIP wymaga, aby *.protection.outlook.com (wiersz 9) oraz końcowe punkty usługi Azure Information Protection (wiersz 73) omijały uwierzytelnianie serwera proxy.

Błąd: "Nieznany błąd" podczas etykietowania pliku obrazu przy użyciu wyjścia strumieniowego

Pytanie: Dlaczego otrzymuję "nieznany błąd" podczas próby dodania lub usunięcia etykiety lub ochrony z typu pliku obrazu przy użyciu strumienia dla danych wyjściowych?

W przypadku korzystania ze strumienia dla danych wyjściowych strumień musi mieć zarówno dostęp do odczytu, jak i zapisu, aby zmodyfikować etykietę lub ochronę pliku obrazu.

Limity ograniczania

Pytanie: Czy istnieją limity ograniczania oparte na usłudze podczas korzystania z zestawu MIP SDK?

Usługa Rights Management, wykorzystywana przez SDK ochrony lub operacje ochrony w plikowym SDK, ma limit 7500 żądań na 10 sekund dla całej organizacji. Oznacza to, że jeśli aplikacja A generuje 4000 żądań na 10 sekund, a aplikacja B w tej samej organizacji generuje 4000 żądań na 10 sekund, obie aplikacje mogą zacząć odbierać HTTP 429 Too Many Requests odpowiedzi. Deweloperzy muszą zaimplementować czas przerwy po odebraniu tych wyjątków. Przyszłe wersje zestawu MIP SDK będą wewnętrznie wdrażać ten okres opóźnienia.