Microsoft Information Protection y problemas del SDK de Microsoft Information Protection (MIP)

Plataforma Instrucciones
Windows nativa Para los clientes del SDK de C++, el tipo de biblioteca estándar de C++ se usa para pasar cadenas a o desde funciones std::string de API. El SDK de MIP administra internamente la conversión a UTF-8. Cuando se devuelve una api, debe esperar la codificación UTF-8 y administrarla en consecuencia si std::string convierte la cadena. En algunos casos, una cadena se devuelve como parte de un vector (como una licencia de publicación (PL)), pero debe tratarse como uint8_t un blob opaco.

Para obtener más información y ejemplos, vea:
  • Función WideCharToMultiByte para obtener ayuda con la conversión de cadenas de caracteres anchos a varios bytes, como UTF-8.
  • Los siguientes archivos de ejemplo incluidos en la descarga del SDK:
    • Funciones de utilidad de cadena de file\samples\common\string_utils.cpp ejemplo en , para convertir cadenas UTF-8 de ancho a/desde.
    • Una implementación de en , que usa las funciones de conversión wmain(int argc, wchar_t *argv[])file\samples\file\main.cpp de cadena anteriores.
.NET Para los clientes del SDK de .NET, todas las cadenas usan la codificación UTF-16 predeterminada y no se necesita ninguna conversión especial. El SDK de MIP administra internamente la conversión a UTF-16.
Otras plataformas Todas las demás plataformas compatibles con el SDK de MIP tienen compatibilidad nativa con UTF-8.

Marcado de contenido

Pregunta:¿El SDK de MIP admite el marcado de contenido?

EL SDK de MIP no admite la aplicación directa del marcado de contenido, incluido el encabezado, pie de página o marca de agua, en ningún archivo. Al escribir los metadatos de etiqueta en un archivo, el SDK de archivo escribirá la propiedad de metadatos contentBits para indicar que se aplicó la protección (si está configurada) y no escribirá las propiedades que indican que se aplicaron encabezado, pie de página o marca de agua. Cuando el archivo se abre en una aplicación compatible con el marcado de contenido, la configuración de marcado de contenido debe ser evaluada por la aplicación y escrita en el archivo al guardar.

Cumplimiento normativo

Pregunta:¿Es compatible Microsoft Information Protection SDK FIPS 140-2?

El SDK Microsoft Information Protection usa cifrados aprobados por FIPS 140-2, pero no bibliotecas criptográficas validadas por FIPS 140-2 hoy en día. Las aplicaciones que consumen el SDK de MIP deben ser conscientes de que el SDK no se considera compatible con FIPS en este momento. Para obtener más información, vea el artículo sobre el cumplimiento de FIPS 140-2.

Referencia de problemas y errores

Error: "No se admite el formato de archivo"

Pregunta:¿Por qué aparece el siguiente error al intentar proteger o etiquetar un archivo PDF?

No se admite el formato de archivo

Esta excepción se produce al intentar proteger o etiquetar un archivo PDF firmado digitalmente o protegido con contraseña. Consulte Nuevo soporte para cifrado PDF con Microsoft Information Protection para obtener más información sobre cómo proteger y etiquetar archivos PDF.

Error: "Error al analizar la directiva de cumplimiento adquirida"

Pregunta:¿Por qué aparece el siguiente error después de descargar el SDK de MIP e intentar usar el ejemplo de archivo para enumerar todas las etiquetas?

Se ha producido un problema: no se ha podido analizar la directiva de cumplimiento adquirida. Error con: [class mip::CompliancePolicyParserException] Tag not found: policy, NodeType: 15, Name: No Name Found, Value: , <SyncFile><Content> Ancestors: , correlationId:[34668a40-blll-4ef8-b2af-00005aa674z9]

Este error indica que no ha migrado las etiquetas de Azure Information Protection a la experiencia de etiquetado unificada. Siga Cómo migrar etiquetas de Azure Information Protection al Centro de cumplimiento de seguridad de Office 365 para migrar las etiquetas y, a continuación, cree una directiva de etiquetas en Office 365 Centro de seguridad y cumplimiento.

Error: "NoPolicyException: la directiva de etiquetas no contenía datos"

Pregunta:¿Por qué aparece el siguiente error al intentar leer etiquetas o etiquetas de lista a través del SDK de MIP?

NoPolicyException: la directiva de etiquetas no contenía datos, CorrelationId=GUID, CorrelationId.Description=PolicyProfile, NoPolicyError.Category=SyncFile, NoPolicyError.Category=SyncFile

Este error indica que no se ha publicado una directiva de etiquetas en el Centro de seguridad y cumplimiento de Microsoft. Siga Crear y configurar etiquetas de confidencialidad y sus directivas para configurar la directiva de etiquetado.

Error: "System.ComponentModel.Win32Exception: LoadLibrary failed"

Pregunta:¿Por qué aparece el siguiente error al usar el contenedor .NET del SDK de MIP?

System.ComponentModel.Win32Exception: LoadLibrary falló para: [sdk_wrapper_dotnet.dll] al llamar a MIP. Initialize().

La aplicación no tiene el tiempo de ejecución necesario o no se ha creado como Versión. Vea Asegurarse de que la aplicación tiene el tiempo de ejecución necesario para obtener más información.

Error: "Excepción ProxyAuthError"

Pregunta:¿Por qué aparece el siguiente error al usar el SDK de MIP?

"ProxyAuthenticatonError: La autenticación de proxy no es compatible"

El SDK de MIP no admite el uso de servidores proxy autenticados. Para corregir este mensaje, los administradores proxy deben establecer los puntos de conexión Microsoft Information Protection de servicio para omitir el proxy. Una lista de esos puntos de conexión está disponible en la Office 365 url e intervalos de direcciones IP. El SDK de MIP requiere que (fila 9) y los puntos de conexión de servicio de *.protection.outlook.com Azure Information Protection (fila 73) omitan la autenticación de proxy.

En este artículo se proporcionan respuestas a preguntas más frecuentes (preguntas frecuentes) y instrucciones para la solución de problemas conocidos y errores comunes.

Preguntas más frecuentes

Metadatos Storage cambios

Anunciamos que estamos realizando un cambio en la ubicación de almacenamiento de metadatos de etiqueta para archivos de Office (Word, Excel, PowerPoint) para admitir nuevas características en Office 365, SharePoint Online y otros servicios.

Preguntas más frecuentes sobre metadatos

Pregunta:¿Cuándo estarán disponibles las primeras características que requieren esta nueva ubicación de almacenamiento?

Pregunta:¿Se afectan otros formatos, como PDF?

  • No, solo Office archivos, específicamente Word, Excel y PowerPoint archivos.

Pregunta:¿Hay una versión específica del SDK de MIP que sea necesaria?

  • EL SDK de MIP 1.7 y versiones posteriores son totalmente compatibles.

Pregunta:¿Hay una versión específica del Office cliente que será necesario o usará esta tienda?

  • A medida que se anuncian las características, Office cliente se actualizará para aprovechar la nueva ubicación de almacenamiento. Las nuevas ubicaciones de almacenamiento no se usarán hasta que los administradores de inquilinos habiliten las características.

Pregunta:¿Los metadatos existentes almacenados como una propiedad personalizada encustom.xml se mantendrán actualizados?

Pregunta:¿Será posible leer los metadatos de etiqueta sin EL SDK de MIP?

  • Sí, pero tendrá que implementar su propio código para analizar el archivo y extraer la información.

Pregunta:Actualmente, es fácil "leer" la etiqueta extrayendo las cadenas de pares clave/valor del archivo. ¿La lectura seguirá siendo posible de esta manera?

  • Sí, los metadatos siguen estando disponibles en Office archivo XML que se va a leer. Sin embargo, debe tenerse en cuenta que la aplicación tendrá que comprender si el nuevo conjunto de características está habilitado para saber qué sección es autoritativa (custom.xml frente a labelinfo.xml). Revisar MS-OFFCRYPTO: LabelInfo versus Propiedades de documento personalizado | Microsoft Docs. para obtener detalles de implementación.

Pregunta:¿Cómo puedo descubrir si las nuevas características están habilitadas?

  • Compartiremos esta información a medida que nos acerquemos a las fechas de lanzamiento de características.

Pregunta:¿Cómo se migrarán las etiquetas?

  • La siguiente lógica se usa para determinar qué sección se lee y se usa para leer o escribir datos de etiquetas.
Acción Característica no habilitada Característica habilitada
Leer Etiqueta en custom.xml (desprotegido) o Doc SummaryInfo (protegido). Si la etiqueta existe en labelinfo.xml, es la etiqueta eficaz.
Si no hay ninguna etiqueta en labelinfo.xml, etiqueta en custom.xml o Doc SummaryInfo es la etiqueta eficaz.
Escribir Todas las etiquetas nuevas se escriben en custom.xml (desprotegido) o Doc SummaryInfo (protegido). Todas las etiquetas nuevas se escriben en labelinfo.xml.


Análisis de archivos

Pregunta:¿Puedo escribir en el mismo archivo que estoy leyendo actualmente con el SDK de archivo?

El SDK de MIP no admite la lectura y escritura simultáneas del mismo archivo. Los archivos etiquetados darán como resultado una copia del archivo de entrada con las acciones de etiqueta aplicadas. La aplicación debe reemplazar el original con el archivo etiquetado.

Administración de cadenas del SDK

Pregunta:¿Cómo controla el SDK las cadenas y qué tipo de cadena debo usar en mi código?

El SDK está pensado para usarse entre plataformas y usa UTF-8 (Formato de transformación Unicode - 8 bits) para el control de cadenas. Las instrucciones específicas dependen de la plataforma que use: