Chapter 7. Configure Email Domain

Emails sent from the 3scale system to developers on your behalf are distributed by SendGrid. The configurations guidelines in this section allow the emails to come from one of your domains rather than from 3scale.

This feature is not available on Personal plan accounts.

After you have the email setup configured on your side, open a support case on the Red Hat Customer Portal to complete the process. Just as for SSL certificates, we recommend you complete these steps as soon as possible.

Email configuration flow diagram

7.1. Step 1: Configure email domain

  1. Add a domain that is a CNAME to SendGrid. (Choose anything you like for the APIMAIL.YOURDOMAIN subdomain):

    APIMAIL.YOURDOMAIN.com CNAME u11705.wl206.sendgrid.net
  2. Add the following TXT record to APIMAIL.YOURDOMAIN.com:

    APIMAIL.YOURDOMAIN.com TXT v=spf1 include:u11705.wl206.sendgrid.net -all

    Or add the following line to an existing record:

    include:u11705.wl206.sendgrid.net
  3. Add the domain keys to ensure email deliverability:

    s1._domainkey.YOURDOMAIN.com CNAME s1.domainkey.u11705.wl206.sendgrid.net
    s2._domainkey.YOURDOMAIN.com CNAME s2.domainkey.u11705.wl206.sendgrid.net
    o1.APIMAIL.YOURDOMAIN.com A 167.89.103.115

7.2. Step 2: Verify your DNS changes

Use the following DIG statements from the command line to verify that your DNS changes are correctly implemented:

  dig cname APIMAIL.YOURDOMAIN.com
  # should return "u11705.wl206.sendgrid.net"

  dig cname s1._domainkey.YOURDOMAIN.com
  # should return "s1.domainkey.u11705.wl206.sendgrid.net"

  dig cname s2._domainkey.YOURDOMAIN.com
  # should return "s2.domainkey.u11705.wl206.sendgrid.net"

  dig a o1.APIMAIL.YOURDOMAIN.com
  # should return "167.89.103.115"

  dig txt APIMAIL.YOURDOMAIN.com
  # should return "v=spf1 include:u11705.wl206.sendgrid.net -all"

7.3. Step 3: Inform Support to finalize the email domain change

As the final step, inform support to initiate the email change with the following information:

  • Desired email address for outbound mail. The email address should be in the form of apicontact@YOURDOMAIN.com.
  • Entry that you used for APIMAIL.YOURDOMAIN.
  • Full company address (including country).
  • Contact phone number.