---
id: "cloudflare-email-security"
type: "component"
kind: "email-security-gateway"
provider: "cloudflare"
category: "security"
aliases: "Area 1"
docs: "https://developers.cloudflare.com/cloudflare-one/email-security/settings/detection-settings/configure-link-actions/"
url: "https://localhost:3000/catalogue/components/cloudflare-email-security"
---

# Cloudflare Email Security

Inbound email security gateway that analyses every message for phishing, malware and fraud.

| | |
|---|---|
| Provider | [cloudflare](https://localhost:3000/catalogue?provider=cloudflare) |
| Kind | [Email security gateway](https://localhost:3000/catalogue/kinds/email-security-gateway) |
| Category | Security |
| Official docs | [https://developers.cloudflare.com/cloudflare-one/email-security/settings/detection-settings/configure-link-actions/](https://developers.cloudflare.com/cloudflare-one/email-security/settings/detection-settings/configure-link-actions/) |
| Also known as | Area 1 |

## Properties

| property | type | values | required | kind default | this component |
|---|---|---|---|---|---|
| `attachmentDetonation` | boolean | — | no | — | inherited |
| `deliveryMode` | enum | `inline-mx`, `journaling`, `api` | no | — | **"inline-mx"** |
| `dispositionHeader` | string | — | no | "X-CFEmailSecurity-Disposition" | inherited |
| `dmarcEnforcement` | boolean | — | no | — | inherited |
| `linkRewriting` | boolean | — | no | — | **true** |
| `managed` | boolean | — | no | false | **true** |
| `phishingAction` | enum | `reject`, `quarantine`, `tag`, `deliver` | no | — | inherited |
| `postDeliveryRemediation` | boolean | — | no | — | inherited |
| `quarantineRetentionDays` | integer | — | no | — | inherited |
| `retroScan` | boolean | — | no | false | inherited |
| `spamAction` | enum | `reject`, `quarantine`, `tag`, `deliver` | no | — | inherited |

Bold values are the ones this component pins.

## Rules that apply · 0

No rule selects this kind or its category.

## Other products of the same kind · 2

- [Mail Manager for Amazon SES](https://localhost:3000/catalogue/components/aws-ses-mail-manager.md) `aws-ses-mail-manager` — aws
- [Generic email security gateway](https://localhost:3000/catalogue/components/email-security-gateway.md) `email-security-gateway` — default

## Use it in a design

```yaml
nodes:
  - { id: "cloudflare-email-security", component: "cloudflare-email-security" }
```

## Source (`component` YAML, verbatim)

```yaml
# yaml-language-server: $schema=../../schema/component.schema.json
# Email Security (formerly Area 1): inbound email security gateway that "uses AI, threat
# intelligence, and security rules to analyze every incoming email". Inline MX is the
# preferred deployment because only it can modify a message ("Understanding Email Security
# Deployments"), and Email Link Isolation "is turned on by default" ("Configure link actions").
schemaVersion: "1"
type: "component"
id: "cloudflare-email-security"
kind: "email-security-gateway"
provider: "cloudflare"
docs: "https://developers.cloudflare.com/cloudflare-one/email-security/settings/detection-settings/configure-link-actions/"
aliases: ["Area 1"]
defaults:
  managed: true
  deliveryMode: "inline-mx"
  linkRewriting: true
properties:
  dispositionHeader:
    type: "string"
    default: "X-CFEmailSecurity-Disposition"
  retroScan:
    type: "boolean"
    default: false
  postDeliveryRemediation:
    type: "boolean"
```

Human page: https://localhost:3000/catalogue/components/cloudflare-email-security