Setting up OneLogin SSO for Dagster+#

In this guide, you'll configure OneLogin to use single sign-on (SSO) with your Dagster+ organization.

Prerequisites#

To complete the steps in this guide, you'll need:

• The following in OneLogin:
  • An existing OneLogin account
  • Admin permissions
• To install the dagster-cloud CLI
• The following in Dagster+:
  • A Pro plan
  • Access to a user token
  • Organization Admin permissions in your organization

Step 1: Add the Dagster+ app in OneLogin#

1. Sign into your OneLogin portal.

2. Navigate to Administration > Applications.

3. On the Applications page, click Add App.

4. On the Find Applications page, search for Dagster+:

   

5. Add and save the application.

Step 2: Configure SSO in OneLogin#

1. In OneLogin, open the application and navigate to its Configuration.

2. In the Dagster+ organisation name field, enter your Dagster+ organization name. This is used to route the SAML response to the correct Dagster+ subdomain.

   In the following example, the organization name is hooli and our Dagster+ domain is https://hooli.dagster.cloud. To configure this correctly, we'd enter hooli into the Subdomain field:

   

3. When finished, click Done.

Step 3: Upload the SAML metadata to Dagster+#

Next, you'll save and upload the application's SAML metadata to Dagster+. This will enable single sign-on.

1. In OneLogin, open the Dagster+ application.

2. Navigate to More Actions > SAML Metadata.

3. When prompted, save the file to your computer.

4. After you've downloaded the SAML metadata file, upload it to Dagster+ using the dagster-cloud CLI:

   dagster-cloud organization settings saml upload-identity-provider-metadata <path/to/metadata> \
     --api-token=<user_token> \
     --url https://<organization_name>.dagster.cloud
   

Step 4: Grant access to users#

Next, you'll assign users to the Dagster+ application in OneLogin. This will allow them to log in using their OneLogin credentials with the sign in flow is initiated.

1. In Okta, navigate to Users.

2. Select a user.

3. On the user's page, click Applications.

4. Assign the user to Dagster+. In the following image, we've assigned user Test D'Test to Dagster+:

   

5. Click Continue.

6. Click Save User.

7. Repeat steps 2-6 for every user you want to access Dagster+.

Step 5: Test your SSO configuration#

Lastly, you'll test your SSO configuration:

• Service provider (SP)-initiated login
• Identity provider (idP)-initiated login

Testing a service provider-initiated login#

1. Navigate to your Dagster+ sign in page at https://<organization_name>.dagster.cloud

2. Click the Sign in with SSO button.

3. Initiate the login flow and address issues that arise, if any.

Testing an identity provider-initiated login#

In the OneLogin portal, click the Dagster+ icon:

If successful, you'll be automatically signed into your Dagster+ organization.