OAuth Apps

Overview

Use the OAuth Apps management page under Organization Settings to manage and gain visibility into your organization’s OAuth applications, such as the scopes and permissions granted to an application and the users that have authorized access for it.

OAuth Apps management page in Datadog

Setup

Permissions

By default, users with Datadog Standard and Datadog Admin roles can access the OAuth Apps management page. If your organization has custom roles defined, add your user to any custom role with org_authorized_apps_read and org_authorized_apps_write permissions.

Only users with the Datadog Admin role or the org_authorized_apps_write permission can manage OAuth applications on this page, such as disabling applications or revoking OAuth access for a user.

Enable

Enabled OAuth applications allow users with necessary permissions to authorize access on their behalf. OAuth applications include the Datadog Mobile App.

Disable

Disabling OAuth access for an application revokes access to this application for all users in your organization. While the application remains installed, users are no longer able to use the application and are prompted with an error if they attempt to authorize it.

There are two ways to disable an application from the OAuth Apps management page:

  1. Hover over your application in the apps table to reveal the Disable button on the right side of the row.

    Disable button in apps table

  2. Click on your application to open the detailed view of the application and click the Disable Application button.

    Disable button in app's detailed view

Note: When re-enabled, users that previously authorized the application are required to re-authorize the application to regain access.

Revoke access

Revoking a user’s OAuth access to an application removes all access to that application. If the user has the required permissions to authorize the application, they can regain access by re-authorizing it.

Disable button in apps detailed view

Further Reading

Additional helpful documentation, links, and articles:

PREVIEWING: may/unit-testing