Skip to content

Update concept-email.md for .eml file handling #1561

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 2 commits into
base: main
Choose a base branch
from
Open

Update concept-email.md for .eml file handling #1561

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
1e531ce
Update concept-email.md for .eml file handling
PramodKumarHK89 Oct 17, 2025
b30bf67
Document support for .eml files in MIP SDK
PramodKumarHK89 Oct 22, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
12 changes: 9 additions & 3 deletions mip/develop/concept-email.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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.

Common use cases for this scenario are:

- Decrypt mail and attachments for data loss prevention (DLP) inspection.
Expand Down Expand Up @@ -55,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<KeyValuePair<string, string>>();
engineSettings.CustomSettings.Add(new KeyValuePair<string, string>("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
Expand Down