Verarbeitung von E-Mail-Nachrichten-Dateien mit dem File-SDK

Das MIP SDK unterstützt die Entschlüsselung und Verschlüsselung von E-Mail-Nachrichten. Sowohl .msg-Dateien, die von Outlook oder Exchange erzeugt werden, als auch .rpmsg-Dateien werden vom SDK unterstützt, wenn auch mit leicht unterschiedlichen Methoden.

Häufige Anwendungsfälle für .msg Dateien sind:

• Wenden Sie Bezeichnungen auf E-Mails von DLP- oder Mail-Gateway-Diensten an.
• Entschlüsseln Sie vertrauliche Dokumente, die mit eDiscovery gescannt werden sollen.
• Entschlüsselung, Änderung und erneuter Schutz von Nachrichten während der Übertragung.
• Veröffentlichen Sie geschützte Nachrichten direkt aus Branchenanwendungen.

Wenn eine .msg Datei als Eingabe angegeben wird, gibt MIP SDK eine beschriftete, geschützte oder nicht geschützte .msg Datei aus.

Häufige Anwendungsfälle für RPMSG-Dateien sind:

• Entschlüsseln Sie E-Mails und Anhänge für die Inspektion zur Verhinderung von Datenverlusten (Data Loss Prevention, DLP).

Wenn eine RPMSG-Datei als Eingabe angegeben wird, prüft MIP SDK Textbytes und Anlagen. Beim Entschlüsseln einer RPMSG-Datei wird keine RPMSG-Datei als Ausgabe erzeugt.

MSG-Datei-Unterstützungserklärung

MIP SDK unterstützt die Anwendung und Entfernung von Schutzmaßnahmen für MSG-Dateien. Angesichts der Vielzahl von Codierungstypen und Variablen im Format im Laufe der Jahre ist es nicht möglich, zu garantieren, dass MIP SDK den Schutz von allen .msg-Dateien entfernen kann. Im folgenden Abschnitt wird die Unterstützung von .msg-Dateien aus verschiedenen Quellen beschrieben.

• Das Entfernen des Schutzes von .msg-Dateien, die mit MIP SDK geschützt wurden, wird vollständig unterstützt.
• Das Entfernen des Schutzes von .msg-Dateien, die von den aktuell unterstützten Versionen des Outlook-Clients erstellt wurden, wird vollständig unterstützt.
• Das Entfernen des Schutzes von .msg-Dateien, die von nicht mehr unterstützten Versionen des Outlook-Clients erstellt wurden, wird so gut es geht unterstützt.
• Der erneute Schutz von MSG-Dateien ist mit geschützten Labels nicht möglich. Benutzer müssen den Schutz aufheben und die geschützte Bezeichnung explizit entfernen, bevor Sie die Datei erneut mit einer anderen Bezeichnung schützen.

Beschriftung von .msg-Dateien

MIP SDK unterstützt das Lesen und Schreiben von Bezeichnungen für .msg-Dateien. Untergeordnete Anhänge erben die Bezeichnung nicht, wohl aber die Schutzeinstellungen. Weitere Einzelheiten finden Sie unter Beschriftungs- und Schutzvorgänge im File SDK für .msg-Dateien.

Beschriftungs- und Schutzvorgänge im File SDK für .msg-Dateien

Das Datei-SDK unterstützt Bezeichnungs- und Schutzvorgänge für .msg Dateien auf eine Weise, die mit jedem anderen Dateityp identisch ist, außer dass das SDK die Anwendung benötigt, um das MSG-Featureflagge zu aktivieren.

Wie bereits erwähnt, ist für die Instanziierung von FileEngine ein Einstellungsobjekt erforderlich: FileEngineSettings. FileEngineSettings übergibt Parameter für benutzerdefinierte Einstellungen, um bestimmte Anwendungsanforderungen zu erfüllen. Damit das MIP SDK MSG-Dateien verarbeiten kann, wird mit der CustomSettings-Eigenschaft des FileEngineSettings-Objekts das Flag für enable_msg_file_type gesetzt.

Wenn Sie ein FileEngineSettings-Objekt namens engineSettings erstellt haben, legen Sie diese Eigenschaft in .NET wie folgt fest:

engineSettings.CustomSettings = new List<KeyValuePair<string, string>>();
engineSettings.CustomSettings.Add(new KeyValuePair<string, string>("enable_msg_file_type", "true"));

Der Pseudocode für den Schutz von .msg-Dateien kann wie folgt aussehen:

• Setzen Sie das enable_msg_file_type-Flag in mip::FileEngineSettings und fügen Sie das mip::FileEngine zu mip::FileProfile hinzu.
• Verwenden Sie das FileEngine, um die Liste der Labels für den Benutzer abzurufen.
• Erstellen Sie den mip::FileHandler, der auf die zu bezeichnende Datei zeigt.
• Wählen Sie eine Bezeichnung aus und verwenden Sie die mip::FileHandler-Methode des SetLabels, um die Bezeichnung anzuwenden.

Lesen Sie den Abschnitt Schnellstart: Bezeichnungen auflisten, um zu erfahren, wie man Bezeichnungen auflistet.

Ändern von Standardverhalten der Anlagenbehandlung

Standardmäßig versucht das File SDK, alle Anlagen zu verarbeiten, die Teil einer MSG-Datei sind, oder eine message.rpmsg-Datei bei Verwendung der Inspektions-APIs. Standardmäßig werden nur das Element auf Stammebene und Anlagen der ersten Ebene entschlüsselt.

Um dieses Verhalten zu ändern, kann die benutzerdefinierte Einstellung container_decryption_option verwendet werden. In C++ wird dies über ein enum mip::ContainerDecryptionOptionverfügbar gemacht.

Das folgende Beispiel zeigt, wie Sie eine Anwendung in .NET festlegen, um nur die MSG-Stammdatei zu entschlüsseln.

engineSettings.CustomSettings.Add(new KeyValuePair<string, string>("container_decryption_option", "Top"));

Und in C++:

vector<pair<string, string>> customSettings;
customSettings.emplace_back(mip::GetCustomSettingContainerDecryptionOption(),
        mip::ContainerDecryptionOptionString(mip::ContainerDecryptionOption::Top));
engineSettings.SetCustomSettings(customSettings);

File SDK-Vorgänge für .rpmsg-Dateien

MIP SDK stellt eine Inspektionsfunktion bereit, die die eingebettete Datei message.rpmsg entschlüsseln und eine Reihe von Byteströmen als Ausgabe präsentieren kann. Der SDK-Consumer muss die Datei message.rpmsg extrahieren und an die Inspektions-API übergeben. Variationen dieses Dateinamens sind für Purview-Nachrichtenverschlüsselungsszenarien vorhanden, und die API akzeptiert auch message_v2-, v3- oder v4-Dateien.

In den meisten Fällen muss der DLP-Dienst die Anhänge und Nur-Text-Bytes der Nachricht abrufen, um sie zu prüfen und anhand der DLP-Richtlinien zu bewerten. Die Inspect-API verwendet "message.rpmsg" als Eingabe und gibt Bytedatenströme als Ausgabe zurück. Diese Byteströme enthalten die Nur-Text-Bytes der Nachricht und der Anhänge. Der Anwendungsentwickler verarbeitet diese Datenströme und verarbeitet sie weiter (prüfen, rekursiv entschlüsseln usw.).

Die Inspect-API wird durch eine Klasse, mip::FileInspector, implementiert, die Vorgänge zur Überprüfung der unterstützten Dateitypen bereitstellt. mip::MsgInspector, das mip::FileInspector erweitert, bietet Entschlüsselungsvorgänge speziell für das rpmsg-Dateiformat. Das MIP SDK unterstützt keine Veröffentlichungsszenarien für message.rpmsg -Dateien. Außerdem unterstützt auch die FileHandler::RemoveProtection()-API keine message.rpmsg-Dateien. Message.rpmsg-Dateien können nur zu Prüfzwecken entschlüsselt werden und geben keine gültige, brauchbare Datei aus. Wenn Ihre Anwendung eine Dateiausgabe erfordert, müssen Sie eine .msg-Datei übergeben und den Schutz für dieses Objekt aufheben.

Die mip::MsgInspector-Klasse macht die folgenden Member verfügbar:

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

Weitere Informationen finden Sie im Microsoft Information Protection (MIP)-SDK für C++: Referenz.

Nächste Schritte

• Überblick über den File SDK – Verarbeiten von E-Mail-.msg-Dateien (C++) Schnellstart
• Lesen Sie den Artikel Schnellstart: File SDK – Verarbeiten von E-Mail-.msg-Dateien (C#)