Skip to content
Cloudflare Docs

Dispositions and attributes

Email Security uses a variety of factors to determine whether a given email message, domain, URL, or packet is part of a campaign. These small pattern assessments are dynamic in nature and — in many cases — no single pattern will determine the final verdict.

Dispositions

Any traffic that flows through Email Security is given a final disposition, which represents our evaluation of that specific message. Each message will receive only one disposition header, so your organization can take clear and specific actions on different message types.

You can use disposition values when setting up auto-moves.

Available values

  • Malicious: Traffic associated with active threat campaigns. Malicious messages invoked multiple phishing verdict triggers and met thresholds for bad behavior.
    • Recommendation: Block.
  • Spoof: Traffic associated with phishing campaigns that is either non-compliant with your email authentication policies (SPF, DKIM, DMARC) or has mismatching Envelope From and Header From values.
    • Recommendation: Block after investigating (can be triggered by third-party mail services).
  • Suspicious: Traffic associated with phishing campaigns (and is under further analysis by our automated systems).
    • Recommendation: Research these messages internally to evaluate legitimacy.
  • Spam: Traffic associated with non-malicious, commercial campaigns.
    • Recommendation: Route to existing Spam quarantine folder.
  • Bulk: Traffic often associated with newsletters or marketing campaigns. Refer to Graymail for more details.
    • Recommendation: Monitor or tag.

Attributes

Traffic that flows through Email Security can also receive one or more Attributes, which indicate that a specific condition has been met.

Available values

AttributeNotes
CUSTOM_BLOCK_LISTThis message matches a value you have defined in your custom block list.
NEW_DOMAIN_SENDER=<REGISTRATION_DATE>Alerts to mail from a newly registered domain. Formatted as yyyy-MM-dd HH:mm:ss ZZZ.
NEW_DOMAIN_LINK=<REGISTRATION_DATE>Alerts to mail with links pointing out to a newly registered domain. Formatted as yyyy-MM-dd HH:mm:ss ZZZ.
ENCRYPTEDEmail message is encrypted.
EXECUTABLEEmail message contains an executable file.
BECIndicates that an email address was contained in your impersonation registry list. Associated with MALICIOUS or SPOOF dispositions.

Header structure

When Email Security adds a disposition header to an email message, that header matches the following format:

X-CFEmailSecurity-Attribute: [Value]
X-CFEmailSecurity-Attribute: [Value2]