Verify a domain for SAML configuration

  An administrator role is required. For information, see User roles.

Before you can configure SAML in your Nintex Automation Cloud tenant, you must first verify ownership of a domain that you're going to associate with your tenant. To verify a domain, you must create a record in your Domain Name System (DNS) host using a code that is provided in Nintex Automation Cloud's setup wizard for identity federation.

Caution: Depending on your DNS host, it may take up to 72 hours to process the domain verification. While the domain verification is not yet completed by the DNS, you can begin configuring SAML in Nintex Automation Cloud BUT you cannot submit the SAML configuration.

Follow these steps to verify a domain to be associated with your Nintex Automation Cloud tenant for SAML configuration:

1. Get the verification code from Nintex Automation Cloud
  1. Sign in to Nintex Automation Cloud as an administrator.
  2. From the main menu on the upper right, click Settings.
  3. From the left menu, click User Management. A new page appears showing the configuration fields for identity federation and user management.
  4. In the Identity federation section, click Configure. A setup wizard appears.
  5. Select SAML.
  6. Click Next. The next page appears where the domain verification code is available.
  7. To copy the code, click (Copy) next to the domain verification code. Use this code as a value in your new record in DNS. See the next section for the steps to add a new record in DNS.

2. Add a record in your DNS

Note: 
  • After you have copied the verification code from Nintex Automation Cloud's setup wizard, you can begin adding a new record in your DNS.
  • When adding a new record in DNS, you can use either TXT or MX as the record type. It is highly recommended to use the TXT type.

Below are the steps on how to add a record in your DNS. These steps are generic and do not target a specific brand of DNS hosting service. The names of fields and options may have different terminologies, but the purpose stays the same, which is to add a record.

  1. Log in to your DNS host as an administrator.
  2. Navigate to the settings page where you can add a new record for your domain.
  3. Select the option to add a record.
  4. See the following table for the values to enter for your DNS record. Your DNS provider may use different terminologies.
    FieldValue
    Record typeTXT
    ValuePaste the domain verification code you copied from Nintex Automation Cloud.
    Name/ Host/ AliasUse the default value, type @ (at) or leave it blank.
    Time to live (TTL)Type your required period of time, for example 1 hour or 86400 sec, depending on what your organization requires.
  1. Log in to your DNS host as an administrator.
  2. Navigate to the settings page where you can add a new record for your domain.
  3. Select the option to add a record.
  4. See the following table for the values to enter for your DNS record. Your DNS provider may use different terminologies.
    FieldValue
    Record typeMX
    Mail exchangePaste the domain verification code you copied from Nintex Automation Cloud
    NameLeave it blank.
    ServerType a value, depending on what your organization requires.
    MX Level or PreferenceType a required number, depending on what your organization requires.
    Time to live (TTL)Type your required period of time, for example 1 hour or 86400 sec, depending on what your organization requires.

Caution: Depending on your DNS host, it may take up to 72 hours to process the domain verification. While the domain verification is not yet completed by the DNS, you can begin configuring SAML in Nintex Automation Cloud BUT you cannot submit the SAML configuration.

3. Check if the domain verification is completed

After you have added the verification code in your DNS, you can periodically check if the verification is completed by DNS by going to the setup wizard of Nintex Automation Cloud.

In the Verify Domain page of Nintex Automation Cloud's wizard.

  1. From the blue warning message, click Verify now.
    • If the domain verification is completed by your DNS, a message appears in a green bar, notifying you that your domain is successfully verified. You can continue and submit your SAML configurations in Nintex Automation Cloud.
      • Verified domain
    • If the domain verification is not yet completed by DNS, the warning message remains in a blue bar where you can periodically click Verify now. You can continue SAML configuration BUT you cannot submit your configurations yet.
      • Verify Domain page
  2. Click Next. You can continue your SAML configuration.