Mail Domains

This page is accessed via Business Process Automation > Power Data > Mail Management > Mail Domains.

This page lists all OCI email domains matching the your cloud account. You can manage your domains using this page. You can:

• See all the mail domains visible to this cloud account. This includes domains created by any cloud account in the organization. 
• Add a new mail domain. DKIM records for this domain will be automatically added.
• Remove a mail domain. All DKIM records must be fully deleted before a domain can be removed.
• Validate the mail domain.
• View the DKIM information. These are detail DKIM entries needed in the your DNS domain; either CNAME or TXT records.
• Add or remove DKIM records to be added and removed.
• View any custom Return Path information. This includes the CNAME record needed to register the Return Path in your DNS domain.
• Add or remove a custom Return Path.
   

When setting up mail domains, tasks should be processed in this order.

1. Add domain.
2. Add SPF.
3. Add DKIM.
4. Validate and make sure everything is OK.
5. Add a return path. 
6. Re-validate and make sure the return path is OK.

Take time between each stage and validate as you complete each section.

Managing Mail Domains

The columns on this page display:

• The mail domain itself.
• The OCI state of the domain.
• The date/time the domain was created.
• The owner/creator of the domain. This is currently "Account" as standard configuration only displays Mail Senders owned by this cloud account.

• The SPF column contains information about Sender Policy Framework (SPF) tests with the following results:

  • : SPF checks have passed for this email domain. 
  • : SPF validation has not been checked or SPF records do not exist for this email domain.
  • : SPF checks for this email domain are not passing. This is typically due to a soft or hard bounce.

• The DKIM column contains the results of a different mail security test, DomainKeys Identified Mail. The result indicators are similar to SPF:

  • : DKIM is active for this email domain and mail content will be signed.
  • : DKIM records do not exist or have not been checked for this email domain.
  • : DKIM exists but is incorrectly configured for this email domain. Mail content will not be signed.

• The Return Path column reflects the status of the return path when the domain was last validated.

  Note: the Return Path and DMARC columns are visible only when the SUPPORT RETURN PATH AND DMARC optional feature is opted in.

  • : The return path is active for this email domain and will be used for mail bounce-backs, SPF checks, and DMARC rules.
  • : The return path does not exist.
  • : The return path is not correctly configured. The default return path will be used.

• The DMARC column reflects the status of DMARC checks.

  Note: the Return Path and DMARC columns are visible only when the SUPPORT RETURN PATH AND DMARC optional feature is opted in.

  • : The DMARC DNS exists and passes alignment checks.
  • : The DMARC DNS record does not exist.
  • : The DMARC DNS exists and fails alignment checks.
• The Validated column shows the the date/time the domain was last validated.
• The Validate button refreshes the domain status values. This allows you to work on your DNS entries and recheck them from the Mail Domain screen much like you can from the Mail Sender or Mail Validation screens.
• The DKIM button displays the DKIM Entries for the mail domain. This contains the CNAME subdomain and value which you can use to populate your DNS server for DKIM. You can delete the DKIM entries individually by clicking Remove, or en masse, by clicking Remove All.

  Note: For a detailed overview of how to manage DKIM, see Configuring DKIM.

• The Return Path button displays any custom return path associated with the mail domain. This contains the CNAME subdomain and value which you can use to populate your DNS server properly for the return path. You can delete the custom return path by clicking Remove.

  Note: the Return Path button is visible only when the SUPPORT RETURN PATH AND DMARC optional feature is opted in.

  Note: For a detailed overview on how to manage a custom return path, see Configuring a Custom Return Path.

• The Remove buttons let you remove a domain if all of the DKIM entries and custom return path have been removed. To remove a domain, click the DKIM button and remove all the records there. Then click the Return Path button and remove any record there. Finally, return to this page and click the Remove button. There may be a delay while the DKIM records are removed.
• Use the Refresh button to refresh the page after you add a domain or make other changes.
• The Add button lets you define a new domain.

Adding a New Mail Domain

Note: Adding a domain may take a few minutes to be reflected on the Mail Domains page.

1. Enter a Mail Domain.
2. Enter an DKIM Selector Prefix. The DKIM Selector Prefix defaults to the domain name and uniquely defines the DKIM selector. You can explicitly set it to have a DKIM ID or CNAME subdomain name and value identified by your organization name. If omitted, DKIMs are based on each domain migrated. If specified, a single prefix is used across all migrated domains. For a detailed overview of how to manage DKIM, see Configuring DKIM.
3. Click Add.