Setting up PingOne SSO for Dagster+#

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

Prerequisites#

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

• The following in PingOne:
  • An existing PingOne account
  • Organization 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 PingOne#

1. Sign into your PingOne Console.

2. Using the sidebar, click Connections > Applications.

   

3. On the Applications page, add an application.

4. In Select an application type, click Web app.

5. Click SAML > Configure:

   

Step 2: Configure SSO in PingOne#

1. In the Create App Profile page:

   1. Add an application name, description, and icon:

      

   2. When finished, click Save and Continue.

2. In the Configure SAML page:

   1. Fill in the following:

      • ACS URLS and Entity ID: Copy and paste the following URL, replacing <organization_name> with your Dagster+ organization name:

        https://<organization_name>.dagster.cloud/auth/saml/consume
        

      • Assertion Validity Duration: Type 60.

      In the following example, the organization’s name is hooli and the Dagster+ domain is https://hooli.dagster.cloud:

      

   2. When finished, click Save and Continue.

3. In the Map Attributes page:

   1. Configure the following attributes:

      Application attribute	Outgoing value
      Email	Email Address
      FirstName	Given Name
      LastName	Family Name

      The page should look similar to the following:

      

   2. When finished, click Save and Continue.

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 PingOne, open the Dagster+ application.

2. Click the Configuration tab.

3. In the Connection Details section, click Download Metadata:

   

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

5. 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 PingOne. This will allow them to log in using their PingOne credentials when the single sign-on flow is initiated.

1. In the Dagster+ application, click the Access tab.

2. Click the pencil icon to edit the Group membership policy:

   

3. Edit the policy as needed to grant users access to the application.

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 PingOne application portal, click the Dagster+ icon:

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