Ten artykuł zawiera odpowiedzi na często zadawane pytania dotyczące zestawu SDK Microsoft Information Protection (MIP). Aby uzyskać informacje o znanych problemach i komunikatach o błędach, zobacz Rozwiązywanie problemów z zestawem MIP SDK.
General
Ile etykiet jest obsługiwanych przez zestaw MIP SDK?
MIP SDK obsługuje maksymalnie 500 zaszyfrowanych etykiet poufności. Etykiety, które nie używają szyfrowania, nie podlegają temu limitowi. Dzierżawcy z dużą liczbą etykiet poufności mogą odczuwać pewien wpływ na wydajność. Aby uzyskać więcej informacji, zobacz Ograniczenia etykiet poufności.
Czy pakiet MIP SDK obsługuje ponowne przypisywanie etykiet klasyfikacyjnych do plików typu .pfile?
Nie, jest to zgodnie z projektem, ponieważ pliki pfile są chronionymi typami plików. Odszyfruj za pomocą narzędzia Microsoft Purview Information Protection File Labeler przed klasyfikacją.
Dlaczego pliki chronione pobierane z Microsoft Teams nie są odszyfrowywane?
Jest to znany problem w nieobsługiwanych wersjach zestawu MIP SDK. Uaktualnij zestaw MIP SDK do najnowszej wersji.
Jak sprawdzić, jakie etykiety są stosowane, gdy do pliku zastosowano wiele etykiet z różnych dzierżaw?
Wywołaj metodę GetLabel w kontekście użytkownika dla każdego dzierżawcy.
Zmiany magazynu metadanych
Czy mają wpływ inne formaty, takie jak PDF?
Microsoft ogłosiła zmianę lokalizacji przechowywania metadanych etykiet dla plików pakietu Office (Word, Excel i PowerPoint) w celu obsługi nowych funkcji w usłudze Office 365, SharePoint Online i innych usługach. Nie ma to wpływu na inne formaty plików, tylko pliki pakietu Office, w szczególności Word, Excel i pliki PowerPoint.
Czy jest wymagana określona wersja zestawu MIP SDK?
MIP SDK 1.7 i nowsze są w pełni zgodne.
Czy istnieje określona wersja klienta pakietu Office, która jest wymagana do korzystania z tej lokalizacji przechowywania?
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 funkcji chronionego współtworzenia.
Czy istniejące metadane przechowywane w pliku *custom.xml* w postaci właściwości niestandardowej są aktualizowane?
No. Przy pierwszym zapisaniu dokumentu po włączeniu nowej lokalizacji przechowywania metadane etykiet są przenosine do nowej lokalizacji. Metadane zapisywane przy użyciu funkcji LabelingOptions.ExtendedProperties pozostają w custom.xml.
Czy można odczytać metadane etykiety bez MIP SDK?
Tak, ale musisz zaimplementować własny kod, aby przeanalizować plik i wyodrębnić informacje.
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?
Tak, metadane są nadal dostępne w pliku XML pakietu Office do odczytu. Aplikacja musi odczytać ustawienie współtworzenia z pliku zasad, aby wiedzieć, że nowy zestaw funkcji jest włączony. To ustawienie definiuje, gdzie odczytywać/zapisywać dane etykiety (custom.xml a labelinfo.xml). Aby uzyskać szczegółowe informacje o implementacji, zapoznaj się z tematem MS-OFFCRYPTO: LabelInfo i Właściwości niestandardowego dokumentu .
Jak ustalić, czy współtworzenie jest włączone w zasadach etykiet?
Silnik zasad zwraca stan ustawienia współtworzenia na podstawie wartości klucza enableLabelCoauth. Aplikacja może odczytać nieprzetworzone bajty z silnika zasad, aby określić stan współtworzenia.
W jaki sposób etykiety są migrowane do nowej lokalizacji?
Pakiet SDK MIP używa następującej logiki do określenia, której sekcji używa do odczytu lub zapisu danych etykiet.
| Action | Funkcja nie jest włączona | Włączono funkcję |
|---|---|---|
| Odczytaj | Etykieta w custom.xml (niechroniona) lub Doc SummaryInfo (chroniona). | Jeśli etykieta istnieje w labelinfo.xml, jest to efektywna etykieta. Jeśli w labelinfo.xmlnie ma etykiety , etykieta w custom.xml lub Doc SummaryInfo jest obowiązującą etykietą. |
| Write | Zestaw SDK MIP zapisuje wszystkie nowe etykiety do custom.xml (bez ochrony) lub DocSummaryInfo (chronione). | SDK MIP zapisuje wszystkie nowe etykiety do pliku labelinfo.xml. |
Analizowanie plików
Czy mogę zapisywać do tego samego pliku, który aktualnie odczytuję, 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
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++ użyj standardowego typu std::string biblioteki języka C++ do przekazywania ciągów do/z funkcji interfejsu API. Zestaw MIP SDK wewnętrznie zarządza konwersją do/z utF-8. Gdy interfejs API zwraca wartość std::string, trzeba zakładać kodowanie UTF-8 i odpowiednio to uwzględnić podczas konwersji ciągu znaków. W niektórych przypadkach interfejs API zwraca ciąg znaków jako część wektora uint8_t (na przykład licencję wydawniczą (PL)), ale należy go traktować jako nieprzezroczysty obiekt blob.Aby uzyskać więcej informacji i przykładów, zobacz:
|
| .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
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 File SDK zapisuje metadane etykiety do pliku, zapisuje właściwość metadanych contentBits, aby wskazać, że File SDK zastosował ochronę (jeśli została skonfigurowana). Nie zapisuje właściwości informujących o tym, że aplikacja zastosowała nagłówek, stopkę lub znak wodny. Po otwarciu pliku aplikacja powinna ocenić konfigurację oznaczania zawartości i zapisać ją w pliku podczas zapisywania.
Zestaw SDK ochrony i zasad w systemie Android
Której biblioteki udostępnionej należy użyć do zintegrowania zestawu MIP SDK z aplikacją systemu Android?
Pliki binarne pakietu MIP SDK dla systemu Android obejmują libmip_core.so, libmip_protection_sdk.so, libmip_upe_sdk.so i libmip_unified.so.
libmip_unified.so jest zalecaną biblioteką i zawiera biblioteki współdzielone: podstawową, ochrony i zasad.
Zgodność
Czy zestaw MICROSOFT INFORMATION PROTECTION SDK Federal Information Processing Standard (FIPS) 140-2 jest zgodny?
Zobacz Sprawdzanie poprawności ze standardem FIPS 140-2.
Ograniczanie przepustowości
Czy podczas korzystania z pakietu MIP SDK obowiązują limity ograniczania zależne od usługi?
Usługa zarządzania prawami, używana przez zestaw SDK Protection lub przez operacje związane z ochroną w zestawie SDK File, ma limit 7 500 żądań na 10 sekund w całej organizacji. 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ą wdrożyć okres wstrzymania po otrzymaniu tych wyjątków. Przyszłe wersje zestawu SDK MIP obsługują ten okres wstrzymania wewnętrznie.