Manage OAuth apps
Applies to: Microsoft Cloud App Security
Many third-party productivity apps that might be installed by business users in your organization request permission to access user information and data and sign in on behalf of the user in other cloud apps, such as Office 365, G Suite and Salesforce. When users install these apps, they often click accept without closely reviewing the details in the prompt, including granting permissions to the app. This problem is compounded by the fact that IT may not have enough insight to weigh the security risk of an application against the productivity benefit that it provides. Because accepting third-party app permissions is a potential security risk to your organization, monitoring the app permissions your users grant gives you the necessary visibility and control to protect your users and your applications. The Microsoft Cloud App Security app permissions enable you to see which user-installed OAuth applications have access to Office 365 data, G Suite data, and Salesforce data. Cloud App Security tells you what permissions the apps have and which users granted these apps access to their Office 365, G Suite, and Salesforce accounts. App permissions help you decide which apps you allow your users to access and which ones you want to ban.
For more information on investigating OAuth apps, see Investigate risky OAuth apps.
Working with the OAuth apps page
The OAuth page displays information about app permissions in your connected apps.
To access the OAuth tab:
In the Cloud App Security portal, click Investigate, and then OAuth apps.
The OAuth apps page provides the following information about each OAuth app that was granted permissions:
|Item||What it means||Applies to|
|Basic icon in the app query bar||Switch to query in the basic view.||Office 365, G Suite, Salesforce|
|Advanced icon in the app query bar||Switch to query in the Advanced view.||Office 365, G Suite, Salesforce|
|Open or close all details icon in the app list||View more or less details about each app.|
|Export icon in the app list||Export a CSV file that contains a list of apps, number of users for each app, permissions associated with the app, permissions level, app state, and community use level.||Office 365, G Suite, Salesforce|
|App||Name of the app. Select the name to view more information, including the description, publisher (for Office 365), app website, and ID.||Office 365, G Suite, Salesforce|
|Authorized by||The number of users who authorized this app to access their app's account, and granted the app permissions. Select the number to view more information, including a list of user emails and whether an admin has consented the app previously.||Office 365, G Suite, Salesforce|
|Permissions Level||The permissions level icon and text indicating either High, Medium, or Low. The level indicates how much access this app has to app's data. For example, Low might indicate that the app only accesses user profile and name. Select the level to view more information, including permissions granted to the app, community use, or related activity in the Governance log.||Office 365, G Suite|
|App state||An admin can mark an app as approved, banned, or leave is as undetermined.||Office 365, G Suite, Salesforce|
|Community use||Shows you how popular the app is across all your users (common, uncommon, rare)||Office 365, G Suite, Salesforce|
|Last authorized||The most recent date on which a user granted permissions to this app.||Office 365, Salesforce|
|Publisher||The name of the vendor who provides the app.||Office 365|
|Last used||The most recent date on which this app was used by anyone in your organization.||Salesforce|
Ban or approve an app
On the OAuth apps page, click on the app to open the App drawer to view more information about the app and the permissions it was granted.
- Click on the Permissions link to view a full list of permissions that were granted to the app.
- Under Community use, you can view how common the app is in other organizations.
- Click the Related activity link to view the activities that are listed in the governance log related to this app.
To ban the app, click on the ban icon at the end of the app row in the table.
- You can choose if you want to tell users the app they installed and authorized has been banned. The notification lets users know the app will be disabled and they won't have access to the connected app. If you don't want them to know, unselect Notify users who granted access to this banned app in the dialog.
- It's recommended that you let the app users know their app is about to be banned from use.
Type the message you want to send to the app users in the Enter a custom notification message box. Click Ban app to send the mail, and ban the app from your connected app users.
To approve the app, click on the approve icon at the end of the row in the table.
- The icon turns green, and the app is approved for all your connected app users.
- When you mark an app as approved, there's no effect on the end user. This color change is meant to help you see the apps that you've approved to separate them from ones that you haven't reviewed yet.
Revoke app and notify user
For G Suite and Salesforce, it's possible to revoke permission to an app or to notify the user that they should change the permission. When you revoke permission it removes all permissions that were granted to the application under “Enterprise Applications” in Azure AD.
On the OAuth apps page, click on three dots at the end of the app row and select Notify user. By default, the user will be notified as follows: You authorized the app to access your G Suite account. This app conflicts with your organization's security policy. Reconsider giving or revoking the permissions you gave this app in your G Suite account. To revoke app access, go to: https://security.google.com/settings/security/permissions?hl=en&pli=1 Select the app and click 'Revoke access' on the right menu bar. You can customize the message that is sent.
You can also revoke permissions to use the app for the user. Click the icon at the end of the app row in the table and selecting Revoke app.
Query OAuth apps
You can query OAuth apps in either the Basic view or the Advanced view. select values from one or multiple drop-downs to display the specific apps in the Basic view. In the advanced view, use the Select a filter drop-down to narrow your search. Add operators, equals, or doesn't equal, to a selected value to complete your query.
Choose the Add a filter icon to add additional filters to further refine your query. The filters are applied automatically and the apps list is updated.
Choose the Remove a filter icon next to the filter to remove the filters.
OAuth app auditing
Cloud App Security audits all OAuth authorization activities to provide you with comprehensive monitoring and investigation of activities performed. You can also export the details of users that authorized a specific OAuth app, providing you with additional information on the users, which you can then use for further analysis.
To export the log, perform the following steps:
On the OAuth apps page, on the row where the relevant app appears, under Authorized by, click the link showing the number of users that authorized the app.
In the pop-up window, click Export.
If there’s an OAuth app discovered in your organization that seems malicious, you can send the Cloud App Security team feedback to let us know. This feature enables you to be part of our security community and enhance OAuth app risk score and analysis.
On the OAuth apps page, click on three dots at the end of the app row and select Report app.
In the Report this app screen, you can select whether to report the app as malicious or to report another issue with the way Cloud App Security perceives the app. For example, you could use Incorrect publisher, Incorrect permissions, or Other. The data you submit will be used to update the app's risk score and other analytics about the app.
If you run into any problems, we're here to help. To get assistance or support for your product issue, please open a support ticket.