Procesamiento de archivos de mensajes de correo electrónico sdk de archivo

EL SDK de MIP admite el descifrado y el cifrado de mensajes de correo electrónico. Tanto los archivos .msg, generados por Outlook o Exchange, como los archivos .rpmsg son compatibles con el SDK, aunque a través de métodos ligeramente diferentes.

Los casos de uso comunes para este escenario son:

  • Descifrar correo y datos adjuntos para la inspección de prevención de pérdida de datos (DLP).
  • Publicar mensajes protegidos directamente desde aplicaciones de línea de negocio
  • Descifrar, modificar y volver a proteger los mensajes en tránsito.
  • Aplique etiquetas a los correos electrónicos de dlp o servicios de puerta de enlace de correo.

Instrucción de soporte técnico de archivos MSG

EL SDK de MIP admite la aplicación de protección y la eliminación de archivos MSG. Dada la variedad de tipos de codificación y variables en el formato a lo largo de los años, no es posible garantizar que el SDK de MIP pueda quitar la protección de todos los archivos MSG. En la sección siguiente se describe la compatibilidad con los archivos MSG de varios orígenes.

  • La eliminación de la protección de los archivos MSG que estaban protegidos con el SDK de MIP es totalmente compatible.
  • La eliminación de la protección de los archivos MSG creados por las versiones compatibles actualmente del Outlook cliente es totalmente compatible.
  • La eliminación de la protección de los archivos MSG creados por versiones no compatibles del Outlook cliente es compatible con el máximo esfuerzo.

Etiquetado de archivos MSG

A partir de SDK de MIP 1.10,se admite la lectura y escritura de etiquetas en archivos MSG. Los datos adjuntos secundarios no heredarán la etiqueta, pero heredarán la configuración de protección. Para obtener más información, consulte Operaciones de etiquetado y protección en el SDK de archivos para archivos .msg.

Operaciones de etiquetado y protección en el SDK de archivo para archivos .msg

El SDK de archivo admite las operaciones de etiquetado y protección para los archivos .msg de forma idéntica a cualquier otro tipo de archivo, excepto que el SDK necesita la aplicación para habilitar la marca de característica MSG.

Como se ha comentado anteriormente, la creación de instancias de mip::FileEngine requiere un objeto de configuración, mip::FileEngineSettings . mip::FileEngineSettings puede usarse para pasar parámetros de configuración personalizada para satisfacer necesidades específicas de la aplicación. Para habilitar el SDK de MIP para procesar archivos MSG, la propiedad del objeto se usa para establecer la marca para habilitar el procesamiento CustomSettingsFileEngineSettings de archivos enable_msg_file_type .msg.

El pseudocódigo de las operaciones de protección de archivos .msg puede tener el siguiente aspecto:

  • Establezca enable_msg_file_type la marca en y agregue la opción para mip::FileEngineSettingsmip::FileEnginemip::FileProfile .
  • Use la FileEngine opción para capturar la lista de etiquetas para el usuario.
  • Construya mip::FileHandler que apunta al archivo que se va a etiquetar.
  • Seleccione una etiqueta y use el mip::FileHandler método 's SetLabel para aplicar la etiqueta.

Consulte Inicio rápido: Etiquetas de lista para obtener información sobre cómo enumerar etiquetas.

Operaciones del SDK de archivo para archivos .rpmsg

EL SDK de MIP expone una función de inspección que puede descifrar el archivo message.rpmsg incrustado y presentar un conjunto de transmisiones de bytes como resultado. El consumidor del SDK debe extraer el archivo message.rpmsg y pasarlo a la API de inspección. Existen variaciones de este nombre de archivo para Office escenarios de cifrado de mensajes y la API también aceptará message_v2, v3 o v4 archivos.

Importante

La API de inspección no proporciona un resultado que dará como resultado un archivo utilizable, ni le permite volver a proteger el archivo de entrada. Genera transmisiones de bytes que la aplicación puede procesar más adelante. El SDK de MIP no admite la recreación de archivos MSG a partir de archivos message.rpmsg.

Normalmente, los servicios de puerta de enlace de correo y prevención de pérdida de datos (DLP) controlan los mensajes compatibles con MIME mientras el correo electrónico está en tránsito. Cuando el correo está protegido, el contenido cifrado del mensaje se almacena en un archivo adjunto, message.rpmsg. Este archivo adjunto contiene el cuerpo del correo electrónico cifrado y los datos adjuntos que formaban parte del mensaje original. El archivo rpmsg se adjunta a un correo electrónico contenedor de texto sin formato y se envía al servicio de correo. Una vez que ese mensaje deja el Exchange o Exchange Online, está en el formato compatible con MIME para que se pueda enviar a su destino.

En la mayoría de los casos, el servicio DLP necesita obtener los datos adjuntos y bytes de texto sin formato del mensaje para inspeccionar y evaluar las directivas DLP. La API de inspección toma el message.rpmsg como entrada y devuelve transmisiones de bytes como salida. Estas secuencias de bytes contienen los bytes de texto sin formato del mensaje y los datos adjuntos. El desarrollador de aplicaciones debe controlar estas transmisiones y hacer algo útil con ellas (inspeccionar, descifrar de forma recursiva, etc.).

La API se implementa a través de una clase, que expone las Inspect operaciones para inspeccionar los tipos de archivo mip::FileInspector admitidos. mip::MsgInspector que extiende mip::FileInspector , expone las operaciones de descifrado específicas del formato de archivo rpmsg. EL SDK de MIP no admite escenarios de publicación para archivos message.rpmsg. Además, la FileHandler::RemoveProtection() API no admite archivos message.rpmsg. Los archivos Message.rpmsg solo se pueden descifrar para la inspección y no se mostrará un archivo válido que se pueda usar. Si la aplicación requiere una salida de archivo, debe pasar un archivo MSG y quitar la protección de ese objeto.

mip::MsgInspector clase expone debajo de los miembros:

public const std::vector<uint8_t>& GetBody()
public BodyType GetBodyType() const
public BodyType GetBodyType() const
public InspectorType GetInspectorType() const
public std::shared_ptr<Stream> GetFileStream() const

Para obtener más información, consulte Referencia de API.

Pasos siguientes

  • Revisar la guía de inicio rápido sdk de archivo : procesar archivos .msg de correo electrónico (C++)
  • Revisar la guía de inicio rápido sdk de archivo : procesar archivos .msg de correo electrónico (C#)