Oracle Cloud Infrastructure Documentation

Importing existing DKIM

Import existing DKIM keys to OCI and effortlessly migrate your email infrastructure without disruption, ensuring consistent email delivery and authentication. Ensure that the DKIM keys satisfy Oracle Cloud security requirements.

    1. Open the navigation menu  and select Developer Services. Under Application Integration, select Email Delivery. Under Email Delivery, select Email Domains.
    2. Click the name of the email domain where you want to configure DKIM.
    3. Click Import existing DKIM and click Next.
    4. In the DKIM Selector field, enter the DKIM selector name associated with the DKIM key you want to import. The DKIM selector can contain only up to 63 lowercase, alphanumeric characters (a-z, 0-9) with dashes.
    5. In the Add existing DKIM field, select one of the following options:
      • Copy paste the private key: Use this option to type or paste the private key.
      • Upload PEM file: Use this option to upload the PEM file that contains the private key.
    6. Click Next.
    7. Click Generate DKIM Record to generate the DKIM record. The system generates a CNAME record and value that can be used in your DNS setup for your email domain.
      Note

      For non-commercial realms, add the DKIM Text Record Value to your DNS setup.
    8. Copy the CNAME and CNAME Record Value and add it to your DNS setup.
      Note

      To add DNS records, the domain must be registered and available on the public Internet. DNS records must be added using the domain's registered DNS provider, which is the DNS system that the domain's name servers point to.
    9. Click Submit.

      Email Delivery supports a maximum of two DKIM keys per email domain. However, only one DKIM record can be active for your domain at a time. We recommend that you rotate your keys every six months.

  • Use the create command and required parameters to import an existing DKIM for an email domain.

    oci email dkim create --private-key

    For a complete list of parameters and values for CLI commands, see the CLI Command Reference.

  • For information about using the API and signing requests, see REST API documentation and Security Credentials. For information about SDKs, see SDKs and the CLI.

    Use the CreateDkim operation with privateKey parameter to import an existing DKIM record.

    For more information about managing DKIMs, see GetDkim, ListDkims, and UpdateDkim.