Skip to content

Commit f45edec

Browse files
committed
Update email-authentication-dkim-configure.md
Corrections per TR
1 parent 21c957d commit f45edec

File tree

1 file changed

+24
-20
lines changed

1 file changed

+24
-20
lines changed

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

Lines changed: 24 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -84,35 +84,40 @@ The rest of this article describes the DKIM CNAME records that you need to creat
8484
8585
## Syntax for DKIM CNAME records
8686

87-
> [!NOTE]
88-
> You 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.
89-
9087
DKIM is exhaustively described in [RFC 6376](https://datatracker.ietf.org/doc/html/rfc6376).
9188

89+
In Microsoft 365, two public-private key pairs are generated when DKIM signing using a custom domain or subdomain is enabled. The private keys that are used to sign the message are inaccessible. The CNAME records point to the corresponding public keys that are used to verify the DKIM signature. These records are known as _selectors_.
90+
91+
- Only one selector is active and used when DKIM signing using a custom domain is enabled.
92+
- The other selector is inactive. It's activated and used only after any future [DKIM key rotation](#rotate-dkim-keys), and then only after the original selector is deactivated.
93+
94+
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`).
95+
96+
> [!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.
98+
9299
The basic syntax of the DKIM CNAME records for custom domains that send mail from Microsoft 365 is:
93100

94101
```text
95102
Hostname: selector1._domainkey
96-
Points to address or value: selector1-<CustomDomain>._domainkey.<InitialDomainPrefix>.<DynamicPartitionCharacter>-v1.dkim.mail.microsoft
103+
Points to address or value: selector1-<CustomDomainWithDashes>._domainkey.<InitialDomainPrefix>.<DynamicPartitionCharacter>-v1.dkim.mail.microsoft
97104
98105
Hostname: selector2._domainkey
99-
Points to address or value: selector2-<CustomDomain>._domainkey.<InitialDomainPrefix>.<DynamicPartitionCharacter>-v1.dkim.mail.microsoft
106+
Points to address or value: selector2-<CustomDomainWithDashes>._domainkey.<InitialDomainPrefix>.<DynamicPartitionCharacter>-v1.dkim.mail.microsoft
100107
```
101108

102-
- In Microsoft 365, two public-private key pairs are generated when DKIM signing using a custom domain or subdomain is enabled. The private keys that are used to sign the message are inaccessible. The CNAME records point to the corresponding public keys that are used to verify the DKIM signature. These records are known as _selectors_.
103-
- Only one selector is active and used when DKIM signing using a custom domain is enabled.
104-
- The other selector is inactive. It's activated and used only after any future [DKIM key rotation](#rotate-dkim-keys), and then only after the original selector is deactivated.
105-
106-
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`).
107-
108109
- **Hostname**: The values are the same for all Microsoft 365 organizations: `selector1._domainkey` and `selector2._domainkey`.
109110

110-
- **\<CustomDomain\>**: 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`.
111+
- **\<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`.
111112

112-
- **\<InitialDomainPrefix\>**: The custom part of the \*.onmicrosoft.com you used when you enrolled in Microsoft 365. For example, if you used `contoso.onmicrosoft.com`, the value is `contoso`.
113+
- **\<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`.
113114

114115
- **\<DynamicPartitionCharacter\>**: A dynamically generated character.
115116

117+
- **v1**: The current CNAME format version that's used for both selectors.
118+
119+
- **dkim.mail.microsoft**: The parent DNS zone.
120+
116121
For example, your organization has the following domains in Microsoft 365:
117122

118123
- **Initial domain**: cohovineyardandwinery.onmicrosoft.com
@@ -177,19 +182,19 @@ Proceed if the domain satisfies these requirements.
177182
|Microsoft.Exchange.ManagementTasks.ValidationException|CNAME record does not
178183
exist for this config. Please publish the following two CNAME records first. Domain Name
179184
: contoso.com Host Name : selector1._domainkey Points to address or value: selector1-
180-
contoso-com._domainkey.contoso.onmicrosoft.com Host Name : selector2._domainkey
181-
Points to address or value: selector2-contoso-com._domainkey.contoso.onmicrosoft.com .
185+
contoso-com._domainkey.contoso.n-v1.dkim.mail.microsoft.com Host Name : selector2._domainkey
186+
Points to address or value: selector2-contoso-com._domainkey.contoso.n-v1.dkim.mail.microsoft .
182187
If you have already published the CNAME records, sync will take a few minutes to as
183188
many as 4 days based on your specific DNS. Return and retry this step later.
184189
```
185190

186191
Therefore, the CNAME records that you need to create in DNS for the contoso.com domain are:
187192

188193
**Hostname**: `selector1._domainkey`<br>
189-
**Points to address or value**: `selector1-contoso-com._domainkey.contoso.onmicrosoft.com`
194+
**Points to address or value**: `selector1-contoso-com._domainkey.contoso.n-v1.dkim.mail.microsoft`
190195

191196
**Hostname**: `selector2._domainkey`<br>
192-
**Points to address or value**: `selector2-contoso-com._domainkey.contoso.onmicrosoft.com`
197+
**Points to address or value**: `selector2-contoso-com._domainkey.contoso.n-v1.dkim.mail.microsoft`
193198

194199
Copy the information from the error dialog (select the text and press CTRL+C), and then select **OK**.
195200

@@ -304,7 +309,6 @@ If you'd rather use PowerShell to enable DKIM signing of outbound messages using
304309
- 1024 (default)
305310
- 2048
306311
307-
308312
For example:
309313
310314
```powershell
@@ -330,10 +334,10 @@ If you'd rather use PowerShell to enable DKIM signing of outbound messages using
330334
For example:
331335
332336
**Hostname**: `selector1._domainkey`<br>
333-
**Points to address or value**: `selector1-contoso-com._domainkey.contoso.onmicrosoft.com`
337+
**Points to address or value**: `selector1-contoso-com._domainkey.contoso.n-v1.dkim.mail.microsoft`
334338
335339
**Hostname**: `selector2._domainkey`<br>
336-
**Points to address or value**: `selector2-contoso-com._domainkey.contoso.onmicrosoft.com`
340+
**Points to address or value**: `selector2-contoso-com._domainkey.contoso.n-v1.dkim.mail.microsoft`
337341
338342
4. Do one of the following steps:
339343

0 commit comments

Comments
 (0)