Skip to content

Commit 8d00532

Browse files
authored
Merge pull request #4336 from MicrosoftDocs/chrisda
Update email-authentication-dkim-configure.md
2 parents 375f17e + 6061b2b commit 8d00532

File tree

1 file changed

+22
-6
lines changed

1 file changed

+22
-6
lines changed

defender-office-365/email-authentication-dkim-configure.md

Lines changed: 22 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ f1.keywords:
55
ms.author: chrisda
66
author: chrisda
77
manager: deniseb
8-
ms.date: 04/14/2025
8+
ms.date: 06/19/2025
99
audience: ITPro
1010
ms.topic: how-to
1111

@@ -94,7 +94,7 @@ In Microsoft 365, two public-private key pairs are generated when DKIM signing u
9494
The selector that's used to verify the DKIM signature (which infers the private key that was used to sign the message) is stored in the **s=** value in the **DKIM-Signature** header field (for example, `s=selector1-contoso-com`).
9595

9696
> [!IMPORTANT]
97-
> Use the Defender portal or Exchange Online PowerShell to view the required CNAME values for DKIM signing of outbound messages using a custom domain. The values presented here are for illustration only. To get the required values for your custom domains or subdomains, use the procedures later in this article.
97+
> Use the Defender portal or Exchange Online PowerShell to view the required CNAME values for DKIM signing of outbound messages using a custom domain. **The values presented here are for illustration only**. To get the required values for your custom domains or subdomains, use the procedures later in this article.
9898
9999
The basic syntax of the DKIM CNAME records for custom domains that send mail from Microsoft 365 is:
100100

@@ -109,7 +109,23 @@ Points to address or value: selector2-<CustomDomainWithDashes>._domainkey.<Initi
109109
- **Hostname**: The values are the same for all Microsoft 365 organizations: `selector1._domainkey` and `selector2._domainkey`.
110110
- **\<CustomDomainWithDashes\>**: The custom domain or subdomain with periods replaced by dashes. For example, `contoso.com` becomes `contoso-com`, or `marketing.contoso.com` becomes `marketing-contoso-com`.
111111
- **\<InitialDomainPrefix\>**: The custom part of the \*.onmicrosoft.com you used to enroll in Microsoft 365. For example, if you used `contoso.onmicrosoft.com`, the value is `contoso`.
112-
- **\<DynamicPartitionCharacter\>**: A dynamically generated character that's used for both selectors.
112+
- **\<DynamicPartitionCharacter\>**: A dynamically generated character that's used for both selectors (for example, r or n). The value is automatically assigned by Microsoft when you add a new custom domain and enable DKIM. The value is determined by Microsoft's internal routing logic and isn't configurable.
113+
- This value is part of the updated DKIM record format for new custom domains in Microsoft 365 introduced in May 2025. Existing custom domains and initial domains continue to use the old DKIM format:
114+
115+
```text
116+
Hostname: selector1._domainkey
117+
Points to address or value: selector1-contoso-com._domainkey.contoso.onmicrosoft.com
118+
119+
Hostname: selector2._domainkey
120+
Points to address or value: selector2-contoso-com._domainkey.contoso.onmicrosoft.com
121+
```
122+
123+
- **The old and new and old formats can't coexist for the same selector**. To retrieve the correct DKIM CNAME values for a domain, including the assigned \<DynamicPartitionCharacter\> value, replace contoso.com with the domain value, and then run the following command in [Exchange Online PowerShell](/powershell/exchange/connect-to-exchange-online-powershell):
124+
125+
```powershell
126+
Get-DkimSigningConfig -Identity contoso.com | Format-List Name,Enabled,Status,Selector1CNAME,Selector2CNAME
127+
```
128+
113129
- **v1**: The current CNAME format version that's used for both selectors.
114130
- **dkim.mail.microsoft**: The parent DNS zone that's the same for both selectors.
115131
@@ -120,15 +136,15 @@ For example, your organization has the following domains in Microsoft 365:
120136
121137
You need to create two CNAME records in DNS in each custom domain, for a total of four CNAME records:
122138
123-
- **CNAME records in the cohovineyard.com domain**:
139+
- <u>CNAME records in the cohovineyard.com domain</u>:
124140
125141
**Hostname**: `selector1._domainkey`<br>
126142
**Points to address or value**: `selector1-cohovineyard-com._domainkey.cohovineyardandwinery.n-v1.dkim.mail.microsoft`
127143
128144
**Hostname**: `selector2._domainkey`<br>
129145
**Points to address or value**: `selector2-cohovineyard-com._domainkey.cohovineyardandwinery.n-v1.dkim.mail.microsoft`
130146
131-
- **CNAME records in the cohowinery.com domain**:
147+
- <u>CNAME records in the cohowinery.com domain</u>:
132148
133149
**Hostname**: `selector1._domainkey`<br>
134150
**Points to address or value**: `selector1-cohowinery-com._domainkey.cohovineyardandwinery.r-v1.dkim.mail.microsoft`
@@ -201,7 +217,7 @@ Proceed if the domain satisfies these requirements.
201217

202218
It takes a few minutes (or possibly longer) for Microsoft 365 to detect the new CNAME records that you created.
203219

204-
7. After a while, return to the domain properties flout that you left open in Step 5, and select the **Sign messages for this domain with DKIM signatures** toggle.
220+
7. After a while, return to the domain properties flyout that you left open in Step 5, and select the **Sign messages for this domain with DKIM signatures** toggle.
205221

206222
After a few seconds, the following dialog opens:
207223

0 commit comments

Comments
 (0)