Use mail flow rules to inspect message attachments in Exchange Online

In Exchange Online organizations or standalone Exchange Online Protection (EOP) organizations without Exchange Online mailboxes, you can inspect email attachments by setting up mail flow rules (also known as transport rules). Mail flow rules allow you to examine email attachments as a part of your messaging security and compliance needs. When you inspect attachments, you can then take action on the messages based on the content or characteristics of the attachments. Here are some attachment-related tasks you can do by using mail flow rules:

  • Search for files with text that matches a pattern you specify, and add a disclaimer at the end of the message.
  • Inspect content within attachments and, if there are any keywords you specify, redirect the message to a moderator for approval before it's delivered.
  • Check for messages with attachments that can't be inspected and then block the entire message from being sent.
  • Check for attachments that exceed a certain size and then notify the sender of the issue, if you choose to prevent the message from being delivered.
  • Check whether the properties of an attached Office document match the values that you specify. With this condition, you can integrate the requirements of your mail flow rules and DLP policies with a third-party classification system, such as SharePoint or the Windows Server File Classification Infrastructure (FCI).
  • Create notifications that alert users if they send a message that has matched a mail flow rule.
  • Block all messages containing attachments. For examples, see Use mail flow rules for attachment blocking scenarios in Exchange Online.

Note

All of these conditions will scan compressed archive attachments.

Exchange Online administrators can create mail flow rules in the Exchange admin center (EAC) at Mail flow > Rules. You need permissions to do this procedure. After you start to create a new rule, you can see the full list of attachment-related conditions by selecting Any attachment under Apply this rule if. The attachment-related options are shown in the following diagram.

List of conditions for attachments.

For more information about mail flow rules, including the full range of conditions and actions that you can choose, see Mail flow rules (transport rules) in Exchange Online. Exchange Online Protection (EOP) and hybrid customers can benefit from the mail flow rules best practices provided in Best Practices for Configuring EOP. If you're ready to start creating rules, see Manage mail flow rules in Exchange Online.

Tip

If you suspect that your rule isn't working properly, first check which attachments the message contains. To inspect which attachment(s) the message contained during Mail flow rule evaluation, see Test-TextExtraction.

This method should work.

Inspect the content within attachments

You can use the mail flow rule conditions in the following table to examine the content of message attachments. For these conditions, only the first 1 megabyte (MB) of text extracted from an attachment is inspected. The 1-MB limit refers to the extracted text, not the file size of the attachment. For example, a 2-MB file may contain less than 1 MB of text so that all of the text would be inspected.

To start using these conditions when inspecting messages, you need to add them to a mail flow rule. For more information about creating or changing rules, see Manage mail flow rules in Exchange Online.

Condition name in the EAC Condition name in Exchange Online PowerShell Description
Any attachment's content includes
Any attachment > content includes any of these words
AttachmentContainsWords This condition matches messages with supported file type attachments that contain a specified string or group of characters.
Any attachment's content matches
Any attachment > content matches these text patterns
AttachmentMatchesPatterns This condition matches messages with supported file type attachments that contain a text pattern that matches a specified regular expression.
Any attachment's content can't be inspected
Any attachment > content can't be inspected
AttachmentIsUnsupported Mail flow rules only can inspect the content of supported file types. If the mail flow rule finds an attachment that isn't supported, the AttachmentIsUnsupported condition is triggered. The supported file types are described in the next section.

Note

Supported file types for mail flow rule content inspection

The following table lists the file types supported by mail flow rules. The system automatically detects file types by inspecting file properties rather than the actual file name extension, thus helping to prevent malicious hackers from being able to bypass mail flow rule filtering by renaming a file extension. A list of file types with executable code that can be checked within the context of mail flow rules is specified later in this article.

Category File extension Notes
Adobe PDF .pdf None
Compressed archive files .arj, .bz2, .cab, .chm, .gz, .gzip, .lha, .lzh, .lzma, .mhtml, .msp, .rar, .rar4, .tar, .xar, .xz, .zip, .7z None
HTML .ascx, .asp, .aspx, .css, .hta, .htm, .html, .htw, .htx, .jhtml None
JSON adaptivecard, .json, messagecard None
Mail .eml, .msg, .nws None
Microsoft Office .doc, .docb, .docm, .docx, .dot, .dotm, .dotx, .obd, .obt, .one, .pot, .potm, .potx, .ppa, .ppam, .pps, .ppsm, .ppsx, .ppt, .pptm, .pptx, .xlb, .xlc, .xlm, .xls, .xlsb, .xlsm, .xlsx, .xlt, .xltm, .xltx, .xlw The contents of any embedded parts contained within these file types are also inspected. However, any objects that aren't embedded (for example, linked documents) aren't inspected. Content within the custom properties is also scanned.
Microsoft Office xml .excelml, .powerpointml, .wordml None
Microsoft Visio .vdw, .vdx, .vsd, .vsdm, .vsdx, .vss, .vssm, .vssx, .vst, .vstm, .vstx, .vsx, .vtx None
OpenDocument .odp, .ods, .odt No parts of .odf files are processed. For example, if the .odf file contains an embedded document, the contents of that embedded document aren't inspected.
Other .dfx, .dxf, .encoffmetro, .fluid, .mime, .pointpub, .pub, .rtf, .vtt, .xps None
Text .asm, .bat, .c, .class, .cmd, .cpp, .cs, .csv, .cxx, .def, .dic, .h, .hpp, .hxx, .ibq, .idl, .inc, .inf, .ini, .inx, .java, .js, .json, .lnk, .log, .m3u, messagestorage, .mpx, .php, .pl, .pos, .tsv, .txt, .vcf, .vcs Other files that are text based are also scanned. This list is representative.
XML .infopathml, .jsp, .mspx, .xml None

Inspect the file properties of attachments

The following conditions can be used in mail flow rules to inspect different properties of files that are attached to messages. To start using these conditions when inspecting messages, you need to add them to a mail flow rule. For more information about creating or changing rules, see Manage mail flow rules.

Note

If you would like to block certain files using the file condition AttachmentNameMatchesPatterns or AttachmentExtensionMatchesWords, be aware that this condition is inspecting the actual file name extension and not the file properties, which is different than the earlier mentioned file content inspection of other conditions. If you need to block a file based on the system file property detection, for example, the file is renamed, use the "common attachment filter" feature of the Anti-Mailware policy instead.

Condition name in the EAC Condition name in Exchange Online PowerShell Description
Any attachment's file name matches

Any attachment > file name matches these text patterns

AttachmentNameMatchesPatterns This condition matches messages with attachments whose file name contains the characters you specify.
Any attachment's file extension matches

Any attachment > file extension includes these words

AttachmentExtensionMatchesWords This condition matches messages with attachments whose file name extension matches what you specify.
Any attachment is greater than or equal to

Any attachment > size is greater than or equal to

AttachmentSizeOver This condition matches messages with attachments when those attachments are greater than or equal to the size you specify.

This condition refers to the sizes of individual attachments, not the cumulative size. For example, if you set a rule to reject any attachment that is 10 MB or greater, a single attachment with a size of 15 MB are rejected, but a message with three 5-MB attachments is allowed.

The message didn't complete scanning

Any attachment > didn't complete scanning

AttachmentProcessingLimitExceeded This condition matches messages when an attachment isn't inspected by the mail flow rules agent.
Any attachment has executable content

Any attachment > has executable content

AttachmentHasExecutableContent This condition matches messages that contain executable files as attachments. The supported file types are listed here.
Any attachment is password protected

Any attachment > is password protected

AttachmentIsPasswordProtected This condition matches messages with attachments that are protected by a password. Password detection works for Office documents, compressed files (.zip, .7z), and .pdf files.
Any attachment has these properties, including any of these words

Any attachment > has these properties, including any of these words

AttachmentPropertyContainsWords This condition matches messages where the specified property of the attached Office document contains specified words. A property and its possible values are separated with a colon. Multiple values are separated with a comma. Multiple property-value pairs are also separated with a comma.

Note

Supported executable file types for mail flow rule inspection

The mail flow rules use true type detection to inspect file properties rather than merely the file extensions. This approach helps to prevent malicious hackers from being able to bypass your rule by renaming a file extension. The following table lists the executable file types supported by these conditions. If a file that isn't listed here is found, the AttachmentIsUnsupported condition is triggered.

Type of file Native extension
32-bit Windows executable file with a dynamic link library extension. .dll
Self-extracting executable program file. .exe
Uninstallation executable file. .exe
Program shortcut file. .exe
32-bit Windows executable file. .exe
Microsoft Visio XML drawing file. .vxd
OS/2 operating system file. .os2
16-bit Windows executable file. .w16
Disk-operating system file. .dos
European Institute for Computer Antivirus Research standard antivirus test file. .com
Windows program information file. .pif
Windows executable program file. .exe

Important

.rar (self-extracting archive files created with the WinRAR archiver), .jar (Java archive files), and .obj (compiled source code, 3D object, or sequence files) files are not considered to be executable file types. To block these files, you can use mail flow rules that look for files with these extensions as described earlier in this article, or you can configure an antimalware policy that blocks these file types (the common attachment types filter). For more information, see Configure anti-malware policies in EOP.

Data loss prevention policies and attachment mail flow rules

Note

This section doesn't apply to standalone EOP organizations.

To help you manage important business information in emails, you can include any of the attachment-related conditions along with the rules of a data loss prevention (DLP) policy.

DLP policies and attachment-related conditions can help you enforce your business needs by defining those needs as mail flow rule conditions, exceptions, and actions. When you include the sensitive information inspection in a DLP policy, any attachments to messages are scanned for that information only. However, attachment-related conditions such as size or file type aren't included until you add the conditions listed in this article. DLP isn't available with all versions of Exchange; for more information, see Data loss prevention.

For more information

For information on broadly blocking email with attachments, regardless of malware status, see Common attachment blocking scenarios for mail flow rules in Exchange Online.