zestaw SDK Microsoft Information Protection (MIP) – często zadawane pytania i problemy

Artykuł
11/28/2021
Czas czytania: 6 min

Platforma	Wskazówki
Windows natywne	W przypadku klientów SDK języka C++ typ Standard Library (Biblioteka standardowa C++) służy do przekazywania `std::string` ciągów do/z funkcji API. Konwersja na/z utf-8 jest zarządzana wewnętrznie przez zestaw SDK MIP. Gdy jest zwracany z interfejsu API, należy oczekiwać odpowiedniego kodowania UTF-8 i zarządzania nimi w przypadku `std::string` konwertowania ciągu. W niektórych przypadkach ciąg jest zwracany jako część wektora (na przykład w ramach licencji publikowania), ale powinien być traktowany jak nieprzezroczysty `uint8_t` obiekt blob. Aby uzyskać więcej informacji i przykładów, zobacz: Funkcja WideCharToMultiByte w celu uzyskania pomocy w konwertowaniu ciągów szerokich znaków na wielobajtowe, na przykład UTF-8. Następujące przykładowe pliki dołączone do zestawu SDK do pobrania: Przykładowe funkcje narzędzi ciągów w `file\samples\common\string_utils.cpp` programie , do konwertowania na ciągi utf-8/z szerokiego. Implementacja `wmain(int argc, wchar_t *argv[])` w `file\samples\file\main.cpp` , która korzysta z powyższych 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 konieczna żadna specjalna konwersja. Konwersja na/z utf-16 jest zarządzana wewnętrznie przez zestaw SDK MIP.
Inne platformy	Wszystkie inne platformy obsługiwane przez zestaw MIP SDK mają natywne wsparcie dla zestawu UTF-8.

Oznaczanie zawartości

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

Zestaw SDK programu MIP nie obsługuje bezpośredniego oznaczania zawartości, w tym nagłówka, stopki lub znaku wodnego, we wszystkich plikach. Podczas zapisywania metadanych etykiet w pliku zestaw SDK pliku zapisze właściwość metadanych contentBits, aby wskazać, że zastosowano ochronę (jeśli skonfigurowano) i nie zapisze właściwości wskazujących, że zastosowano nagłówek, stopkę lub znak wodny. Po otwarciu pliku w aplikacji obsługującej oznaczanie zawartości konfiguracja oznaczania zawartości powinna zostać oszacowana przez aplikację i napisana w pliku podczas zapisywania.

Zgodność

Pytanie:Czy zestaw sdk Microsoft Information Protection FIPS 140-2 jest zgodny?

Zestaw Microsoft Information Protection używa zatwierdzonych szyfrowania FIPS 140-2, ale nie jest obecnie weryfikowanych bibliotek kryptograficznych fiPS 140-2. Aplikacje zużywające zestaw SDK miP muszą pamiętać, że zestaw SDK nie jest obecnie zgodny ze standardem FIPS. Aby uzyskać więcej informacji, zobacz artykuł na temat zgodności FIPS 140-2.

Informacje o problemach i błędach

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

Pytanie:Dlaczego podczas próby ochrony lub na etykietowania pliku PDF jest wyświetlany następujący komunikat o błędzie?

Format pliku nie jest obsługiwany

Ten wyjątek oznacza próbę ochrony lub o etykiecie pliku PDF, który został podpisany cyfrowo lub chroniony hasłem. Aby uzyskać więcej informacji na temat ochrony i oznaczania plików PDF Microsoft Information Protection zobacz Nowa obsługa szyfrowania PLIKÓW PDF przy Microsoft Information Protection.

Błąd: "Nie można analizuje nabytej zasad zgodności"

Pytanie:Dlaczego po pobraniu zestawu SDK programu MIP i próbie użycia przykładu pliku do wyeksptowania wszystkich etykiet jest wyświetlany następujący błąd?

Stało się coś złego: Nie można analizuje nabytej zasad zgodności. Niepowodzenie w przypadku: [class mip::CompliancePolicyParserException] Nie znaleziono tagu: zasady, NodeType: 15, Nazwa: Nie znaleziono nazwy, Wartość: , Nadrzędny: <SyncFile><Content> , korelacjaId:[34668a40-blll-4ef8-b2af-00005aa674z9]

Ten błąd wskazuje, że etykiety nie zostały jeszcze zmigrowane z usługi Azure Information Protection do środowiska ujednoliconego oznaczania etykiet. Aby przeprowadzić migrację etykiet do Centrum zgodności zabezpieczeń usługi Office 365, wykonaj migrację etykiet usługi Azure Information Protection, a następnie utwórz zasady etykiet Office 365 w Centrum zabezpieczeń i zgodności.

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

Pytanie:Dlaczego podczas próby odczytania etykiety lub listy za pomocą zestawu SDK MIP jest wyświetlany następujący błąd?

NoPolicyException: Zasady etykiet nie zawierały danych, CorrelationId=GUID, CorrelationId.Description=PolicyProfile, NoPolicyError.Category=SyncFile, NoPolicyError.Category=SyncFile

Ten błąd wskazuje, że zasady etykiet nie zostały opublikowane w Centrum zabezpieczeń i zgodności firmy Microsoft. Aby skonfigurować zasady etykiet, wykonaj czynności Tworzenie i konfigurowanie etykiet wrażliwości oraz ich zasad.

Błąd: "System.ComponentModel.Win32Exception: LoadLibrary nie powiodło się"

Pytanie:Dlaczego otrzymuję następujący błąd podczas korzystania z pakietu SDK MIP .NET Wrapper?

System.ComponentModel.Win32Exception: Błąd LoadLibrary nie dla: [sdk_wrapper_dotnet.dll] podczas wywoływania usługi MIP. Initialize().

Aplikacja nie ma wymaganego środowiska uruchomieniowego lub nie została sbudowaną jako wersja. Zobacz Upewnij się, że Twoja aplikacja ma wymagane środowisko uruchomieniowe, aby uzyskać więcej informacji.

Błąd: "Wyjątek ProxyAuthError"

Pytanie:Dlaczego otrzymuję następujący błąd podczas korzystania z zestawu SDK miP?

"ProxyAuthenticatonError: Uwierzytelnianie serwera proxy jest nieobsługiwane"

Zestaw SDK miP nie obsługuje korzystania z uwierzytelnionych serwerów proxy. Aby rozwiązać ten komunikat, administratorzy serwera proxy powinni skonfigurować Microsoft Information Protection punktami końcowymi usługi tak, aby pomijały serwer proxy. Lista tych punktów końcowych jest dostępna na stronie Office 365 URL i zakresów adresów IP. Zestaw SDK protokołu MIP wymaga, aby (wiersz 9) i punkty końcowe usługi *.protection.outlook.com Azure Information Protection (wiersz 73) pomijały uwierzytelnianie serwera proxy.

Ten artykuł zawiera odpowiedzi na często zadawane pytania (często zadawane pytania) oraz wskazówki dotyczące rozwiązywania znanych problemów i typowych błędów.

Często zadawane pytania

Zmiany Storage metadanych

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

Często zadawane pytania dotyczące metadanych

Pytanie:Kiedy zostaną udostępnione pierwsze funkcje wymagające nowej lokalizacji przechowywania?

Współtworzenie plików chronionych w Microsoft 365 wymaga nowej lokalizacji przechowywania metadanych. Aby uzyskać więcej szczegółowych informacji, zapoznaj się z wpisem w blogu Poświęconym zabezpieczeniam, zgodnością i tożsamością.

Pytanie:Czy wpływa to na inne formaty, na przykład PDF?

Nie, tylko Office, a w szczególności pliki programu Word, Excel i PowerPoint pliki.

Pytanie:Czy jest wymagana konkretną wersję zestawu SDK miP?

Zestaw MIP SDK 1.7 lub nowszy jest w pełni zgodny.

Pytanie:Czy istnieje konkretną wersja klienta usługi Office, która będzie wymagana, czy może korzystać z tego magazynu?

Zgodnie z ogłoszeniami funkcji Office klienta sieci, aby korzystać z nowej lokalizacji przechowywania. Nowe lokalizacje przechowywania nie będą używane, dopóki funkcje nie zostaną włączone przez administratorów dzierżawy.

Pytanie:Czy istniejące metadane będą przechowywane jako właściwość niestandardowa w programie custom.xml być aktualne?

Nie. Gdy dokument zostanie zapisany po raz pierwszy po włączeniu nowej lokalizacji przechowywania, metadane etykiet zostaną przeniesione do nowej lokalizacji. Metadane zapisane za LabelingOptions.ExtendedProperties pośrednictwem pozostaną w LabelingOptions.ExtendedProperties.

Pytanie:Czy będzie można odczytać metadane etykiet bez zestawu MIP SDK?

Tak, ale konieczne będzie zaimplementowanie własnego kodu w celu analizowania pliku i wyodrębniania informacji.

Pytanie:Obecnie można łatwo "odczytać" etykietę, wyodrębniając ciągi pary klucz/wartość z pliku. Czy odczytywanie będzie nadal możliwe w ten sposób?

Tak, metadane są nadal dostępne w pliku xml Office do odczytania. Należy jednak pamiętać, że aplikacja musi zrozumieć, czy nowy zestaw funkcji jest włączony, aby wiedzieć, która sekcja jest autorytatywna (custom.xml a labelinfo.xml). Przegląd informacji MS-OFFCRYPTO: LabelInfo a niestandardowych właściwości | Microsoft Docs. , aby uzyskać szczegóły implementacji.

Pytanie:Jak sprawdzić, czy nowe funkcje są włączone?

Będziemy udostępniać te informacje w terminie zbliżania się do dat wydania funkcji.

Pytanie:Jak będą migrowane etykiety?

Następująca logika służy do określania sekcji, która jest odczytywana oraz używana do odczytywania lub pisania danych etykiet.

Akcja	Funkcja nie jest włączona	Włączono funkcję
Czytanie	Etykieta w custom.xml (niechroniona) lub Informacje podsumowujące doc (chronione).	Jeśli etykieta istnieje w labelinfo.xml, jest to skuteczna etykieta. Jeśli w skoroszycie nie ma etykiety, labelinfo.xml jako etykieta w custom.xml lub Doc SummaryInfo jest skuteczną etykietą.
Pisanie	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ę pisać w tym samym pliku, który właśnie czytam za pomocą zestawu File SDK?

Zestaw SDK programu MIP nie obsługuje jednoczesnego odczytywania i zapisywania tego samego pliku. Każdy plik oznaczony etykietą spowoduje, że zostanie skopiowany plik wejściowy z zastosowanymi akcjami etykiet. Aplikacja musi zastąpić oryginał plikiem oznaczonym etykietą.

Obsługa ciągów SDK

Pytanie:Jak zestaw SDK obsługuje ciągi i jaki typ ciągu powinien być w kodzie?

Zestaw SDK powinien być używany na wszystkich platformach, a do obsługi ciągów — 8-bitowy format transformacji Unicode UTF-8. Konkretne wskazówki zależą od platformy, z której korzystasz: