Supported Features:

Both SP-initiated and IdP-initiated SSO are supported

Below are the steps to configure Okta SSO in Dashworks.

Step 1: Setting up Dashworks App in Okta

  1. Go to Applications under Applications

Screenshot 2021-12-20 at 8.12.43 PM.png

  1. On the Applications page, select Browse App Catalog.

Screenshot 2021-12-20 at 8.12.57 PM.png

  1. Search for Dashworks App and add it

Screenshot 2021-12-20 at 8.21.54 PM.png

  1. Add an Application label and click Done

Screenshot 2021-12-20 at 8.24.21 PM.png

  1. User must specify the Initiate Login URI in the sign-on settings. In most cases this will be https://api.dashworks.ai/v1/google/auth-url?origin=web.dashworks.ai. For on-prem deployment, please contact [email protected] for the Initiate Login URI

    Screenshot 2022-02-18 at 12.13.09 PM.png

  2. Once the App is added, you will have to assign users to the app under the Assignments tab. This will enable to users to log into Dashworks app using Okta. To add users, navigate to the Assign to People option under Assign option on Assignments Page. If you already have a group you can choose the Assign to Groups option and assign the entire group.

    Screenshot 2021-12-20 at 8.31.21 PM.png

  3. You can add people by clicking the Assign option next to their name. After you have all the people click the Done button

    Screenshot 2021-12-20 at 8.33.27 PM.png

    Note: Make sure all the user profiles have these fields populated: Username, First Name, Last Name, Primary Email, Display Name. These fields are required to create profiles in dashworks. Below is a sample user profile with all required attributes.

    Screenshot 2022-01-05 at 8.36.24 PM.png

Step 2: Enabling SSO in Dashworks App

A prerequisite to enable the SSO is that the user should be an Admin in their Dashworks Organization.

  1. Log into Dashworks App and navigate to the Single sign-on tab under Admin Settings

    Screenshot 2021-12-20 at 8.41.14 PM.png

  2. You will require Client ID, Client Secret, and Issuer URL

    \

    Screenshot 2021-12-20 at 8.44.00 PM.png

    Issuer URL will be of the format https://your-company.okta.com for example https://dashworks.okta.com. You can get this from the Okta browser tab

    Screenshot 2021-12-20 at 9.05.24 PM.png

    Also if URL has -admin suffix for example https://your-company-admin.okta.com, just remove the suffix and only use https://your-company.okta.com( https:// is required )

    Fill in the Client ID, Client Secret, and Issuer URL and click Submit

    Screenshot 2021-12-20 at 9.09.12 PM.png

  3. On successfully applying the changes, you should see the following message.

Screenshot 2021-12-20 at 9.20.51 PM.png

In case, you see an error message, please contact [email protected]

Step 3: Log into Dashworks App using SSO

  1. After successfully creating SSO connection, logout from your account and log in again using Continue with SSO option

    Screenshot 2021-12-20 at 9.22.18 PM.png

  2. Type in your email in the Email or Username box and click next

    Screenshot 2022-01-05 at 4.27.57 PM.png

  3. If you are not already logged into your Okta account, you will be directed to the login page. Fill in your credentials and sign into the account. If you are already signed in you will directly sign in to your account as shown in the next step

Screenshot 2022-01-05 at 4.29.17 PM.png