Skip to content

Commit b744895

Browse files
[Security] Entity Analytics: overview and privileged user monitoring (#2191)
Resolves #1646 by documenting the new Entity Analytics workflow in the Security app. This includes: * The new **Entity analytics** navigation item in the nav menu and the advanced setting that enables it * The new **Entity analytics** overview page, which has the same functionality as the existing [Entity Analytics dashboard](https://www.elastic.co/docs/solutions/security/dashboards/entity-analytics-dashboard) page (to be deprecated in a later Stack version) * The new privileged user monitoring capability ## Previews ### New pages: * [Entity analytics overview](https://docs-v3-preview.elastic.dev/elastic/docs-content/pull/2191/solutions/security/advanced-entity-analytics/overview) (mostly the same as the existing [Entity Analytics dashboard](https://www.elastic.co/docs/solutions/security/dashboards/entity-analytics-dashboard) page, with minor phrasing/formatting edits) * [Privileged user monitoring](https://docs-v3-preview.elastic.dev/elastic/docs-content/pull/2191/solutions/security/advanced-entity-analytics/privileged-user-monitoring) * [Privileged user monitoring requirements](https://docs-v3-preview.elastic.dev/elastic/docs-content/pull/2191/solutions/security/advanced-entity-analytics/privileged-user-monitoring-requirements) * [Set up privileged user monitoring](https://docs-v3-preview.elastic.dev/elastic/docs-content/pull/2191/solutions/security/advanced-entity-analytics/privileged-user-monitoring-setup) * [Monitor privileged user activities](https://docs-v3-preview.elastic.dev/elastic/docs-content/pull/2191/solutions/security/advanced-entity-analytics/monitor-privileged-user-activitites) ### Updated pages/sections: * [Advanced Entity Analytics](https://docs-v3-preview.elastic.dev/elastic/docs-content/pull/2191/solutions/security/advanced-entity-analytics) * [Asset criticality > View and assign asset criticality](https://docs-v3-preview.elastic.dev/elastic/docs-content/pull/2191/solutions/security/advanced-entity-analytics/asset-criticality#_view_and_assign_asset_criticality) * [Entity store > Enable entity store](https://docs-v3-preview.elastic.dev/elastic/docs-content/pull/2191/solutions/security/advanced-entity-analytics/entity-store#enable-entity-store) * [View and analyze risk score data](https://docs-v3-preview.elastic.dev/elastic/docs-content/pull/2191/solutions/security/advanced-entity-analytics/view-analyze-risk-score-data) * [View entity details](https://docs-v3-preview.elastic.dev/elastic/docs-content/pull/2191/solutions/security/advanced-entity-analytics/view-entity-details) * [Configure advanced settings > Access privileged user monitoring](https://docs-v3-preview.elastic.dev/elastic/docs-content/pull/2191/solutions/security/get-started/configure-advanced-settings#access-privileged-user-monitoring) * [Elastic Security UI > Entity analytics](https://docs-v3-preview.elastic.dev/elastic/docs-content/pull/2191/solutions/security/get-started/elastic-security-ui#entity-analytics) --------- Co-authored-by: Nastasha Solomon <[email protected]>
1 parent d684c1d commit b744895

13 files changed

+385
-15
lines changed

solutions/security/advanced-entity-analytics.md

Lines changed: 5 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -15,7 +15,9 @@ products:
1515

1616
Advanced Entity Analytics generates a set of threat detection and risk analytics that allows you to expedite alert triage and hunt for new threats from within an entity’s environment. This feature combines the power of the SIEM detection engine and Elastic’s {{ml}} capabilities to identify unusual user behaviors and generate comprehensive risk analytics for hosts, users, and services.
1717

18-
Advanced Entity Analytics provides two key capabilities:
18+
Advanced Entity Analytics provides the following key capabilities:
1919

20-
* [Entity risk scoring](advanced-entity-analytics/entity-risk-scoring.md)
21-
* [Advanced behavioral detections](advanced-entity-analytics/advanced-behavioral-detections.md)
20+
* [](advanced-entity-analytics/entity-risk-scoring.md)
21+
* [](advanced-entity-analytics/advanced-behavioral-detections.md)
22+
* {applies_to}`stack: preview 9.1` {applies_to}`serverless: unavailable`
23+
[](/solutions/security/advanced-entity-analytics/privileged-user-monitoring.md)

solutions/security/advanced-entity-analytics/asset-criticality.md

Lines changed: 4 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -66,7 +66,10 @@ You can view, assign, change, or unassign asset criticality from the following p
6666
:::
6767

6868

69-
If you have enabled the [entity store](entity-store.md), you can also view asset criticality assignments in the [**Entities** section](../dashboards/entity-analytics-dashboard.md#entity-entities) of the Entity Analytics dashboard:
69+
If you have enabled the [entity store](entity-store.md), you can also view asset criticality assignments in the **Entities** section on the following pages:
70+
71+
* {applies_to}`stack: ga 9.1` {applies_to}`serverless: unavailable` [Entity analytics](/solutions/security/advanced-entity-analytics/overview.md)
72+
* [Entity analytics dashboard](/solutions/security/dashboards/entity-analytics-dashboard.md)
7073

7174
:::{image} /solutions/images/security-entities-section.png
7275
:alt: Entities section

solutions/security/advanced-entity-analytics/entity-store.md

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -42,8 +42,10 @@ To enable the entity store:
4242
1. Find **Entity Store** in the navigation menu or by using the [global search field](/explore-analyze/find-and-organize/find-apps-and-objects.md).
4343
2. On the **Entity Store** page, turn the toggle on.
4444

45-
Once you enable the entity store, the Entity Analytics dashboard displays the [**Entities**](../dashboards/entity-analytics-dashboard.md#entity-entities) section.
45+
Once you enable the entity store, the **Entities** section appears on the following pages:
4646

47+
* {applies_to}`stack: ga 9.1` {applies_to}`serverless: unavailable` [Entity analytics](/solutions/security/advanced-entity-analytics/overview.md)
48+
* [Entity analytics dashboard](/solutions/security/dashboards/entity-analytics-dashboard.md)
4749

4850
## Clear entity store data [clear-entity-store]
4951

Lines changed: 37 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,37 @@
1+
---
2+
applies_to:
3+
stack: preview 9.1
4+
products:
5+
- id: security
6+
- id: cloud-serverless
7+
---
8+
9+
# Monitor privileged user activities
10+
11+
After you [set up privileged user monitoring](/solutions/security/advanced-entity-analytics/privileged-user-monitoring-setup.md), you can start monitoring your privileged users' activity using the different panels on the Privileged user monitoring dashboard.
12+
13+
To get started, find **Privileged user monitoring** in the navigation menu or use the [global search field](/explore-analyze/find-and-organize/find-apps-and-objects.md).
14+
15+
## Risk levels of privileged users
16+
17+
When entity risk scoring is enabled, this panel shows the percentages and numbers of privileged users exhibiting risky behaviors that trigger alerts, grouped by their risk levels. This helps you assess how much risk administrative and other privileged users are contributing to your environment’s overall risk posture.
18+
19+
## Privileged users
20+
21+
This panel represents an inventory of privileged users, sourced from your provided [data sources](/solutions/security/advanced-entity-analytics/privileged-user-monitoring-setup.md#manage-data-sources). It gives a rich catalog of users that may be valuable to investigate, and provides additional information, including user risk scores and asset criticality assignment. This table also serves as a window into the users that are currently being monitored for their privileged status from the configured data sources.
22+
23+
## Top privileged access anomalies
24+
25+
The [Privileged Access Detection](integration-docs://reference/pad.md) package contains multiple {{ml}} jobs that can detect anomalous privileged user activity across various systems, such as Windows, Linux, and Okta system logs. You can install this package directly from the Privileged user monitoring dashboard and access the related {{ml}} jobs for any additional configuration.
26+
27+
Once you install the package, this panel displays a heatmap of the top privileged access anomalies performed by your defined privileged users. You can investigate these anomalies further by reviewing details for individual users or by navigating to the Anomaly Explorer.
28+
29+
## Privileged user activity
30+
31+
This panel contains the following tabs:
32+
33+
* **Granted rights**: Monitor when rights are granted. This helps you detect behavior such as over-provisioning or potential insider threats. It also highlights possible misuse of administrative privileges or violations of least-privilege policies.
34+
35+
* **Account switches**: Track when privileged users switch accounts. This can help you proactively identify potential lateral movement or unauthorized access.
36+
37+
* **Authentications**: Review authentication events for privileged users. Frequent authentication shows how actively these privileges are being used, while repeated failed authentication events can indicate attempted unauthorized access.
Lines changed: 173 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,173 @@
1+
---
2+
applies_to:
3+
stack: ga 9.1
4+
products:
5+
- id: security
6+
- id: cloud-serverless
7+
---
8+
9+
# Entity analytics overview
10+
11+
The **Entity analytics** page provides a centralized view of emerging insider threats—including host risk, user risk, service risk, and anomalies from within your network. Use it to triage, investigate, and respond to these emerging threats.
12+
13+
To access the page, find **Entity analytics****Overview** in the navigation menu or use the [global search field](/explore-analyze/find-and-organize/find-apps-and-objects.md).
14+
15+
:::{admonition} Requirements
16+
* This feature requires the appropriate [subscription](https://www.elastic.co/pricing) in {{stack}} or [project feature](/deploy-manage/deploy/elastic-cloud/project-settings.md) in {{serverless-short}}.
17+
18+
* To get access to this page, turn on the `securitySolution:enablePrivilegedUserMonitoring` [advanced setting](/solutions/security/get-started/configure-advanced-settings.md#access-privileged-user-monitoring).
19+
:::
20+
21+
22+
The **Entity analytics** page includes the following sections:
23+
24+
* [Entity KPIs (key performance indicators)](#entity-kpis)
25+
* [User Risk Scores](#entity-user-risk-scores)
26+
* [Host Risk Scores](#entity-host-risk-scores)
27+
* [Service Risk Scores](#service-risk-scores)
28+
* [Entities](#entity-entities)
29+
* [Anomalies](#entity-anomalies)
30+
31+
32+
## Entity KPIs (key performance indicators) [entity-kpis]
33+
34+
This section displays the total number of critical hosts, critical users, and anomalies. Select a link to jump to the **Hosts** page, **Users** page, or **Anomalies** table.
35+
36+
37+
## User Risk Scores [entity-user-risk-scores]
38+
39+
:::{admonition} Requirements
40+
To display user risk scores, you must [turn on the risk scoring engine](/solutions/security/advanced-entity-analytics/turn-on-risk-scoring-engine.md).
41+
:::
42+
43+
44+
This section displays user risk score data for your environment, including the total number of users, and the five most recently recorded user risk scores, with their associated user names, risk data, and number of detection alerts. User risk scores are [calculated](/solutions/security/advanced-entity-analytics/entity-risk-scoring.md#how-is-risk-score-calculated) using a weighted sum on a scale of 0 (lowest) to 100 (highest).
45+
46+
:::{image} /solutions/images/security-user-score-data.png
47+
:alt: User risk table
48+
:screenshot:
49+
:::
50+
51+
Interact with the table to filter data, view more details, and take action:
52+
53+
* Select the **User risk level** menu to filter the chart by the selected level.
54+
* Click **View all** to display all user risk information on the **Users** page.
55+
* Click a user name link to open the entity details flyout.
56+
* Hover over a user name link to display inline actions: **Add to timeline** ({icon}`timeline`) and **Copy to Clipboard** ({icon}`copy_clipboard`).
57+
* Click the number link in the **Alerts** column to view the alerts on the **Alerts** page. Hover over the number and select **Investigate in timeline** ({icon}`timeline`) to launch Timeline with a query that includes the associated user name value.
58+
59+
For more information about user risk scores, refer to [](/solutions/security/advanced-entity-analytics/entity-risk-scoring.md).
60+
61+
62+
## Host Risk Scores [entity-host-risk-scores]
63+
64+
:::{admonition} Requirements
65+
To display host risk scores, you must [turn on the risk scoring engine](/solutions/security/advanced-entity-analytics/turn-on-risk-scoring-engine.md).
66+
:::
67+
68+
69+
This section displays host risk score data for your environment, including the total number of hosts, and the five most recently recorded host risk scores, with their associated host names, risk data, and number of detection alerts. Host risk scores are [calculated](/solutions/security/advanced-entity-analytics/entity-risk-scoring.md#how-is-risk-score-calculated) using a weighted sum on a scale of 0 (lowest) to 100 (highest).
70+
71+
:::{image} /solutions/images/security-host-score-data.png
72+
:alt: Host risk scores table
73+
:screenshot:
74+
:::
75+
76+
Interact with the table to filter data, view more details, and take action:
77+
78+
* Select the **Host risk level** menu to filter the chart by the selected level.
79+
* Click **View all** to display all host risk information on the **Hosts** page.
80+
* Click a host name link to open the entity details flyout.
81+
* Hover over a host name link to display inline actions: **Add to timeline** ({icon}`timeline`) and **Copy to Clipboard** ({icon}`copy_clipboard`).
82+
* Click the number link in the **Alerts** column to view the alerts on the **Alerts** page. Hover over the number and select **Investigate in timeline** ({icon}`timeline`) to launch Timeline with a query that includes the associated host name value.
83+
84+
For more information about host risk scores, refer to [](/solutions/security/advanced-entity-analytics/entity-risk-scoring.md).
85+
86+
87+
## Service Risk Scores
88+
89+
:::{admonition} Requirements
90+
To display service risk scores, you must [turn on the risk scoring engine](/solutions/security/advanced-entity-analytics/turn-on-risk-scoring-engine.md).
91+
:::
92+
93+
This section displays service risk score data for your environment, including the total number of services, and the five most recently recorded service risk scores, with their associated service names, risk data, and number of detection alerts. Service risk scores are [calculated](/solutions/security/advanced-entity-analytics/entity-risk-scoring.md#how-is-risk-score-calculated) using a weighted sum on a scale of 0 (lowest) to 100 (highest).
94+
95+
:::{image} /solutions/images/security-service-risk-scores.png
96+
:alt: Service risk scores table
97+
:screenshot:
98+
:::
99+
100+
101+
Interact with the table to filter data, view more details, and take action:
102+
103+
* Select the **Service risk level** menu to filter the chart by the selected level.
104+
* Click a service name link to open the service details flyout.
105+
* Hover over a service name link to display inline actions: **Add to timeline** ({icon}`timeline`) and **Copy to Clipboard** ({icon}`copy_clipboard`).
106+
* Click the number link in the **Alerts** column to view the alerts on the **Alerts** page. Hover over the number and select **Investigate in timeline** ({icon}`timeline`) to launch Timeline with a query that includes the associated service name value.
107+
108+
For more information about service risk scores, refer to [](/solutions/security/advanced-entity-analytics/entity-risk-scoring.md).
109+
110+
111+
## Entities [entity-entities]
112+
113+
114+
:::{admonition} Requirements
115+
To display the **Entities** section, you must [enable the entity store](/solutions/security/advanced-entity-analytics/entity-store.md#enable-entity-store).
116+
:::
117+
118+
119+
This section provides a centralized view of all hosts, users, and services in your environment. It displays entities from the [entity store](/solutions/security/advanced-entity-analytics/entity-store.md), which meet any of the following criteria:
120+
121+
* Have been observed by {{elastic-sec}}
122+
* Have an asset criticality assignment
123+
* Have been added to {{elastic-sec}} through an integration, such Active Directory or Okta
124+
125+
:::{note}
126+
The **Entities** table only shows a subset of the data available for each entity. You can query the `.entities.v1.latest.security_user_<space-id>`, `.entities.v1.latest.security_host_<space-id>`, and `.entities.v1.latest.security_service_<space-id>` indices to see all the fields for each entity in the entity store.
127+
:::
128+
129+
130+
:::{image} /solutions/images/security-entities-section.png
131+
:alt: Entities section
132+
:screenshot:
133+
:::
134+
135+
Entity data from different sources appears in the **Entities** section based on the following timelines:
136+
137+
* When you first enable the entity store, only data stored in the last 24 hours is processed. After that, data is processed continuously.
138+
* Observed events from the {{elastic-sec}} default data view are processed in near real-time.
139+
* Entity Analytics data, such as entity risk scores and asset criticality (including bulk asset criticality upload), is also processed in near real-time.
140+
* The availability of entities extracted from Entity Analytics integrations depends on the specific integration. Refer to [Active Directory Entity Analytics](https://docs.elastic.co/en/integrations/entityanalytics_ad), [Microsoft Entra ID Entity Analytics](https://docs.elastic.co/en/integrations/entityanalytics_entra_id), and [Okta Entity Analytics](https://docs.elastic.co/en/integrations/entityanalytics_okta) for more details.
141+
142+
Interact with the table to filter data and view more details:
143+
144+
* Select the **Risk level** dropdown to filter the table by the selected user, host, or service risk level.
145+
* Select the **Criticality** dropdown to filter the table by the selected asset criticality level.
146+
* Select the **Source** dropdown to filter the table by the data source.
147+
* Click the **View details** icon ({icon}`expand` ) to open the entity details flyout.
148+
149+
150+
151+
## Anomalies [entity-anomalies]
152+
153+
Anomaly detection jobs identify suspicious or irregular behavior patterns. The **Anomalies** table displays the total number of anomalies identified by these prebuilt {{ml}} jobs (named in the **Anomaly name** column).
154+
155+
:::{admonition} Requirements
156+
To display anomaly results, you must [install and run](/explore-analyze/machine-learning/anomaly-detection/ml-ad-run-jobs.md) one or more [prebuilt anomaly detection jobs](/reference/data-analysis/machine-learning/ootb-ml-jobs-siem.md). You cannot add custom anomaly detection jobs to the **Entity analytics** page.
157+
:::
158+
159+
160+
:::{image} /solutions/images/security-anomalies-table.png
161+
:alt: Anomalies table
162+
:screenshot:
163+
:::
164+
165+
Interact with the table to view more details:
166+
167+
* Click **View all host anomalies** to go to the **Anomalies** table on the **Hosts** page.
168+
* Click **View all user anomalies** to go to the **Anomalies** table on the **Users** page.
169+
* Click **View all** to display and manage all machine learning jobs on the **Anomaly Detection Jobs** page.
170+
171+
:::{tip}
172+
To learn more about {{ml}}, refer to [](/explore-analyze/machine-learning.md)
173+
:::
Lines changed: 31 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,31 @@
1+
---
2+
applies_to:
3+
stack: preview 9.1
4+
products:
5+
- id: security
6+
- id: cloud-serverless
7+
---
8+
9+
# Privileged user monitoring requirements
10+
11+
This page covers the requirements for using the privileged user monitoring feature, as well as its known limitations.
12+
13+
* Privileged user monitoring feature requires the appropriate [subscription](https://www.elastic.co/pricing).
14+
15+
* To enable this feature, turn on the `securitySolution:enablePrivilegedUserMonitoring` [advanced setting](/solutions/security/get-started/configure-advanced-settings.md#access-privileged-user-monitoring).
16+
17+
* To use these features , your role must have certain [privileges](#privmon_privs).
18+
19+
## Privileges [privmon_privs]
20+
21+
| Action | Index Privileges | Kibana Privileges |
22+
| ------ | ---------------- | ----------------- |
23+
| Enable the privileged user monitoring feature | N/A | **All** for the **Security** feature |
24+
| View the Privileged user monitoring dashboard | `Read` for the following indices:<br> - `.entity_analytics.monitoring.users-<space-id>`<br> - `risk-score.risk-score-*`<br> - `.alerts-security.alerts-<space-id>`<br> - `.ml-anomalies-shared`<br> - Security data view indices | **Read** for the **Security** feature |
25+
26+
## Known limitations
27+
28+
* Currently, none of the privileged user monitoring visualizations support [cross-cluster search](/solutions/search/cross-cluster-search.md) as part of the data that they query from.
29+
30+
* You can define up to 10,000 privileged users per data source.
31+

0 commit comments

Comments
 (0)