Skip to content

Commit 4189545

Browse files
Maddy-CloudflareMaddy-Cloudflare
committed
[Email Security] Add M365 journaling setup
1 parent 986373c commit 4189545

File tree

4 files changed

+174
-0
lines changed

4 files changed

+174
-0
lines changed

‎src/content/docs/cloudflare-one/email-security/setup/post-delivery-deployment/bcc-journaling/journaling-setup/m365-journaling.mdx‎

Lines changed: 14 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -11,6 +11,20 @@ When you receive an email, the email lands on your Microsoft 365 inbox, and then
1111

1212
![Email flow when setting up Microsoft 365 with Email Security.](~/assets/images/email-security/deployment/api-setup/journaling/Email_Security_MS365_Journaling_Diagram.png)
1313

14+
<Render file="email-security/deployment/m365-gcc" />
15+
16+
## Journaling
17+
18+
<Render file="email-security/deployment/journaling-connector" />
19+
20+
## Geographic locations
21+
22+
<Render file="email-security/deployment/bcc-table-geographic-locations" />
23+
24+
---
25+
26+
## Enable Microsoft 365 journaling deployment
27+
1428
To enable Microsoft 365 journaling deployment:
1529

1630
1. Log in to [Zero Trust](https://one.dash.cloudflare.com/).

‎src/content/partials/cloudflare-one/email-security/deployment/bcc-table-geographic-locations.mdx‎

Lines changed: 17 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,17 @@
1+
---
2+
{}
3+
4+
---
5+
6+
Select from the following BCC addresses to process email in the correct geographic location:
7+
8+
| Host | Location | Note |
9+
| ---------------------------------------------------------------------- | ----------------------- | ------------------------------------------------------------------------------------------------------------------ |
10+
| `<customer_name>@journaling.mxrecord.io` | US | Best option to ensure all email traffic processing happens US data centers. |
11+
| `<customer_name>@journaling.mailstream-eu-primary.mxrecord.io` | EU | Best option to ensure all email traffic processing happens in Germany, with backup to US data centers. |
12+
| `<customer_name>@journaling.mailstream-eu1.mxrecord.io` | EU | Best option to ensure all email traffic processing happens within the EU without backup to US data centers. |
13+
| `<customer_name>@journaling.mailstream-bom.mxrecord.mx` | India | Best option to ensure all email traffic processing happens within India. |
14+
| `<customer_name>@journaling.mailstream-india-primary.mxrecord.mx` | India | Same as `mailstream-bom.mxrecord.mx`, with backup to US data centers. |
15+
| `<customer_name>@journaling.mailstream-asia.mxrecord.mx` | India | Best option to ensure all email traffic processing happens in India, with Australia data centers as backup. |
16+
| `<customer_name>@journaling.mailstream-syd.area1.cloudflare.net` | Australia / New Zealand | Best option to ensure all email traffic processing happens within Australia. |
17+
| `<customer_name>@journaling.mailstream-australia.area1.cloudflare.net` | Australia / New Zealand | Best option to ensure all email traffic processing happens in Australia, with India and US data centers as backup. |

‎src/content/partials/cloudflare-one/email-security/deployment/journaling-connector.mdx‎

Lines changed: 135 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,135 @@
1+
---
2+
{}
3+
4+
---
5+
6+
### 1. Configure connector for delivery to Email Security (if required)
7+
8+
:::note
9+
Email Security only scans inbound emails.
10+
:::
11+
12+
If your email architecture does not include an outbound gateway, you can skip this step and [proceed to the next one](#2-configure-journal-rule).
13+
14+
On the other hand, if your email architecture requires outbound messages to traverse your email gateway, you may want to consider configuring a connector to send the journal messages directly to Email Security.
15+
16+
1. Log in to the [Exchange admin center](https://admin.exchange.microsoft.com), and go to **Mail flow** > **Connectors**.
17+
18+
2. Select **Add a connector**.
19+
20+
3. Configure the new connector as follows:
21+
- **Connection From**: Office 365
22+
- **Connection to**: Partner Organization
23+
24+
4. Select **Next**.
25+
26+
5. Configure the connector as follows:
27+
- **Name**: `Deliver journal directly to Email Security`
28+
- **Description**: `Deliver journal directly to Email Security`
29+
- **Turn it on**: Enabled.
30+
31+
6. Select **Next**.
32+
33+
7. Configure the **Use of connector** setting as follows:
34+
- Select **Only when email messages are sent to these domains**.
35+
- In the text field, enter `journaling.mxrecord.io` as the host address, and select **+** to add the domain.
36+
37+
8. Select **Next**.
38+
39+
9. Configure the **Routing** setting as follows:
40+
- Select **Route email through these smart hosts**.
41+
- In the text field, enter `journaling.mxrecord.io` as the [smart host](https://en.wikipedia.org/wiki/Smart_host) address, and select **+** to add the domain.
42+
43+
10. Select **Next**.
44+
45+
11. In **Security restrictions**, you need to keep the default TLS configuration. Review the following settings:
46+
- Make sure the **Always use Transport Layer Security (TLS) to secure the connection (recommended)** checkbox is selected.
47+
- In **Connect only if the recipients email server certificate matches this criteria** select **Issued by a trusted certificate authority (CA)**.
48+
49+
12. Select **Next**.
50+
51+
13. You need to validate the connector by using your tenant's specific journaling address. To find this address:
52+
53+
- In [Zero Trust](https://one.dash.cloudflare.com/), go to **Email Security**.
54+
- Go to **Settings** and locate your domain under **Your domains**.
55+
- Select the three dots > **View domain** > **Service address**. Copy and paste the service address.
56+
57+
14. Add the address and select **Validate**.
58+
59+
15. Once the validation completes, you should receive a **Succeed** status for all the tasks. Select **Next**.
60+
61+
16. Review the configuration and select **Create connector**.
62+
63+
Your connector is now active. You can find it in **Exchange admin center** > **Mail flow** > **Connectors**.
64+
65+
### 2. Configure journal rule
66+
67+
1. Log in to the [Microsoft Purview compliance portal](https://compliance.microsoft.com/homepage).
68+
69+
2. Go to **Data lifecycle management** > **Exchange (legacy)**.
70+
71+
3. Select **Settings** (the gear icon).
72+
73+
4. In **Send undeliverable journal reports to** enter the email address of a valid user account. Note that you cannot use a team or group address.
74+
75+
5. Select **Save**.
76+
77+
6. Still in the Exchange (legacy) screen, select **Journal Rules**.
78+
79+
7. Select **New rule** to configure a journaling rule, and configure it as follows:
80+
81+
* **Send journal reports to**: This address is specific to each customer tenant, and can be found in [Zero Trust](https://one.dash.cloudflare.com/) by going to:
82+
- **Email Security** > **Settings**.
83+
- Locate your domain under **Your domains**.
84+
- Select the three dots > **View domain** > **Service address**.
85+
. For example, `<customer_name>@journaling.mxrecord.io`.
86+
* **Journal Rule Name**: `Journal Messages to Cloudflare Email Security`
87+
* **Journal messages sent or received from**: *Everyone*
88+
* **Type of message to journal**: *External messages only*
89+
90+
8. Select **Next**.
91+
92+
9. Verify the information is correct, and select **Submit** > **Done**.
93+
94+
Once saved, the rule is automatically active. However, it may take a few minutes for the configuration to propagate and start pushing messages to Email Security. After it propagates, you can access the Email Security dashboard to check the number of messages processed. This number will grow as journaled messages are sent to Email Security from your Exchange server.
95+
96+
### 3. Compliance
97+
98+
#### Create Microsoft 365 distribution lists
99+
100+
For compliance purposes, you might be required to process emails in certain geographic regions such as India or the EU. If that is your case, you should [create Microsoft 365 distribution groups](https://learn.microsoft.com/en-us/microsoft-365/admin/setup/create-distribution-lists?view=o365-worldwide#create-a-distribution-group-list) for each geographic region where you need to process your emails, before configuring your journal rule.
101+
102+
#### Configure journal rule
103+
104+
After creating the distribution groups based on regions for your users, configure your journal rule:
105+
106+
1. Log in to the [Microsoft Purview compliance portal](https://compliance.microsoft.com/homepage).
107+
108+
2. Go to **Data lifecycle management** > **Exchange (legacy)**.
109+
110+
3. Select **Settings** (the gear icon).
111+
112+
4. In **Send undeliverable journal reports to** enter the email address of a valid user account. Note that you cannot use a team or group address.
113+
114+
115+
5. Select **Save**.
116+
117+
6. Still in the Exchange (legacy) screen, select **Journal Rules**.
118+
119+
120+
7. Select **New rule** to configure a journaling rule, and configure it as follows:
121+
122+
* **Send journal reports to**: This address is specific to each customer tenant, and can be found in [Zero Trust](https://one.dash.cloudflare.com/) by going to:
123+
- **Email Security** > **Settings**.
124+
- Locate your domain under **Your domains**.
125+
- Select the three dots > **View domain** > **Service address**.
126+
If you need to process emails in certain geographic regions, refer to the [Geographic locations](#geographic-locations) table for more information on what address you should use.
127+
* **Journal Rule Name**: `Journal Messages to Cloudflare Email Security`
128+
* **Journal messages sent or received from**: *A specific user or group* and select the user group you [created above](#3-compliance).
129+
* **Type of message to journal**: *External messages only*
130+
131+
8. Select **Next**.
132+
133+
9. Verify the information is correct, and select **Submit** > **Done**.
134+
135+
Once saved, the rule is automatically active. However, it may take a few minutes for the configuration to propagate and start pushing messages to Email Security. After it propagates, you can access the Email Security dashboard to check the number of messages processed. This number will grow as journaled messages are sent to Email Security from your Exchange server.

‎src/content/partials/cloudflare-one/email-security/deployment/m365-gcc.mdx‎

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,8 @@
1+
---
2+
{}
3+
4+
---
5+
6+
:::note
7+
Email Security supports Microsoft 365 Government Community Cloud (GCC). Refer to Microsoft 365 Government Community Cloud for more information.
8+
:::

0 commit comments

Comments
 (0)