• Home
  • Integrations
  • SDKs
  • Guides
  • API docs
No results for ""
EXPAND ALL

GIVE DOCS FEEDBACK

OneLogin

Read time: 4 minutes
Last edited: Mar 01, 2024

Overview

This topic explains how to connect OneLogin to LaunchDarkly.

After you complete these procedures, you can use OneLogin to manage your LaunchDarkly account members, including configuring their roles and access.

Adding a LaunchDarkly SAML application

To add a LaunchDarkly SAML application to OneLogin:

  1. Log in to OneLogin.
  2. Navigate to Applications.
  3. Click the Add App button:
The "Administration" screen of OneLogin.
The "Administration" screen of OneLogin.
  1. Search for LaunchDarkly. The pre-configured app templates for LaunchDarkly appear.
  2. Choose the SAML 2.0, provisioning version of the LaunchDarkly app:
The LaunchDarkly search results.
The LaunchDarkly search results.
SAML 2.0 is required

Choose the SAML 2.0, provisioning app from the list of LaunchDarkly apps. If you choose another app, it will not work.

Configuring LaunchDarkly's security settings

To enable SAML with OneLogin, you must configure LaunchDarkly's security settings as well as the information OneLogin has about LaunchDarkly.

To configure LaunchDarkly's security settings for SAML:

  1. Navigate to the Account settings page.
  2. Click into the Security tab.
  3. In the "SSO management" section, click Edit SAML configuration. The "Edit your SAML configuration" panel appears.
  4. Enter configuration information from OneLogin in the appropriate fields.
  5. Copy the Assertion customer service URL to a secure place. You need it in order to configure OneLogin:
The "Set up your SAML configuration" panel.
The "Set up your SAML configuration" panel.

Configuring your LaunchDarkly app in OneLogin

In the SSO section of your LaunchDarkly application in OneLogin, you'll find the required values for the Sign-on URL as well as your X.509 certificate. You will need to input OneLogin's SAML 2.0 Endpoint (HTTP) value to the Sign-on URL field:

  1. Log in to OneLogin.
  2. Click Applications, then Applications.
  3. Choose the LaunchDarkly app from the list of apps.
  4. Navigate to the SSO section of your LaunchDarkly OneLogin application.
  5. Copy the OneLogin's SAML 2.0 Endpoint (HTTP) value to a secure place.
  6. Open LaunchDarkly in a separate tab. You need information from OneLogin to finish configuration:
The SSO section of LaunchDarkly.
The SSO section of LaunchDarkly.

Connecting LaunchDarkly to OneLogin

To connect LaunchDarkly to OneLogin:

  1. Log in to OneLogin.
  2. Click Applications, then Applications.
  3. Choose the LaunchDarkly app from the list of apps.
  4. Navigate to the Configuration section of your LaunchDarkly OneLogin application.
  5. Enter the Assertion customer service URL you saved from the Configuring LaunchDarkly's security settings procedure in the Consumer URL field:
The OneLogin Configuration screen.
The OneLogin Configuration screen.

Adding users and setting roles in OneLogin

Now that you have the LaunchDarkly application configured in OneLogin, all that remains is to add user access to the LaunchDarkly app.

To do this:

  1. Log in to OneLogin.
  2. Click Applications, then Applications.
  3. Choose the LaunchDarkly app from the list of apps.
  4. Navigate to the Users section of your LaunchDarkly OneLogin application.
  5. Click on the profile of the user you would like to add as an account member in LaunchDarkly.
  6. Click on that user's Applications section.
  7. Click the + in the top right corner.
  8. Choose LaunchDarkly from the list. The "Edit login" screen appears:
The "Edit login" screen.
The "Edit login" screen.
  1. (Optional) Configure the lastName and firstName fields with user information.
  2. Enter role information for the user. The supported roles are:
  • reader
  • writer
  • admin
  • no_access
  1. (Optional) If you are using a custom role, enter the custom role key in the customRole field. If a user has multiple custom roles, add them by entering the role keys for each role, separated by commas.
Enter all of the roles

When you are configuring a user in OneLogin, you must enter the complete list of the LaunchDarkly account member's roles, including the roles already present in LaunchDarkly. This list overrides what is in LaunchDarkly. It does not append to an existing list in LaunchDarkly. If you make any changes to the name or roles within OneLogin, they update the next time the account member accesses LaunchDarkly through the OneLogin portal.

  1. Click Save.

Now this account member can access the LaunchDarkly app through OneLogin.

If this is a new account member who has never accessed LaunchDarkly before, an account will be automatically created for them when they log in through the OneLogin portal.

Removing existing roles

SAML ignores empty fields if used in Roles or customRoles. To clear all existing roles, enter an empty string "" into the field.

User provisioning with SCIM

You can also configure OneLogin to provision users with LaunchDarkly's SCIM API.

Administrator Permissions and SSO are Required

You must be a LaunchDarkly administrator or account owner to complete this procedure. In addition, you must have already enabled SSO by following the procedure above.

To configure OneLogin to provision users:

  1. Log in to OneLogin.
  2. Click Applications, then Applications.
  3. Choose the LaunchDarkly app from the list of apps.
  4. Navigate to the Configuration section of your LaunchDarkly OneLogin application.
The OneLogin Configuration screen.
The OneLogin Configuration screen.
  1. Click Authenticate in the API Connection section. The LaunchDarkly OAuth workflow begins.
  2. Click the LaunchDarkly (SCIM Test) link. The LaunchDarkly OAuth authorization appears.
  3. Click Authorize to allow OneLogin to manage your LaunchDarkly account members:
The LaunchDarkly OAuth permissions screen.
The LaunchDarkly OAuth permissions screen.
  1. In OneLogin, navigate to the Provisioning tab.
  2. Confirm that the Enable Provisioning box is checked in the Workflow section.
  3. Click Save:
The Provisioning screen.
The Provisioning screen.

You have now successfully connected OneLogin with LaunchDarkly.