Configure SAML with Okta as identity provider

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

Before you begin, read Configure SSO with an Identity provider connection.

Get the Identity Provider data from Nintex CE Platform

  1. In the Identity provider connections page in Nintex CE Platform, click Add connection.
  2. In the Add connection panel, select Okta as the identity provider.
  3. Additional fields appear for the following:

    • Audience URI (SP Entity ID)
    • Single sign on URL
    • Attribute Statements

    Note: You will later need to copy and insert these values in specific fields in Okta.

  4. Keep your Nintex CE Platform browser open and go to Okta.

Add Nintex CE Platform to Okta

Sign in to Okta as an administrator and complete the following steps:

  1. Add Nintex CE Platform as an application or service provider for SAML.
  2. Copy the Audience URI (SP Entity ID) and Single sign on URL values, and the attribute statements from Nintex CE Platform, and then paste them in the corresponding fields in Okta.
  3. Note: Map the three identity attributes: First name, Last name, and Email.

  4. Retrieve the SAML metadata URL or file. Copy the metadata URL, and paste it in the URL field of Nintex CE Platform's setup wizard.

Caution: After adding Nintex CE Platform as a SAML application to your identity provider, make sure that users exist in the directory of your identity provider. Depending on the identity provider, an empty directory may cause SAML configuration to fail. For information on how to manage user accounts, refer to your identity provider's documentation.

Complete the SAML configuration

Note: 
  • Make sure that you have provided the metadata URL or file in Nintex CE Platform's setup wizard.
  • Make sure that your domain is successfully verified.

Follow these steps to complete the SAML configuration:

  1. In the Connect page of the setup wizard in Nintex CE Platform, click Connect.
  2. Note: The Connect button is enabled only when your domain is successfully verified and you have provided the metadata URL or file.

    After connecting, your SAML configurations are checked. If successful, the setup wizard goes to the final page with the following information:

    Information Description
    Expiry date of certificate Date when your certificate expires.
    Recipient email address of the reminder for certificate expiry

    When your certificate is expiring soon, a reminder email will be sent to the recipient email address.

    Caution: You must renew the certificate before the expiry date.

    One-Time Password (OTP) URL

    The One-Time Password (OTP) URL is used for troubleshooting purposes when configuration fails and you are locked out of your tenant.

    Follow these steps to access your tenant when you cannot sign in due to a failed configuration of SAML:

    1. To copy the One-time password URL, click (Copy) next to the One-time password URL field.
    2. Open a new tab on your web browser, paste the copied URL and press ENTER.
    3. Enter your email address, and click Submit.
    4. For verification, a one-time password is sent to your email address. The one-time password expires after five minutes.

    5. Enter the one-time password you received, and click Sign in.
    6. You can access your Nintex CE Platform tenant and resume configuring your identity provider connection.

  1. Click Done.

    The Identity provider connection section now lists information about your SAML configuration such as provider, domain, person who completed the configuration, and the date of configuration.

Test your SAML connection

  1. Sign in to your Nintex CE Platform tenant.
  2. Click Sign in or press ENTER.
  3. You are taken to the login page of Okta.

  4. In Okta's login page, type your credentials, and then submit.
  5. If the SAML configuration is successful, you are granted access to the Nintex CE Platform tenant.