-
Notifications
You must be signed in to change notification settings - Fork 5.5k
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.
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
[Email Security] Inline deployment docs #19099
Draft
Maddy-Cloudflare
wants to merge
3
commits into
production
Choose a base branch
from
email-security/pcx-15016
base: production
Could not load branches
Branch not found: {{ refName }}
Loading
Could not load tags
Nothing to show
Loading
Are you sure you want to change the base?
Some commits from the old base branch may be removed from the timeline,
and old review comments may become outdated.
+91
−0
Draft
Changes from all commits
Commits
File filter
Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
There are no files selected for viewing
Binary file added
BIN
+16.7 KB
...es/email-security/deployment/inline-setup/CF_A1S_Deployment_Inline_Diagrams.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
14 changes: 14 additions & 0 deletions
14
...tent/docs/cloudflare-one/email-security/setup/pre-delivery-deployment/index.mdx
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,14 @@ | ||
--- | ||
title: Pre-delivery deployment | ||
pcx_content_type: navigation | ||
sidebar: | ||
order: 1 | ||
group: | ||
hideIndex: true | ||
--- | ||
|
||
import { DirectoryListing } from "~/components" | ||
|
||
|
||
|
||
<DirectoryListing /> |
57 changes: 57 additions & 0 deletions
57
...re-one/email-security/setup/pre-delivery-deployment/inline-deployment-setup.mdx
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,57 @@ | ||
--- | ||
title: Set up inline deployment | ||
pcx_content_type: concept | ||
sidebar: | ||
order: 2 | ||
--- | ||
|
||
To set up MX Inline: | ||
|
||
1. Log in to [Zero Trust](https://one.dash.cloudflare.com/). | ||
2. Select **Email Security**. | ||
3. Select **Monitoring**. If you are a first time user, select **Contact sales**. Otherwise, select **Set up**. | ||
4. Select **MX/Inline**. | ||
5. To start the MX/Inline configuration, you will have to completed the prerequisite setup on your email provider's platform. Once you have completed this step, select **I confirm that I have completed all the necessary requirements**. Then, select **Start configuration**. | ||
|
||
If you have verified zones on Cloudflare, continue with the following steps: | ||
|
||
1. **Connect a domain**: Select your domain. Then, select **Continue**. | ||
2. **Select position**: This step allows you to choose where Email Security fits into your mail flow and configure position settings: | ||
- **Select position**: Choose between: | ||
- **Sit first (hop count = 1)**: Email Security sits at the first hop. There are no other email scanners or services between the Internet and Cloudflare. | ||
- **Sit in the middle (hop count > 1)**: Email Security sits in the middle of your email processing. There are other email scanners or email services in between. | ||
- **Position settings**: Refine how Email Security receives and forwards emails: | ||
- **Forwarding address**: This is your mail flow next hope after Email Security. This value is auto-filled, but you can still change it. | ||
- **Outbound TLS**: Choose between: | ||
1. **Forward all messages over TLS** (recommended). | ||
2. **Forward all messages using opportunistic TLS**. | ||
- Select **Continue**. | ||
3. (Optional) **Configure quarantine policy**: Select dispositions to automatically prevent certain types incoming messages from reaching a recipient's inbox. | ||
4. (Optional ) **Update MX records**: | ||
- Email Security can automatically update MX records for domains that proxy traffic through Cloudflare. Under your mail processing location, select one of the following: | ||
- Global (Recommended) | ||
- US | ||
- EU | ||
5. **Review details**: Review your domain, then select **Go to domains**. | ||
|
||
## Users who do not have domains with Cloudflare | ||
|
||
If you do not have domains with Cloudflare, the dashboard will display two options: | ||
|
||
- Add a domain to Cloudflare. | ||
- Enter domain manually. | ||
|
||
### Add a domain to Cloudflare | ||
|
||
Selecting **Add a domain to Cloudflare** will redirect you to a new page where you will connect your domain to Cloudflare. Once you have entered an existing domain, select **Continue**. | ||
|
||
Then, follow the steps to [Set up MX/Inline](/cloudflare-one/email-security/setup/pre-delivery-deployment/inline-deployment-setup/). | ||
|
||
### Enter domain manually | ||
|
||
1. **Add domains**: Manually enter domain names. | ||
2. **Review all domains**: Review all your domains, then select **Continue**. | ||
3. **Verify your domains**: It may take up to 24 hours for your domains to be verified. Select **Done**. | ||
4. Once your domains have been verified, the dashboard will display a message like this: **You have verified domains ready to connect to Email Security**. This means that you can now set up Email Security via MX/Inline. | ||
5. Select **Set up**, then select **MX/Inline**. | ||
6. Follow the steps to [Set up MX/Inline](/cloudflare-one/email-security/setup/pre-delivery-deployment/inline-deployment-setup/). |
20 changes: 20 additions & 0 deletions
20
...oudflare-one/email-security/setup/pre-delivery-deployment/inline-deployment.mdx
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,20 @@ | ||
--- | ||
title: Inline deployment | ||
pcx_content_type: concept | ||
sidebar: | ||
order: 1 | ||
--- | ||
|
||
With pre-delivery deployment, also known as Inline deployment, Email Security evaluates email messages before they reach a user's inbox. | ||
|
||
Email Security becomes a hop in the SMTP processing chain and physically interacts with incoming email messages. Based on your policies, various messages are blocked before reaching the inbox. | ||
|
||
When you choose an inline deployment, you get the following benefits: | ||
|
||
- Messages are processed and physically blocked before delivery to a user's mailbox. | ||
- Your deployment is simpler, because any complex processing can happen downstream and without modification. | ||
- Email Security can modify delivered messages, adding subject or body mark-ups. | ||
- Email Security can offer high availability and adaptive message pooling. | ||
- You can set up advanced handling downstream for non-quarantined messages with added X-headers. | ||
|
||
![Inline deployment diagram](~/assets/images/email-security/deployment/inline-setup/CF_A1S_Deployment_Inline_Diagrams.png) |
Oops, something went wrong.
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Not fully sure what this is trying to say, but maybe because I lack domain knowledge?