We are excited to announce new features which help new users onboard and learn about Oracle Cloud Infrastructure (OCI) Email Delivery service and better reach customers. Now, you can use the DKIM (DomainKeys Identified Mail)  import feature to quickly migrate existing authentication keys.

Bring your own DKIM key

DKIM is an important part of email authentication, because it tells receiving mail servers and mailbox providers that the email is sent by an approved sender of the email domain. As an alternative to Creating a DKIM Record in OCI, you can instead configure DKIM authentication by importing your existing DKIM key from another source or system. 

You can read more about how to import and re-use existing DKIM authentication keys here. Let us walk through the four steps when migrating existing DKIM keys:

1). Open the navigation menu in the Oracle cloud console and select Developer Services. Under Application Integration, select Email Delivery. Under Email Delivery, select Email Domains.  Choose the email domain which you will configure DKIM, and select the greyed Add DKIM button. 

‘Add DKIM’ dialog now supports importing an existing DKIM record into OCI
Figure 1. Configure DKIM, and select the greyed Add DKIM button.

2). The ‘Add DKIM’ dialog now supports importing an existing DKIM record into OCI. 

Console now provides an option to either import a DKIM or create a new DKIM
Figure 2. Console now provides an option to either import a DKIM or create a new DKIM

3). The DKIM credential can be added by copying and pasting the private key or uploading a PEM (Privacy Enhanced Mail) file.  

Selecting a DKIM Credential to import
Figure 3. Selecting a DKIM Credential to import

4)  After navigating the dialog, the DKIM is added as a resource under the Email Domain. Under the DKIM details view, the DKIM signing status will move from Inactive to Active. Every email sent will contain headers which recipient inboxes can use to verify the authenticity of your email.

Automate with your Preferred Programming Language

The software development kits (SDKs) and OCI command line interface (CLI) now support the CreateDKIM API for DKIM migration. You can now automate all actions to migrate DKIM credentials from the Oracle Cloud Console. You can also use your preferred programming language from the supported languages of Python, Java, .NET, Go, TypeScript, Ruby, and PowerShell.

For more information on the CLI and SDK capabilities, view the email delivery API documentation for details on importing existing DKIM, and the OCI Developer Guide. Use the CreateDkim API operation with privateKey parameter to import an existing DKIM record.

Oracle Guided Learning

If you are migrating DKIM credentials to OCI, you are likely new to OCI Email Delivery configuration. Email Delivery with Oracle Guided Learning (OGL) has implemented a guided tour, with six steps to assist you with the most important factors to setting up successful email sending on OCI. The OGL tour appears once per day and can be accessed on demand using the question mark icon to the right of the Configuration header. 

  1. Create user and group
  2. Create email sending domain
  3. Configure SPF (Sender Policy Framework) and DKIM
  4. Create approved sender
  5. Set up permissions
  6. Send email
Welcome to Email Delivery service tour
Figure 4. Welcome to Email Delivery service tour

Step 3 helps with configuration of SPF and DKIM authentication. 

Step 3 assists with Configuration of SPF and DKIM
Figure 5. Step 3 assists with Configuration of SPF and DKIM

Try out the tour today, and let us know what worked well for you. 

Get Started Today

To learn more about Oracle Cloud Infrastructure Email Delivery, see the following resources:

Setting up an Email Domain with DKIM

Importing Existing DKIM

Overview of OCI Email Delivery

Getting started with OCI Email Delivery

OCI Email Delivery best practices