From 1e531ce27ee16ed6062c8f0b8d575f91e009d910 Mon Sep 17 00:00:00 2001 From: Pramod HK Date: Fri, 17 Oct 2025 11:08:17 +0530 Subject: [PATCH 1/2] Update concept-email.md for .eml file handling Added note about .eml file support and required flag. --- mip/develop/concept-email.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/mip/develop/concept-email.md b/mip/develop/concept-email.md index 149d4a199..cefff6f57 100644 --- a/mip/develop/concept-email.md +++ b/mip/develop/concept-email.md @@ -13,7 +13,7 @@ ms.author: mbaldwin MIP SDK supports decryption and encryption for email messages. Both .msg files, generated by Outlook or Exchange, and .rpmsg files are supported by the SDK although via slightly different methods. > [!NOTE] -> As of MIP SDK 1.17, .eml files are supported. Handling is similar to .msg for labeling/protection scenarios and to .rpmsg for inspection scenarios, depending on the container format. +> As of MIP SDK 1.17, .eml files are supported. Handling is similar to .msg for labeling/protection scenarios and to .rpmsg for inspection scenarios, depending on the container format. When working with .eml files, you must set the *enable_eml_file_type* flag instead of *enable_msg_file_type*. For details on how to set this flag, please refer to the [Labeling of MSG Files](#labeling-of-msg-files) section. Common use cases for this scenario are: @@ -46,6 +46,8 @@ If you've created a `FileEngineSettings` object called *engineSettings*, you'd s ```csharp engineSettings.CustomSettings = new List>(); engineSettings.CustomSettings.Add(new KeyValuePair("enable_msg_file_type", "true")); +//When working with .eml files, you must set the *enable_eml_file_type* flag instead of *enable_msg_file_type* as below. +//engineSettings.CustomSettings.Add(new KeyValuePair("enable_eml_file_type", "true")); ``` The .msg file protection operations pseudocode may look like: From b30bf673fe6fb05054cc31483022078e17408934 Mon Sep 17 00:00:00 2001 From: Pramod HK Date: Wed, 22 Oct 2025 12:36:47 +0530 Subject: [PATCH 2/2] Document support for .eml files in MIP SDK Added support details for .eml files in MIP SDK 1.17. --- mip/develop/concept-email.md | 14 +++++++++----- 1 file changed, 9 insertions(+), 5 deletions(-) diff --git a/mip/develop/concept-email.md b/mip/develop/concept-email.md index cefff6f57..aa0c3d93c 100644 --- a/mip/develop/concept-email.md +++ b/mip/develop/concept-email.md @@ -12,9 +12,6 @@ ms.author: mbaldwin MIP SDK supports decryption and encryption for email messages. Both .msg files, generated by Outlook or Exchange, and .rpmsg files are supported by the SDK although via slightly different methods. -> [!NOTE] -> As of MIP SDK 1.17, .eml files are supported. Handling is similar to .msg for labeling/protection scenarios and to .rpmsg for inspection scenarios, depending on the container format. When working with .eml files, you must set the *enable_eml_file_type* flag instead of *enable_msg_file_type*. For details on how to set this flag, please refer to the [Labeling of MSG Files](#labeling-of-msg-files) section. - Common use cases for this scenario are: - Decrypt mail and attachments for data loss prevention (DLP) inspection. @@ -46,8 +43,6 @@ If you've created a `FileEngineSettings` object called *engineSettings*, you'd s ```csharp engineSettings.CustomSettings = new List>(); engineSettings.CustomSettings.Add(new KeyValuePair("enable_msg_file_type", "true")); -//When working with .eml files, you must set the *enable_eml_file_type* flag instead of *enable_msg_file_type* as below. -//engineSettings.CustomSettings.Add(new KeyValuePair("enable_eml_file_type", "true")); ``` The .msg file protection operations pseudocode may look like: @@ -57,6 +52,15 @@ The .msg file protection operations pseudocode may look like: - Construct `mip::FileHandler` that points to the file to be labeled. - Select a label and use the `mip::FileHandler`'s `SetLabel` method to apply the label. +## Labeling of EML Files + +As of MIP SDK 1.17, .eml files are supported. Handling is similar to .msg for labeling/protection scenarios and to .rpmsg for inspection scenarios, depending on the container format. When working with .eml files, you must set the *enable_eml_file_type* flag instead of *enable_msg_file_type*. If you've created a `FileEngineSettings` object called *engineSettings*, you'd set this property in .NET as follows: + +```csharp +engineSettings.CustomSettings = new List>(); +engineSettings.CustomSettings.Add(new KeyValuePair("enable_eml_file_type", "true")); +``` + Refer to [Quickstart: List labels](quick-file-list-labels-cpp.md) for information on how to list labels. ## Changing Default Attachment Handling Behaviors