Create a DNS entry

This document covers step one of the Single sign-on (SSO) setup process, and shouldn't be completed independently.

For security and ownership verification, all domains associated with an SSO connection must have a DNS TXT entry added.

If your users span multiple domains and all are required to sign in using SSO, this process must be completed for each domain.

Note

This step must be completed before Matillion can start any configuration.

The specific steps to create a DNS entry vary by provider, but the following generic steps should be followed:

1. Sign in to your DNS provider, such as Cloudflare, Route 53, GoDaddy.
2. Open the DNS management page, look for a section labelled DNS, DNS Management, Zone Editor, or Advanced DNS Settings.

3. Add a new TXT record, use the following values:

   • Name/Host/: Enter @ to apply to the root domain.
   • Value: matillion:[domain]-sso replacing [domain] with your primary email domain, and converting any special characters to dashes. For instance example.com would become umatillion:example-com-sso.
   • TTL: If editable, use the default value or set it to 1 hour.

4. Save the record.

5. Continue the steps in Single sign-on (SSO) setup.

Got feedback or spotted something we can improve?

We'd love to hear from you. Join the conversation in the Documentation forum!