DKIM

DKIM (Domain Keys Identified Mail) is a technology that verifies the validity of the sender of the email (the domain of the from address) and the mail body. In DKIM the mail sender publishes their public DKIM key to their DNS. Then, the generated secret key pair is used to insert the DKIM signature into the email headers. The receiving mail server then makes a request to the DNS and looks for the public DKIM key and uses that to verify the DKIM signature.

Large companies like Google, Yahoo and other major ISPs implement the core technlogies of DKIM. With its use you can avoid the risk of phishing attacks where malicious senders attempt to fool unasuming users into giving away their usernames, passwords and confidential information. Furthermore, with DKIM technology it is possible to tell the difference between illegitamate and legimate senders.

Customers Mail Cloud provides a function to add a DKIM signature to emails sent via SMTP or the API. To do so, register the sender's domain in the management console and issue a DKIM key. Then, you can send a DKIM-signed email by publishing the public key to the your DNS.


Adding DKIM keys

Add the From address's domain that DKIM uses.

Issuing a DKIM key

  1. Log into management console and click the DKIM settings tab.

  2. Click the Add new domain button.

DKIM domain settings

  1. Input the domain and click the Save button.

The DKIM selector modal will then be displayed. From this modal you can copy the value and check the status of your DKIM record with the Confirm DNS button at the bottom right.

DKIM selector settings

Publishing the DKIM key onto a DNS

Publish the DKIM key issued by the management console on your DNS that manages the you, the sender's domain. We will use the Amazon Route 53 DNS service to illustrate an example in this section.

AWS Route 53 DKIM

Item    Value
Name Input the DKIM selector in the modal's record name. selector._domainkey
Type Select TXT - Text
Value Input the modal's record value of the DKIM selector.

Checking the DKIM key

Click the DNS confirmation button after you registered the DKIM key to the DNS. If the DNS lookup of the DKIM key is successful, the status of the selector will read DNS is registered.

If you want to verify a DNS at a later date because it takes time to register, please perform the following actions:
- Click the domain from the domain list in the menu on the left of the "DKIM settings" tab.
- Click the selector from "selector list".
- The "DKIM selector" modal will be displayed. Click the "Confirm DNS" button.

Reflecting the settings onto the mail server

This selector can be operated when the status of the selector is DNS is registered. To have the saved reflect settings on the email server follow these instructions.


Updating DKIM keys

The DKIM keys are created as 1024 bit RSA keys so that they fit into the DNS record size limit. For this reason, it is necessary to change the key from time to time. In Customers Mail Cloud, the recommended deadline will be displayed with it's default set to once a year.

Follow the steps below to exchange keys.


Adding new selectors

Click the domain you wish to add selectors to from the menu on the left in the DKIM settings tab.

Click the Add button above the selector list. The DKIM selector settings modal will be displayed.

DKIM settings

A selector will be automatically assigned.

Click the Save button.

DKIM selector modal will be displayed.

Click the Confirm DNS button once the DKIM key is published.

Once the selector status becomes DNS is registered, it will be possible to operate the new selector.


Changing the selector

Click the Server configuraion tab.

Click the server configuration link that operates the new selector.

Click the sender domain settings at the left menu of the server settings dialog box.

sender domain settings

The list of the registered DKIM domain will be displayed.

Click the domain you want to change. The Sender domain settings dialog box will be displayed.

sender domain settings dialog

Mark as checked the new selector and unmark the check for the old selector on DKIM settings.

Click the Save button.


Reflecting the settings to the mail server

Lastly, when you reflect this settings to the mail server, operation for the new selector will start.

Customers Mail Cloud will resend mail up to 24 hours. When changing selectors,there is a possibility that emails signed with the old selector and emails signed with the new selector may coexist. Please register both the old and new selector to the DNS. The old selector will not be affected even if it is deleted from DNS and more than one day has passed after changing the selector.

Deleting the DKIM key

If you change the DKIM key and the old selector is no longer needed or the sender domain itself is no longer needed,you can stop the operation of DKIM and delete the DKIM key by following the steps below.


Stopping the DKIM operation

Click the server composition tab.

Click the link of the server composition which stops the DKIM operation.

Click the sender domain settings at the left menu of server settings dialog.

Registered DKIM domain list will be displayed.

Click the target domain.

A list of available selectors will be displayed in the sender domain settings dialog. Unmark the check of the selector that stops the operation.

You can't stop the operation of the DKIM selector if you set the envelope from as "rewrite" at the "SPF settings" of the sender domain settings dialog.

click the "save" button.


Reflecting the settings to the mail server

Once you reflect this settings to the mail server, DKIM operation will stop. You can't add the DKIM signature to the send emails once you reflect the settings.


Deleting the DKIM key

You can replace the selector or delete the old selector that is no longer needed by following the steps below.

Click the DKIM settings tab on the management console.

Click the domain you want to operate from the domain list on the left menu.

Selector list will be displayed on the right.

Confirmation dialog will be displayed when you click the delete icon on the selector list.

Input the login password and click the delete button.

It is not possible to delete, If DKIM selector is in operation.

Deleting the domain

If the sender domain itself is no more needed, you can delete the domain that managed by DKIM settings by following the steps below.

Click the DKIM settings tab of the management console.

Confirmation dialog will be displayed when you click the delete icon at the domain list of the left menu.

Input the login password and click the delete button.

Domain and selectors that registered into this domain will be deleted.

It is not possible to delete, If the DKIM selector for the domain is in operation.