SAML Single Sign-On (SSO) with Okta is available only to Enterprise clients. If you want to enable SSO for your account, contact us at support@dataddo.com.
This guide walks you through configuring Okta for Single Sign-On (SSO) with Dataddo using SAML 2.0. Once connected, your users log in to Dataddo with their existing Okta credentials, with no separate password to manage, and you control access centrally in Okta.
The setup has five parts:
- Create a SAML app integration in Okta.
- Configure SAML settings and attributes.
- Upload the signing certificate to Dataddo.
- Create new SSO in Dataddo.
- Assign users and test.
- Optionally, add Dataddo to the Okta Dashboard.
Creating SAML App Integration
First, register Dataddo as an app integration in your Okta organization.
- Log in to the Okta Admin Console.
- Navigate to Applications → Applications.
- Click Create App Integration.
- Select SAML 2.0 and click Next.
- Give it a name (e.g.,
Dataddo SSO) and click Next.
SAML Configuration
General
In Configure SAML, set:
- Single sign-on URL:
https://public-api.dataddo.com/api/v2/saml-acs - Keep Use this for Recipient URL and Destination URL checked.
- Audience URI (SP Entity ID):
https://app.dataddo.com - Name ID format: EmailAddress
- Application username: Email
Click Show Advanced Settings and make sure that:
- Response is Signed.
- Assertion Signature is Signed.
- Signature Algorithm is RSA-SHA256.
Dataddo requires both the SAML response and the assertion to be signed with SHA-256, otherwise the login fails.
Attribute Statements
Tell Okta which user properties to send to Dataddo. In Attribute Statements, add:
| Name | Name format | Value | Description |
|---|---|---|---|
| Unspecified | user.email | Primary identifier (email) | |
| firstName | Unspecified | user.firstName | First name |
| lastName | Unspecified | user.lastName | Last name |
The attribute names must match exactly, including capitalization. If email is missing, Dataddo falls back to the Name ID.
Click Next, select I'm an Okta customer adding an internal app, and click Finish.
Configuring Certificate
Okta signs every SAML response with a certificate. Dataddo uses the same certificate to verify that the login really came from your Okta organization and was not tampered with.
In Okta
- Open your app integration and go to the Sign On tab.
- In the SAML Signing Certificates section, find the active certificate.
- Click Actions → Download certificate and save the file.
In Dataddo
- In Dataddo, go to Settings → Security.
- Select the Certificates tab.
- Click New Certificate and select the Upload Certificate tab.
- Upload the downloaded file as an x.509 certificate.
Create New SSO
In Okta
Collect two values you will need in Dataddo:
- Open your app integration, go to the Sign On tab and click View SAML setup instructions.
- Copy the Identity Provider Single Sign-On URL. It looks like
https://company.okta.com/app/company_dataddo_1/exk1a2b3c4d5e6f7g8h9/sso/saml. - From this URL, note:
- Okta domain: the host, e.g.,
company.okta.com. - App path: the part between
/app/and/sso/saml, e.g.,company_dataddo_1/exk1a2b3c4d5e6f7g8h9.
- Okta domain: the host, e.g.,
In Dataddo
- Go to Settings → SSO Providers.
- Click Create Provider.
- Fill in the New SSO Provider form:
- Provider: select Okta SAML.
- Name: any name to identify the provider (e.g.,
Okta). - Okta domain: paste your Okta domain, without
https://. - App path: paste the App path.
- Signing certificate: select the certificate you uploaded in Configuring Certificate.
- Click Create.
The provider now appears in the SSO Providers list with its Name, Domain and URL. The URL looks like https://app.dataddo.com/o-auth-login/okta_saml/<DATADDO_SSO_ID>.
Finishing the Setup
Assign Users
- In Okta, open your app integration and go to the Assignments tab.
- Click Assign → Assign to People or Assign to Groups and assign the users who should access Dataddo.
Log In and Test
- In the SSO Providers list in Dataddo, copy the URL of the provider you created.
- Share this URL with your users. Opening it redirects them to Okta and, after a successful login, back to Dataddo.
- Open the URL in a private browser window and log in with an assigned Okta user to test the connection.
Adding Dataddo to the Okta Dashboard
Dataddo accepts only logins that start from the Dataddo URL. The tile of the SAML app integration in the Okta End-User Dashboard sends users to Dataddo without this start, so the login fails. To give your users a working Dataddo tile, hide the SAML app tile and add a Bookmark app instead.
Hide the SAML App Tile
- In the Okta Admin Console, open your Dataddo SAML app integration and go to the General tab.
- In App Settings, click Edit.
- Under Application visibility, check Do not display application icon to users and click Save.
Add a Bookmark App
- Go to Applications → Applications and click Browse App Catalog.
- Search for Bookmark App and click Add Integration.
- Set:
- Application label: e.g.,
Dataddo. - URL: the URL of your provider from the SSO Providers list in Dataddo.
- Application label: e.g.,
- Click Done.
- In the Assignments tab, assign the same users or groups as in the SAML app integration.
Your users now see a Dataddo tile in the Okta End-User Dashboard. Clicking it opens the Dataddo URL, which signs them in through Okta.