PingOne

Setting up a trusted email domain

You can configure PingOne to send email on your organization’s behalf from a trusted domain. Use PingOne to configure and verify the required DomainKeys Identified Mail (DKIM) setting, retrieve the email domain trust records, and add them to your DNS configuration. You can also add Sender Policy Framework (SPF).

Before you begin

You’ll need:

  • An existing domain

  • Access to your DNS manager

  • You can configure up to 50 trusted email domains per environment. Learn more in PingOne standard platform limits.

  • Learn more about configuring trusted email addresses for a trusted email domain in Configure trusted email addresses.

  • The _pingoneemail text record on the Domain Ownership tab is optional, but it’s best to add this record to your DNS. If it isn’t added, each sender email address you add must be verified separately through a verification email.

Adding the trusted email domain

Add the trusted email domain to your environment and then configure your DNS manager.

Steps

  1. In the PingOne admin console, go to Settings > Domains.

    Result:

    The Custom Domain and Email Trust page opens.

  2. Next to Email Trust, click the icon.

  3. In the Add Email Trust panel, enter the trusted Email Domain name, such as auth.example.com, and click Save.

    PingOne validates the domain name to ensure that it isn’t already in use.

Setting up and verifying DKIM

After you add the trusted email domain, configure and verify DKIM. DKIM is required to authenticate messages sent from the domain and help prevent sender-address forgery. It also improves email deliverability.

Steps

  1. In the PingOne admin console, go to Settings > Domains.

    Result:

    The Custom Domain and Email Trust page opens.

  2. Click the appropriate email domain name entry.

  3. On the DKIM tab, copy the CNAME records.

    If you see multiple AWS regions listed, such as EU-WEST-1, US-EAST-1, US-WEST-1, you should copy the CNAME records for all regions. This is required for Simple Email Service (SES) to sign messages, and can also allow messages to be sent from another AWS region if there’s a fault in the primary AWS region.

  4. Go to your DNS manager and update it with the CNAME records you copied. Ensure that you add the records as CNAME records, not TXT records. You can leave the PingOne window open, or close it and return later.

  5. After the DKIM changes propagate, on the DKIM tab, click Verify.

    DNS changes can take from an hour and up to 24 hours to propagate through the internet.

    • A green checkmark indicates that the verification check completed successfully.

    • A red exclamation point indicates that the verification check failed. Check that the CNAME records were added correctly, wait 1 hour and try again.

Verifying domain ownership by adding the TXT records to your DNS configuration

After you’ve set up and verified DKIM, add the TXT record shown on the Domain Ownership tab to your DNS configuration. This record verifies domain ownership.

Steps

  1. In the PingOne admin console, go to Settings > Domains.

    Result:

    The Custom Domain and Email Trust page opens.

  2. Click the appropriate email domain name entry.

  3. On the Domain Ownership tab, copy the TXT Record to a secure location.

  4. Go to your DNS manager and update it with the email domain entry you copied. You can leave the PingOne window open, or close it and return later.

    The specifics of DNS configuration depend on your DNS manager. You should wait at least 1 hour for the DNS changes to propagate through the internet, although it can take up to 24 hours.

  5. After you add the DNS record, return to the PingOne admin console to verify the email domain.

    DNS changes can take from an hour and up to 24 hours to propagate through the internet.

  6. Click the appropriate email domain name entry.

  7. On the Domain Ownership tab, click Verify.

    • A green checkmark indicates that the verification check has completed successfully.

    • A red exclamation point indicates that the verification check failed. Check that the TXT record was added correctly, wait 1 hour and try again.

Setting up SPF and a custom MAIL FROM domain

Setting up SPF adds protection against spam, spoofing, and phishing. By adding an SPF record to your DNS, you can specify a list of senders approved to send email from your domain.

By setting up a custom MAIL FROM domain, you significantly reduce the likelihood of a PingOne email notification being flagged as spam. Specifying a MAIL FROM domain results in SPF alignment with the FROM header, reducing the chances that the DMARC check will fail.

Steps

  1. In the PingOne admin console, go to Settings > Domains.

    Result:

    The Custom Domain and Email Trust page opens.

  2. Click the appropriate email domain name entry.

  3. Go to the SPF tab.

  4. In the Custom MAIL FROM domain field, enter a subdomain name to use.

    • If the field is grayed out, go to the Overview tab and check that all the TXT records appear as verified (green check mark).

    • Do not use a subdomain that you use to send email from.

    • Do not use a subdomain that you use to receive email.

  5. Click Save.

    Result:

    An MX record is displayed, and a TXT record for SPF is displayed.

  6. Add the MX record to your DNS.

  7. Add the TXT record for SPF to your DNS.

  8. After adding the MX record and the TXT record, you can return to the SPF tab and click Verify to verify the records you added. Keep in mind that propagation might take some time.