Okta SAML SSO

Learn how to create a custom Okta SAML 2.0 application for Doppler Single Sign-On.

Requirements

  • Workplace domain verified (Settings page)
  • Okta Developer Account with access to create custom application integrations

1. Initial Doppler SAML SSO Configuration

Go to the Doppler dashboard and from the menu click Team, then select the Settings tab from the top menu. Choose the Default Roles for users who login via SSO.

πŸ“˜

The Role controls the initial permissions a user will receive when their account is created. We recommend keeping it at Collaborator access to follow the principle of least privilege. Users with the Owner role can adjust this after the user has logged in once. If you scroll down further on the Settings page, you'll see a breakdown of what permissions each Role has.

After setting the Default Roles, we need to enable SAML SSO in Doppler to get access to the URLs needed to configure the Okta SAML SSO application.

Select the SSO tab from the top menu and scroll down to the SAML Single Sign-On section. Choose a verified domain from the Email Domain dropdown menu and then click Save.

Copy the ACS URL and Entity ID URLs to use when configuring the Okta SAML SSO application.

2. Create SAML Application

In a separate window, browse to your Okta dashboard and select Applications from the main menu, then click the Create App Integration button.

Select SAML 2.0 as the sign-in method and then click Next.

Then name the application and optionally upload the Doppler logo.

Click the Next button to proceed to the SAML Settings page.

3. Okta SAML Configuration

Populate the form with the URLs obtained from the Doppler SAML Single Sign-On setup page in Step 1 above. They will look similar to the following:

❗️

These are example URLs only and will not work in your setup. You need to use the URLs obtained from the Doppler SAML Single Sign-On setup page referenced in Step 1 above.

Set the Name ID format to EmailAddress, Application username to Email and check that Update application username on is set to Create and update.

Then scroll to the Attribute Statements section and create a name custom attribute.

Finally, scroll down to the bottom of the page and click the Next button.

Mark the app as an internal application, then click the Finish button to complete the creation of the SAML 2.0 application.

Click the Sign On tab for the Doppler application in Okta, then scroll down and click on the View SAML setup instructions button which will open a new tab.

Scroll down to IDP metadata field and ensure you've selected the entire XML content (not just the first line), then copy the contents which you'll use next in the Doppler dashboard.

4. Update Doppler SAML SSO Configuration

Navigate to the Doppler Team page and click on the SSO tab.

Scroll down to the SAML Single Sign-On section and paste in the XML metadata. Check the Enable field, then click the Save button.

You're now ready to test the Okta application!

5. Testing

As an Okta administrator, it's presumed you'll know how to sufficiently test a new Okta application, but here is a general guide.

πŸ“˜

Test sign-in flow using incognito window

Be sure to stay signed in to the Doppler dashboard until you've verified the Okta sign-in flow from an incognito window.

Staying signed in to the dashboard will allow you to update the SAML settings or disable SAML SSO in the event of misconfiguration.

Click on the Assignments tab for the Doppler application and assign either a test account (recommended) or your own account to the Doppler application.

Now test the Doppler SAML sign-in flow by opening an incognito window and sign-in to Okta using the assigned user from the previous step.

Click on the Doppler application to initiate the sign-in process.

You should then be redirected to the Doppler dashboard for the assigned user.

Once you've verified the Doppler SAML application is configured correctly, you can then apply your standard organization policies for people and groups assignment.

Troubleshooting

Here are some general troubleshooting tips:

  • Double-check that the Single sign in URL and Audience URI values match exactly what is displayed in the Doppler SAML section.
  • Check that the Name ID format and Application username values are correct.
  • Ensure that the name attribute has been added to the Attribute Statements section.

If you're still running into issues, the error page should present you with a requestId value that can be used by our support team for further diagnosis.

πŸ‘

Awesome Work!

Your custom Okta Doppler SAML 2.0 application is now set up!


Did this page help you?