Newer Version Available
Manage Current OAuth Connected App Sessions
The Connected Apps OAuth Usage page displays all current OAuth app connections to the
org. These apps have an active access or refresh token. Apps without a current access or refresh
token are not shown. From this page, you can install or uninstall third-party connected apps,
revoke an app’s active sessions, and block or unblock org-wide access to the app.
| Available in: both Salesforce Classic (not available in all orgs) and Lightning Experience |
| Connected Apps can be created in: Group,
Professional, Enterprise, Performance, Unlimited, and
Developer Editions Connected Apps can be installed in: All Editions |
| User Permissions Needed | |
|---|---|
| To view the OAuth Connected Apps Usage page: | View Setup and Configuration AND Manage Users |
| To read, create, update, or delete connected apps: | Customize Application AND either Modify All Data OR Manage Connected Apps |
| To update all fields except Profiles, Permission Sets, and Service Provider SAML Attributes: | Customize Application AND either Modify All Data OR Manage Connected Apps |
| To update Profiles, Permission Sets, and Service Provider SAML Attributes: | Customize Application AND Modify All Data |
| To install and uninstall connected apps: | Customize Application AND either Modify All Data OR Manage Connected Apps |
| To install and uninstall packaged connected apps: | Customize Application AND either Modify All Data OR Manage Connected Apps AND Download AppExchange Packages |
-
From Setup, enter OAuth in the Quick Find box, then select
Connected Apps OAuth Usage.
The resulting list of apps can be long because it contains all Salesforce and custom OAuth apps available to your users, not just the ones installed in your org. For example, it lists third-party apps from AppExchange and Salesforce partners.
- Click Manage App Policies to open the detail page for the connected app. From the detail page, you can click Edit Policies to manage the app’s access policies. See Manage Access to a Connected App.
-
Click a user count number to open the Connected Apps User’s Usage page to see information
about users, which includes:
- When they first used the app
- Most recent time they used the app
- Total number of times they used the app
From this page, you can end a user’s access to the current session by clicking Revoke. At the top of the page, click Revoke All to end all current sessions for the app. - Click Install to install a third-party app in your org so that you can manage its access policies See Install a Connected App.
- Click Uninstall to remove the local copy of the connected app from your org. Prior to uninstalling a connected app, see Uninstall a Third-Party Connected App recommendations and considerations.
- Click Block to make the OAuth connected app inaccessible to your org’s users. Blocking an app ends all current user sessions and prevents future sessions until you click Unblock.
-
Click Unblock to give users access to the connected app. By
unblocking the app, users can log in and run the app.
If Unblock is disabled, the app is blocked org-wide because it’s not whitelisted. To whitelist the app, click Install, then click Edit Policies. Under the app’s OAuth settings, set Permitted Users to Admin approved users are pre-authorized. You can whitelist apps only if you’ve asked Salesforce Customer Support to enable the API client whitelisting feature.