Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
В этой статье приведены ответы на часто задаваемые вопросы (часто задаваемые вопросы) и рекомендации по устранению известных проблем и распространенных ошибок.
Часто задаваемые вопросы
Вопрос: Сколько меток поддерживает SDK MIP?
- Пакет SDK MIP может обрабатывать до 500 меток защиты, и нет ограничений для меток без защиты.
Вопрос: Поддерживает ли SDK MIP переклассификацию типов .pfile с метками классификации?
- Нет, это сделано специально, потому что pfiles — это защищенные типы файлов. Расшифровка с помощью метки файлов MPIP перед классификацией.
Вопрос: Почему защищенные файлы, загруженные из Microsoft Teams, не расшифровываются?
- Это известная проблема в неподдерживаемых версиях пакета SDK MIP. Обновление до последней версии пакета SDK для MIP.
Вопрос: Как проверить, какие метки применяются, если к файлу применяются несколько меток от разных арендаторов?
- Запросите GetLabel в контексте пользователя для каждого клиента.
Вопрос: Почему мое веб-приложение не удается инициализировать и возникает ошибка "InternalError: 'KeyStoreWin32::OpenKey failure: NCryptOpenKey:-2147024894'"?
- Пакет SDK политики может не загрузить профиля во время инициализации приложения. Задайте WEBSITE_LOAD_USER_PROFILE=1 в параметре переменной среды веб-приложения и перезапустите приложение.
- Имя : WEBSITE_LOAD_USER_PROFILE
- значение : 1
Вопрос: Почему мое приложение завершается с ошибкой "KeyStoreWin32::OpenKey failure: NCryptOpenKey:-2146893788" при настройке кэширования OnDiskEncrypted?
- Windows может создавать временные профили, если профиль входа недоступен. Чтение из реестра Windows для кэширования OnDiskEncrypted Link с этим временным профилем вызывает сбой OpenKey в журнале MIP SDK и фиксируется журналами событий операционной системы Windows с идентификатором события 1511 & 1515. Чтобы устранить эту проблему, обратитесь к администратору, чтобы устранить проблему, создав временные профили.
Изменения хранилища метаданных
Мы объявили , что мы изменим расположение хранилища метаданных меток для файлов Office (Word, Excel, PowerPoint) для поддержки новых функций в Office 365, SharePoint Online и других службах.
Часто задаваемые вопросы о метаданных
Вопрос. Влияют ли другие форматы, например PDF?
- Нет, только файлы Office, в частности Word, Excel и PowerPoint.
Вопрос. Существует ли определенная версия пакета SDK MIP, которая требуется?
- Пакет SDK MIP версии 1.7 и более поздние версии полностью совместимы.
Вопрос. Существует ли определенная версия клиента Office, необходимая для использования этого расположения хранилища?
- Все клиенты приложений Microsoft 365, выпущенные после сентября 2021 г., поддерживают это новое расположение метаданных. Новое расположение хранилища не используется, пока администраторы клиента не будут включать защищенный компонент совместного редактирования.
Вопрос: Обновляются ли существующие метаданные, хранящиеся в качестве настраиваемого свойства в custom.xml?
- Нет. При первом сохранении документа после включения нового расположения хранилища метаданные меток перемещаются в новое расположение. Метаданные, записанные через
LabelingOptions.ExtendedProperties, остаются в custom.xml.
Вопрос. Можно ли считывать метаданные метки без пакета SDK MIP?
- Да, но необходимо реализовать собственный код для анализа файла и извлечения информации.
Вопрос. В настоящее время легко читать метку, извлекая строки пар "ключ-значение" из файла. Можно ли считывать метаданные таким образом?
- Да, метаданные по-прежнему доступны в XML-файле Office для чтения. Приложение должно прочитать параметр совместного редактирования из файла политики, чтобы узнать, включен ли новый набор компонентов. Этот параметр определяет, где считывать и записывать данные метки (custom.xml и labelinfo.xml). Просмотрите MS-OFFCRYPTO: LabelInfo в сравнении с настраиваемыми свойствами документа | см. документацию Майкрософт. для получения сведений о реализации.
Вопрос. Как определить, включена ли совместная проверка подлинности в политике меток? Состояние параметра совместного редактирования возвращается из подсистемы политики. Приложение может считывать необработанные байты из обработчика политик, чтобы определить состояние совместного редактирования.
Вопрос. Как метки переносятся в новое расположение?
- Следующая логика используется для определения того, какой раздел считывается и используется для чтения или записи данных меток.
| Действие | Функция не включена | Функция включена |
|---|---|---|
| Читайте | Метка в custom.xml (незащищена) или Doc SummaryInfo (защищена). | Если метка существует в labelinfo.xml, это эффективная метка. Если метка отсутствует в labelinfo.xml, метка в custom.xml или Doc SummaryInfo является эффективной меткой. |
| Напишите | Все новые метки записываются в custom.xml (незащищено) или Doc SummaryInfo (защищено). | Все новые метки записываются в labelinfo.xml. |
Анализ файлов
Вопрос. Можно ли записать в тот же файл, который я сейчас считываю с помощью пакета SDK для файлов?
Пакет SDK MIP не поддерживает параллельное чтение и запись одного файла. Все помеченные файлы приводят к копированию входного файла с примененными действиями метки. Ваше приложение должно заменить оригинал на файл с меткой.
Обработка строк в SDK
Вопрос. Как пакет SDK обрабатывает строки и какой тип строки следует использовать в коде?
Пакет SDK предназначен для использования кроссплатформенной платформы и использует UTF-8 (формат преобразования Юникода — 8-разрядный) для обработки строк. Конкретные рекомендации зависят от используемой платформы:
| Платформа | Руководство |
|---|---|
| Приложение, встроенное в Windows | Для клиентов C++ SDK тип std::string из стандартной библиотеки C++ используется для передачи строк в функции API и обратно. Пакет SDK MIP внутренне обрабатывает преобразование в формат UTF-8 и из него.
std::string При возврате из API необходимо ожидать кодировку UTF-8 и управлять строкой соответствующим образом при её преобразовании. В некоторых случаях строка возвращается как часть вектора uint8_t (например, лицензия на публикацию (PL)), но должна рассматриваться как непрозрачный большой двоичный объект.Дополнительные сведения и примеры см. в следующих примерах:
|
| .NET | Для клиентов пакета SDK для .NET все строки используют кодировку UTF-16 по умолчанию и не требуется специальное преобразование. Пакет SDK MIP управляет внутренним преобразованием в и из UTF-16. |
| Другие платформы | Все остальные платформы, поддерживаемые пакетом SDK MIP, имеют встроенную поддержку UTF-8. |
Маркировка содержимого
Вопрос. Поддерживает ли пакет SDK MIP маркировку содержимого?
Пакет SDK MIP не поддерживает прямое применение пометки содержимого, включая верхний колонтитул, нижний колонтитул или водяной знак, к любым файлам. Когда метаданные метки записываются в файл, пакет SDK для файлов записывает свойство метаданных contentBits , чтобы указать, что защита была применена (если настроена). Он не записывает свойства, указывающие на применение верхних, нижних колонтитулов или подложки. При открытии файла в приложении конфигурация маркировки содержимого должна оцениваться приложением и записываться в файл при сохранении.
Пакет SDK для защиты и политики в Android
Вопрос. Какую общую библиотеку следует использовать для интеграции пакета SDK MIP в мое приложение Android?
Двоичные файлы MIP SDK для Android включают libmip_core.so, libmip_protection_sdk.so, libmip_upe_sdk.so и libmip_unified.so.
libmip_unified.so является рекомендуемой библиотекой, содержащей библиотеки ядра, защиты и политик.
Соответствие
Вопрос. Соответствует ли пакет SDK Microsoft Information Protection Federal Information Processing Standard (FIPS) 140-2?
См. проверку FIPS 140-2.
Справочник по проблемам и ошибкам
Ошибка: "Формат файла не поддерживается"
Вопрос. Почему при попытке защитить или пометить PDF-файл возникает следующая ошибка?
Формат файла не поддерживается
Это исключение приводит к попытке защитить или пометить PDF-файл, защищенный цифровой подписью или паролем. Дополнительные сведения о защите и маркировке PDF-файлов см. в статье "Новая поддержка шифрования PDF- файлов с помощью Microsoft Information Protection ".
Ошибка: "NoPolicyException: политика меток не содержала данных"
Вопрос. Почему при попытке считывания меток или меток списка с помощью пакета SDK MIP возникает следующая ошибка?
NoPolicyException: политика меток не содержала данных, CorrelationId=GUID, CorrelationId.Description=PolicyProfile, NoPolicyError.Category=SyncFile, NoPolicyError.Category=SyncFile
Эта ошибка означает, что политика меток не опубликована на портале Microsoft Purview. Следуйте инструкциям по созданию и настройке меток конфиденциальности и их политик , чтобы настроить политику маркировки.
Если политика меток была опубликована, убедитесь, что учетная запись пользователя включена в любые группы, которые являются частью раздела назначенные для в конфигурации политики меток. Дополнительные сведения см. в статье "Создание и публикация меток конфиденциальности".
Внешние пользователи, включая гостевых пользователей, не могут получить доступ к политикам меток другой организации. Для обеспечения потребностей этих пользователей реализуйте механизм повторного выполнения.
NoPolicyException Если создается исключение, задайте FileEngineSettings для свойства ProtectionOnlyEngine значение true и повторите запрос. Операции маркировки не будут доступны для этого IFileEngine экземпляра, но будут доступны операции защиты.
Ошибка: "System.ComponentModel.Win32Exception: не удалось загрузить библиотеку LoadLibrary"
Вопрос. Почему при использовании оболочки пакета SDK для .NET для MIP возникает следующая ошибка?
System.ComponentModel.Win32Exception: Не удалось загрузить библиотеку с помощью: [sdk_wrapper_dotnet.dll] при вызове MIP.Initialize().
Ваше приложение не имеет необходимой среды выполнения или не было собрано как финальная версия. Дополнительные сведения см. в разделе "Убедитесь, что приложение имеет необходимые зависимости ".
Ошибка: "Исключение ProxyAuthError"
Вопрос. Почему при использовании пакета SDK MIP возникает следующая ошибка?
"ProxyAuthenticatonError: проверка подлинности прокси-сервера не поддерживается"
Пакет SDK MIP не поддерживает использование прошедших проверку подлинности прокси-серверов. Чтобы устранить это сообщение, администраторы прокси-сервера должны задать конечные точки службы Microsoft Purview Information Protection для обхода прокси-сервера. Список этих конечных точек доступен на странице URL-адресов и диапазонов IP-адресов Office 365 . Пакет SDK MIP требует, чтобы *.protection.outlook.com (строка 9) и конечные точки службы Microsoft Purview Information Protection (строка 73) обходить проверку подлинности прокси-сервера.
Ошибка: "Неизвестная ошибка" при маркировке файла изображения с использованием вывода потока
Вопрос: Почему я получаю "неизвестную ошибку" при попытке добавить или удалить метку или защиту с файлов изображений, использующих поток для вывода?
При использовании потока для выходных данных поток должен иметь доступ на чтение и запись, чтобы изменить метку или защиту файла изображения.
Ограничения регулирования
Вопрос: Существуют ли ограничения регулирования на основе служб при использовании пакета SDK MIP?
Служба Rights Management, используемая пакетом SDK для защиты или операциями защиты в пакете SDK для файлов, имеет ограничение в 7500 запросов в 10 секунд для всей организации. То есть, если приложение A создает 4000 запросов в 10 секунд, а приложение B в той же организации создает 4000 запросов в 10 секунд, оба приложения могут начать получать HTTP 429 Too Many Requests ответы. Разработчики должны реализовать временной интервал ожидания при получении этих исключений. Будущие версии пакета SDK MIP будут внутренне реализовывать этот период отката.