No results for ""
EXPAND ALL
  • Home
  • API docs

GIVE DOCS FEEDBACK

OAuth applications

Read time: 2 minutes
Last edited: Feb 15, 2024

Overview

This topic explains how to authorize or revoke access of an OAuth app.

OAuth apps may require extensive permissions

It is critically important to only authorize applications you trust to use your LaunchDarkly account. Read the permissions required by the app carefully and use your own best judgment about whether you trust an app enough to use it.

Connecting an OAuth app to LaunchDarkly

You can connect your LaunchDarkly account to external applications, such as the LaunchDarkly Slack app, using the OAuth 2.0 protocol. When you authorize an OAuth application, you grant the application access to information and actions an account member might take. Some applications can act on your behalf, such as by turning feature flags on and off.

Your LaunchDarkly credentials and billing information will never be shared with any OAuth application you authorize.

If you are interested in developing your own OAuth application, read Registering a LaunchDarkly OAuth client.

OAuth app permissions

On initial authorization, an OAuth app shows you a complete list of permissions it requires in order to work. While the app may have the capability to perform many actions in LaunchDarkly, the app's ability to do anything is limited by the abilities of the account member who authorizes it.

Additionally, if your own permissions are reduced, applications you have previously authorized will have reduced permissions as will.

When you authorize an OAuth app, it can never do more than you can do

For example, if you are a Writer and authorize an app, and then are downgraded to a Reader, your app will only have Reader-level permissions.

Disconnecting an OAuth app

We care about the security of your information. You or an Administrator can revoke an app's permission to use your account at any time.

Administrators can revoke any app

If you are a LaunchDarkly administrator, you can revoke access of any app added to LaunchDarkly, regardless of which account member added it.

To disconnect an app:

  1. Navigate to the Account settings page.
  2. Click the Authorization tab.
  3. In the "Authorized applications" section, locate the app you would like to disconnect.
  4. Click Review. The "Application access" panel appears:
  5. Click Revoke. A confirmation dialog appears.
  6. Enter "yes" in the Type yes to confirm field.
  7. Click Revoke.

The application's access is revoked.