Skip to main content
With the LaunchDarkly integration, you can manage access to your LaunchDarkly account from Opal:
  • Allow users to request just-in-time access to an account role, such as Writer, from the web and Slack
  • Allow users to request membership of a LaunchDarkly team
  • Give a team a custom role, so every member of the team holds it
  • Review account roles, team membership, and custom roles in access reviews
  • Automatically revoke access when a time-bound grant expires
Opal connects to one LaunchDarkly account through a service token. To manage several accounts, add a LaunchDarkly app in Opal for each one.

Supported resources

Opal syncs the members of your account, matched to people in Opal by email. The integration doesn’t invite or remove members, which arrive through SSO or your identity provider, and it doesn’t sync pending invitations until they’re accepted.

How LaunchDarkly access maps to Opal

  • Account roles: your account appears in Opal as LaunchDarkly Organization, with the access levels Reader, Writer, Admin, and Owner. Each member holds one account role, so requesting a different role replaces the existing one.
    • Owner is synced, but it isn’t offered in access requests, and Opal can’t grant or revoke it. LaunchDarkly only lets the current Owner transfer ownership.
    • Revoking a role returns the user to Reader. Opal can’t revoke Reader, because LaunchDarkly has no lower role short of removing the user from the account. Remove users through your identity provider instead.
    • Granting a role to the account Owner has no effect, so the Owner keeps Owner.
    • Members whose base role is No access are synced as users, but they don’t hold an account role in Opal until you grant one.
  • Teams: each team appears in Opal as a LaunchDarkly Team. Users can request membership of a team, and you can give a team custom roles. A team’s custom roles apply to every member of the team.
  • Custom roles: each custom role appears in Opal as a LaunchDarkly Role, with the members who hold it. Custom roles are read-only. To give people a custom role, give it to a team and add the people to that team.

Limitations

  • Custom roles that are assigned directly to a member sync into Opal for review, but Opal can’t grant or revoke them. Give the custom role to a team instead.
  • Opal doesn’t sync team maintainers, or LaunchDarkly projects, environments, and flags.
  • Opal doesn’t invite members to LaunchDarkly or remove them.

Requirements

Before you begin, you must:
  • Be an Opal Admin
  • Be able to create access tokens in LaunchDarkly
  • Ask the Opal team to enable the LaunchDarkly integration for your organization

Configuration steps

1. Create a service token

In LaunchDarkly, go to Organization settings > Authorization > Access tokens, and create a service token. Give the token one of the following:
  • A custom role with No access base permissions, whose policy allows updateRole on member/*, and viewTeam, updateTeamMembers, and updateTeamCustomRoles on team/*.
  • On plans without custom roles, the Admin role.
A token with the Reader role can sync access, but it can’t change it. Copy the token. You’ll enter it in Opal in step 2.

2. Create the LaunchDarkly app in Opal

In Opal, go to Inventory > +App and select LaunchDarkly. Fill in the following fields: Opal checks the token when you save the app.

3. Import the organization, teams, and roles

After you save the app, import the items you want to manage: on the app’s Assets tab, select Import assets, choose LaunchDarkly Organization, the teams, and the custom roles, and turn on requests for them. Opal pulls access only for imported items, so roles and team members appear after the next sync.

Troubleshooting

Last modified on November 16, 2026