Create a DNS entry

Note

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 matillion: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.