Skip to content

Commit 049b3a5

Browse files
authored
Merge branch 'main' into New-article-remove-unsafe-permissions-sensitive-entra-connect-
2 parents 7d51e06 + 6299d3e commit 049b3a5

File tree

7 files changed

+89
-81
lines changed

7 files changed

+89
-81
lines changed

CloudAppSecurityDocs/accounts.md

Lines changed: 39 additions & 40 deletions
Original file line numberDiff line numberDiff line change
@@ -8,63 +8,62 @@ ms.topic: how-to
88

99

1010

11-
Microsoft Defender for Cloud Apps gives you visibility into the accounts from your connected apps. After you connect Defender for Cloud Apps to an app using the App connector, Defender for Cloud Apps reads account information associated with connected apps. The Accounts page enables you to investigate those accounts, permissions, the groups they're members of, their aliases, and the apps they're using. Additionally, when Defender for Cloud Apps detects a new account that wasn't previously seen in one of the connected apps - for example, in activities or file sharing - the account is added to the accounts list of that app. This enables you to have visibility into the activity of external users interacting with your cloud apps.
11+
Microsoft Defender for Cloud Apps gives you visibility into the accounts from your connected applications. After you connect Defender for Cloud Apps to an app using the [App connector](/defender-cloud-apps/enable-instant-visibility-protection-and-governance-actions-for-your-apps), Defender for Cloud Apps reads account information associated with connected applications. The Cloud application accounts tab within the Identity inventory enables you to investigate those accounts, permissions, the groups they're members of, their aliases, and the apps they're using. Additionally, when Defender for Cloud Apps detects a new account that wasn't previously seen in one of the connected apps - for example, in activities or file sharing - the account is added to the accounts list of that app. This enables you to have visibility into the activity of external users interacting with your cloud apps.
1212

13-
## Identity Inventory (Preview)
13+
## Identity Inventory
1414

15-
> [!NOTE]
16-
> The Identities page is in the process of merging into the unified **Identity Inventory (Preview)**.
17-
>
18-
> The **Identity inventory** provides a centralized view of all identities in your organization, enabling you to monitor and manage them efficiently. At a glance, you can see key details such as Domain, Tags, Type, and other attributes, helping you quickly identify and manage identities that require attention.
19-
>
20-
> The functionality of the Identities page, as presented below, will be provided in the new Identity Inventory under the "**Cloud application accounts**" tab, offering the same features as it does today. For more details, visit the [Identity Inventory documentation](/defender-for-identity/identity-inventory).
21-
>
22-
## Identities
15+
The visibility into cloud application accounts, as described above, is provided in the Identity Inventory under the "**Cloud application accounts**" tab.
2316

24-
Admins can search for a specific user's metadata or user's activity. The **Identities** page provides you with comprehensive details about the entities that are pulled from connected cloud applications. It also provides the user's activity history and security alerts related to the user.
17+
The **Identity inventory** provides a centralized view of all identities in your organization, enabling you to monitor and manage them efficiently. At a glance, you can see key details such as Domain, Tags, Type, and other attributes, helping you quickly identify and manage identities that require attention.
2518

26-
The **Identities** page can be [filtered](#identities-filters) to enable you to find specific accounts and to deep dive into different types of accounts, for example, you can filter for all External accounts that haven't been accessed since last year.
19+
For more details, visit the [Identity Inventory documentation](/defender-for-identity/identity-inventory).
2720

28-
The **Identities** page enables you to easily investigate your accounts, including the following issues:
21+
## Cloud Application Accounts
2922

30-
* Check if any accounts have been inactive in a particular service for a long time (Maybe you should revoke the license for that user to that service)
23+
Admins can search for specific account metadata or account activity. The **Cloud application accounts** tab provides comprehensive details about entities pulled from connected cloud applications, including activity history and security alerts related to the account.
3124

32-
* You can filter for the list of users with admin permissions
33-
* You can search for users who are no longer part of your organization but may still have active accounts
34-
* You can take [governance actions](#governance-actions) on the accounts, such as suspending an app or going to the account settings page.
35-
* You can see which accounts are included in each user group
36-
* You can see which apps are accessed by each account and which apps are deleted for specific accounts
25+
The **Cloud application accounts** tab can be filtered to find specific accounts and deep dive into different types of accounts. For example, you can filter for all External accounts that haven't been accessed since last year.
3726

38-
![accounts screen.](media/accounts-page.png)
39-
40-
### Identities filters
27+
The **Cloud application accounts** tab enables easy investigation of accounts, including:
28+
29+
- Checking if any accounts have been inactive in a particular service for a long time (consider revoking the license for that user to that service).
30+
31+
- Filtering for accounts with admin permissions.
32+
33+
- Searching for accounts that are no longer part of your organization but may still have active accounts.
34+
35+
- Taking governance actions on accounts, such as suspending an app or accessing the account settings page.
36+
37+
- Viewing which accounts are included in each user group.
38+
39+
- Seeing which apps are accessed by each account and which apps are deleted for specific accounts.
4140

42-
Following is a list of the account filters that can be applied. Most filters support multiple values as well as NOT, in order to provide you with a powerful tool for policy creation.
41+
[![Screenshot that shows the Cloud application accounts](media/accounts/cloud-application-accounts.png)](media/accounts/cloud-application-accounts.png#lightbox)
4342

44-
* **Affiliation**: The affiliation is either **Internal** or **External**. To set which users and accounts are internal, under **Settings** make sure to set the **IP address range** of your internal organization. If the account has admin permissions the icon in the Accounts table appears with the addition of the red tie:
43+
### Accounts filters
44+
45+
The Cloud application accounts tab offers comprehensive filtering capabilities, with pre-defined filters for a quick and easy experience.
46+
47+
Admins can also enable the "Advanced filters" toggle to filter by additional attributes or create complex filters that include conditions such as "does not equal."
48+
![Screenshot that shows the Advanced filters toggle.](media/accounts/image.png)
49+
50+
Predefined filters include:
51+
52+
- **Account name:** Filter specific accounts.
53+
54+
- **Affiliation:** Internal or External. Set internal accounts under **Settings** by defining the **IP address range of your organization**. Admin accounts are marked with a red tie icon.
4555

4656
![accounts admin icon.](media/accounts-admin-icon.png)
4757

48-
* **App**: You can filter for any API connected app being used by accounts in your organization.
49-
* **Domain**: This enables you to filter for users in specific domains.
50-
* **Groups**: Enables you to filter for members of user groups in Defender for Cloud Apps - both built-in user groups and imported user groups.
51-
* **Instance**: This enables you to filter for members of a specific app instance.
52-
* **Last seen**: The **last seen** filter enables you to find accounts that are dormant and whose users haven't performed any activities in a while.
53-
* **Organization**: This enables you to filter for members of specific organizational groups defined in your connected apps.
54-
* **Show Admins only**: Filters for accounts and users that are admins.
55-
* **Status**: Filter based on user account status of N/A, staged, active, suspended, or deleted. A status of not available (N/A) is normal and may appear, for example, for anonymous accounts.
56-
* **Type**: This enables you to filter to either the user or the account type.
57-
* **User name**: Enables you to filter specific users.
58-
59-
### Governance actions
58+
- **App:** Filter for any connected app used by accounts in your organization.
6059

61-
From the **Users and account** page, you can take governance actions such as suspending an app or going to the account settings page. For a full list of governance actions, see the [governance log](governance-actions.md).
60+
- **Groups:** Filter for members of user groups in Defender for Cloud Apps—both built-in and imported user groups.
6261

63-
For example, if you identify a user that is compromised, you can apply the **Confirm user compromised** action to set the user risk level to high, causing the relevant policy actions defined in Microsoft Entra ID to be enforced. The action can be applied manually or using relevant [policies that support governance actions](governance-actions.md).
62+
- **Show Admins only:** Filter for admin accounts.
6463

65-
#### To manually apply a user or account governance action
64+
### Additional actions
6665

67-
From the **Users and account** page, on the row where the relevant user or account appears, choose the three dots at the end of the row, then select **Confirm user compromised**.
66+
Additional actions for further investigation, such as viewing related activities and incidents, are available through the Cloud application accounts tab. Click the three dots at the end of the relevant account's row to view available actions, or click on the account row to see additional accounts related to a single user. Additional actions are also available via the three dots at the end of the table in this view.
6867

6968
## Next steps
7069

CloudAppSecurityDocs/additional-integrations.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -27,6 +27,6 @@ The Defender for Cloud Apps robust platform allows you to integrate with a wide
2727

2828
Defender for Cloud Apps allows security teams to automatically or manually confirm a user as compromised to ensure fast remediation of compromised users.
2929

30-
For more information, see [How does Microsoft Entra ID use my risk feedback](/azure/active-directory/identity-protection/howto-identity-protection-risk-feedback#how-does-azure-ad-use-my-risk-feedback) and [Governance actions](accounts.md#governance-actions).
30+
For more information, see [How does Microsoft Entra ID use my risk feedback](/azure/active-directory/identity-protection/howto-identity-protection-risk-feedback#how-does-azure-ad-use-my-risk-feedback).
3131

3232
[!INCLUDE [Open support ticket](includes/support.md)]
182 KB
Loading
2.15 KB
Loading

CloudAppSecurityDocs/protect-google-workspace.md

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -159,6 +159,14 @@ This section provides instructions for connecting Microsoft Defender for Cloud A
159159
160160
![Google Workspace authorize new client ID.](media/connect-google-workspace/google-workspace-authorize-new-client-id.png)
161161
162+
>[!IMPORTANT]
163+
> In order for the Google connector to function correctly, enable **Google Drive** for the Super Admin user that will be used for the connector.
164+
> - Navigate to admin.google.com
165+
> - Select apps -> Google Workspace -> Drive and Docs
166+
> - Turn on Service status for the Super Admin user used to onboard the connector. We recommended enabling Service status for all users.
167+
168+
169+
162170
### Configure Defender for Cloud Apps
163171
164172
1. In the Microsoft Defender Portal, select **Settings**. Then choose **Cloud Apps**. Under **Connected apps**, select **App Connectors**.

CloudAppSecurityDocs/toc.yml

Lines changed: 38 additions & 38 deletions
Original file line numberDiff line numberDiff line change
@@ -57,45 +57,8 @@ items:
5757
href: activity-privacy.md
5858
- name: Work with IP ranges and tags
5959
href: ip-tags.md
60-
- name: Cloud app discovery
61-
items:
62-
- name: Overview
63-
displayName: cloud discovery, best practices
64-
href: set-up-cloud-discovery.md
65-
- name: Govern discovered apps
66-
href: governance-discovery.md
67-
- name: Enrich cloud discovery
68-
href: cloud-discovery-aad-enrichment.md
69-
- name: Anonymize cloud discovery data
70-
href: cloud-discovery-anonymizer.md
71-
- name: Configure cloud discovery
60+
- name: Connect apps for visibility and protection
7261
items:
73-
- name: Find your cloud app and calculate risk scores
74-
href: risk-score.md
75-
- name: Add custom apps to cloud discovery
76-
href: cloud-discovery-custom-apps.md
77-
- name: Attest your app
78-
href: attest-your-app.md
79-
- name: Collect logs
80-
items:
81-
- name: Configure automatic log upload for continuous reports
82-
href: discovery-docker.md
83-
- name: Podman on Linux on-premises
84-
href: discovery-linux-podman.md
85-
- name: Docker on Linux on-premises
86-
href: discovery-docker-ubuntu.md
87-
- name: Docker on Linux in Azure
88-
href: discovery-docker-ubuntu-azure.md
89-
- name: Docker on Azure Kubernetes Service
90-
href: discovery-kubernetes.md
91-
- name: Docker on Windows on-premises
92-
href: discovery-docker-windows.md
93-
- name: Advanced log collector management
94-
href: log-collector-advanced-management.md
95-
- name: Use the custom log parser
96-
href: custom-log-parser.md
97-
- name: Connect apps for visibility and protection
98-
items:
9962
- name: Overview
10063
displayName: connect apps
10164
href: enable-instant-visibility-protection-and-governance-actions-for-your-apps.md
@@ -157,6 +120,43 @@ items:
157120
href: protect-zoom.md
158121
- name: Troubleshooting API connectors using error messages
159122
href: troubleshooting-api-connectors-using-error-messages.md
123+
- name: Cloud app discovery
124+
items:
125+
- name: Overview
126+
displayName: cloud discovery, best practices
127+
href: set-up-cloud-discovery.md
128+
- name: Govern discovered apps
129+
href: governance-discovery.md
130+
- name: Enrich cloud discovery
131+
href: cloud-discovery-aad-enrichment.md
132+
- name: Anonymize cloud discovery data
133+
href: cloud-discovery-anonymizer.md
134+
- name: Configure cloud discovery
135+
items:
136+
- name: Find your cloud app and calculate risk scores
137+
href: risk-score.md
138+
- name: Add custom apps to cloud discovery
139+
href: cloud-discovery-custom-apps.md
140+
- name: Attest your app
141+
href: attest-your-app.md
142+
- name: Collect logs
143+
items:
144+
- name: Configure automatic log upload for continuous reports
145+
href: discovery-docker.md
146+
- name: Podman on Linux on-premises
147+
href: discovery-linux-podman.md
148+
- name: Docker on Linux on-premises
149+
href: discovery-docker-ubuntu.md
150+
- name: Docker on Linux in Azure
151+
href: discovery-docker-ubuntu-azure.md
152+
- name: Docker on Azure Kubernetes Service
153+
href: discovery-kubernetes.md
154+
- name: Docker on Windows on-premises
155+
href: discovery-docker-windows.md
156+
- name: Advanced log collector management
157+
href: log-collector-advanced-management.md
158+
- name: Use the custom log parser
159+
href: custom-log-parser.md
160160
- name: Integrate with Microsoft Defender for Endpoint
161161
items:
162162
- name: Overview

CloudAppSecurityDocs/troubleshooting-api-connectors-using-error-messages.md

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
---
2-
title: Troubleshoot App Connector errors
2+
title: Troubleshoot App connector errors
33
description: This article provides a list of API App connector error messages as well as resolution recommendations for each.
44
ms.date: 01/29/2023
55
ms.topic: conceptual
@@ -33,7 +33,8 @@ App connector errors can be seen in the app connector dialog after attempting to
3333
> |HttpRequestFailure: Server returned: 401 Unauthorized|Exchange Online|User or password are incorrect|Make sure the username and password are correct and Follow the process to connect Exchange Online to Defender for Cloud Apps again.|
3434
> |HttpRequestFailure: Server returned: 404 Not Found|Exchange Online|The user you are using to log into Exchange Online does not have a primary mailbox in Exchange Online (for example, a user who does not exist in Microsoft Entra ID or a user exists in Microsoft Entra ID, but does not have an Exchange Online license).|Follow the process to connect Exchange Online to Defender for Cloud Apps again using a new admin account.|
3535
> |GoogleJsonResponseException: 401 Unauthorized|Google Workspace|Access denied. You are not authorized to read activity records. The user you log into Google Workspace with must be an admin user.|Follow the process to connect Google Workspace to Defender for Cloud Apps again using an admin account.|
36-
> |GoogleJsonResponseException: 403 Forbidden|Google Workspace|Problem running the Google Workspace API.|If you just deployed the Defender for Cloud Apps App Connector for Google Workspace, check the following: If you clicked Unlimited, make sure that your Google Workspace account is really unlimited. If it is not, run the App Connector again and un-select the option for an unlimited account. Check that the scopes you defined during setup are correct. If this is not a new deployment and you see this error, it may be that you reached the API limit for today and Google Workspace events will be renewed tomorrow.|
36+
> |GoogleJsonResponseException: 403 Forbidden|Google Workspace|
37+
Problem running the Google Workspace API.|If you just deployed the Defender for Cloud Apps App Connector for Google Workspace, check the following: If you clicked Unlimited, make sure that your Google Workspace account is really unlimited. If it is not, run the App Connector again and un-select the option for an unlimited account. Check that the scopes you defined during setup are correct. If this is not a new deployment and you see this error, it may be that you reached the API limit for today and Google Workspace events will be renewed tomorrow.|
3738
> |TokenResponseException: 400 Bad Request|Google Workspace|Either the connection to Google Workspace did not complete or is expired.|Follow the process to connect Google Workspace to Defender for Cloud Apps again.|
3839
> |HttpRequestFailure: Server returned: 401 Unauthorized|Okta|The Okta token is not valid.|Follow the process to connect Okta to Defender for Cloud Apps again.|
3940
> |IOException:|Okta|Internal error|Contact support|

0 commit comments

Comments
 (0)