Bestands-SDK voor het verwerken van e-mailberichten

MIP SDK biedt ondersteuning voor ontsleuteling en versleuteling voor e-mailberichten. Zowel .msg bestanden, gegenereerd door Outlook of Exchange, als RPMSG-bestanden worden ondersteund door de SDK, hoewel ze iets anders zijn.

Veelvoorkomende gebruiksvoorbeelden voor .msg bestanden zijn:

• Labels toepassen op e-mailberichten van DLP- of mailgateway-services.
• Gevoelige documenten ontsleutelen die moeten worden gescand met eDiscovery.
• Berichten tijdens overdracht ontsleutelen, wijzigen en opnieuw beveiligen.
• Publiceer beveiligde berichten rechtstreeks vanuit Line-Of-Business-toepassingen.

Wanneer u een .msg-bestand als invoer krijgt, voert de MIP SDK een gelabeld, beveiligd of onbeveiligd .msg bestand uit.

Veelvoorkomende gebruiksvoorbeelden voor RPMSG-bestanden zijn:

• E-mail en bijlagen ontsleutelen voor DLP-inspectie (Preventie van gegevensverlies).

Wanneer u een RPMSG-bestand als invoer krijgt, inspecteert MIP SDK body bytes en bijlagen. Het ontsleutelen van een RPMSG-bestand produceert geen RPMSG-bestand als uitvoer.

Ondersteuningsverklaring voor MSG-bestanden

MIP SDK ondersteunt de beveiligingstoepassing en het verwijderen van MSG-bestanden. Gezien de verschillende coderingstypen en variabelen in de indeling in de loop van de jaren, is het niet mogelijk om te garanderen dat MIP SDK de beveiliging van alle MSG-bestanden kan verwijderen. In de volgende sectie wordt de ondersteuning voor MSG-bestanden uit verschillende bronnen beschreven.

• Het verwijderen van beveiliging tegen MSG-bestanden die zijn beveiligd met MIP SDK, wordt volledig ondersteund.
• Het verwijderen van beveiliging tegen MSG-bestanden die zijn gemaakt door momenteel ondersteunde versies van de Outlook-client, wordt volledig ondersteund.
• Het verwijderen van beveiliging van MSG-bestanden die zijn gemaakt door niet meer ondersteunde versies van de Outlook-client, wordt ondersteund op basis van best effort.
• Het opnieuw beveiligen van MSG-bestanden is niet beschikbaar met beveiligde labels. Gebruikers moeten de beveiliging opheffen en het beveiligde label expliciet verwijderen voordat ze het bestand opnieuw beveiligen met een ander label.

Labelen van MSG-bestanden

MIP SDK ondersteunt het lezen en schrijven van labels op MSG-bestanden. Onderliggende koppelingen nemen het label niet over, maar nemen wel de beveiligingsinstellingen over. Bekijk label- en beveiligingsbewerkingen in de Bestands-SDK voor .msg bestanden voor meer informatie.

Label- en beveiligingsbewerkingen in de Bestands-SDK voor .msg bestanden

Bestands-SDK ondersteunt label- en beveiligingsbewerkingen voor .msg bestanden op een manier die identiek is aan elk ander bestandstype, behalve dat de SDK de toepassing nodig heeft om de MSG-functievlag in te schakelen.

Zoals eerder besproken, is het instantiëren van FileEngine een instellingenobject vereist. FileEngineSettings FileEngineSettings geeft parameters door voor aangepaste instellingen om te voldoen aan specifieke toepassingsbehoeften. Als u wilt dat DE MIP SDK MSG-bestanden verwerkt, stelt de CustomSettings eigenschap van het FileEngineSettings object de vlag in voor enable_msg_file_type.

Als u een FileEngineSettings object hebt gemaakt met de naam engineSettings, stelt u deze eigenschap in .NET als volgt in:

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

De pseudocode van de .msg bestandsbeveiligingsbewerkingen kan er als volgt uitzien:

• Stel enable_msg_file_type de vlag in mip::FileEngineSettings en voeg het mip::FileEngine toe aan mip::FileProfile.
• Gebruik de FileEngine lijst met labels voor de gebruiker op te halen.
• Maak mip::FileHandler die verwijst naar het bestand dat moet worden gelabeld.
• Selecteer een label en gebruik de mip::FileHandler-methode om het SetLabel-label toe te passen.

Raadpleeg quickstart: Lijstlabels voor informatie over het weergeven van labels.

Standaardgedrag voor het verwerken van bijlagen wijzigen

De File SDK probeert standaard alle bijlagen te verwerken die deel uitmaken van een MSG-bestand of een message.rpmsg-bestand bij het gebruik van de inspectie-API's. Alleen het item op hoofdniveau en het eerste niveau van bijlagen worden standaard ontsleuteld.

Als u dit gedrag wilt wijzigen, kunt u de aangepaste instelling container_decryption_option gebruiken. In C++ wordt dit weergegeven via een enum, mip::ContainerDecryptionOption.

In het volgende voorbeeld ziet u hoe u een toepassing in .NET instelt om alleen het MSG-hoofdbestand te ontsleutelen.

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

En in C++:

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

Bestands-SDK-bewerkingen voor RPMSG-bestanden

MIP SDK maakt een inspectiefunctie beschikbaar waarmee het ingesloten message.rpmsg-bestand kan worden ontsleuteld en een set bytestreams als uitvoer kan worden weergegeven. De SDK-consument moet het bestand message.rpmsg extraheren en doorgeven aan de inspectie-API. Er bestaan variaties van deze bestandsnaam voor Purview Message Encryption-scenario's en de API accepteert ook message_v2-, v3- of v4-bestanden.

In de meeste gevallen moet de DLP-service de bijlagen en platte tekst bytes uit het bericht ophalen om deze te controleren en te evalueren tegen DLP-beleid. De inspect-API gebruikt de message.rpmsg als invoer en retourneert bytestreams als uitvoer. Deze bytestromen bevatten de platte tekstbytes van het bericht en de bijlagen. De ontwikkelaar van de toepassing verwerkt deze stromen en verwerkt deze verder (inspecteer, recursief ontsleutelen, enzovoort).

De Inspect API wordt geïmplementeerd via een klasse, mip::FileInspectorwaarmee bewerkingen worden weergegeven voor het inspecteren van ondersteunde bestandstypen. mip::MsgInspector, die mip::FileInspector uitbreidt, maakt ontsleutelingsbewerkingen beschikbaar die specifiek zijn voor het rpmsg-bestandsformaat. MIP SDK biedt geen ondersteuning voor publicatiescenario's voor message.rpmsg-bestanden . Daarnaast biedt de FileHandler::RemoveProtection() API geen ondersteuning voor message.rpmsg-bestanden. Message.rpmsg-bestanden kunnen alleen worden ontsleuteld voor inspectie en leveren geen geldig, bruikbaar bestand op. Als voor uw toepassing uitvoer van bestanden is vereist, moet u een MSG-bestand doorgeven en de beveiliging van dat object verwijderen.

mip::MsgInspector klasse bevat de volgende leden:

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

Zie de MICROSOFT Information Protection -SDK (MIP) voor C++: Naslaginformatie voor meer informatie.

Volgende stappen

• Beoordeel de File SDK - Quickstart voor het verwerken van e-mail .msg-bestanden (C++)
• De bestands-SDK controleren - Quickstart voor het verwerken van e-mail .msg bestanden (C#)