Skip to content

Commit aaaf16e

Browse files
Documents new RBAC for value reports (#3817)
Fixes #3720 — documents a new RBAC control that controls access to the Value Report feature in Elastic Security (only available on serverless security and EASE projects for now — planned for Stack v9.3). Tweaks the value reports page to make it more generic, since previously it was only available on EASE, and it's now available in serverless. Although in the original ticket @stephmilovic requested that the new RBAC control be documented [here](https://www.elastic.co/docs/solutions/security/get-started/elastic-security-requirements), for this draft I opted to document it directly on the Value Reports page, since the security requirements page is more of a high-level page that isn't focused on specific features (other than linking to other requirements pages that are related to specific features). Instead, I suggest we make the in-product link go to the Value Reports page rather than the security requirements page. Also added the value reports page to another spot in the GenAI for security section — it's still present in the original spot in the EASE subfolder, but now that it's available in serverless too, I wanted to make it more findable. --------- Co-authored-by: florent-leborgne <[email protected]>
1 parent 6393095 commit aaaf16e

File tree

6 files changed

+65
-38
lines changed

6 files changed

+65
-38
lines changed
Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,11 @@
1+
The **Value report** page estimates your savings from using Elastic's AI SOC features for alert triage, in terms of **Analyst time saved** and **Cost Savings**. The message at the top of the page explains how those numbers were determined, and how many alerts were **Escalated** and **Filtered** by AI.
2+
3+
You can interact with the page in the following ways:
4+
5+
- **Update the time range:** Use the time selector in the upper right corner to select the time range for which to show value metrics.
6+
- **Export report:** Select **Export report** in the upper right corner to download a sharable PDF of the value report.
7+
8+
9+
:::{image} /solutions/images/security-ease-value-report.png
10+
:alt: The Value Report in an EASE project
11+
:::
-2.36 KB
Loading
73.6 KB
Loading

solutions/security/ai/ease/ease-intro.md

Lines changed: 34 additions & 29 deletions
Original file line numberDiff line numberDiff line change
@@ -10,6 +10,40 @@ Elastic AI SOC Engine (EASE) is an {{sec-serverless}} project type that provides
1010

1111
This page describes how to create an EASE project, how to ingest your data, and how to use its key features.
1212

13+
14+
## Features
15+
16+
EASE provides a set of capabilities designed to help make the most of each security analyst’s time, fight alert fatigue, and reduce your mean time to respond. Once your data is ingested, you can start using the following features:
17+
18+
- **[Attack Discovery](/solutions/security/ai/attack-discovery.md)**: Helps you analyze alerts in your environment and identify threats. Each discovery represents a potential attack and describes relationships among multiple alerts to tell you which users and hosts are involved, how alerts correspond to the MITRE ATT&CK matrix, and which threat actor might be responsible.
19+
20+
:::{image} /solutions/images/security-attck-disc-example-disc.png
21+
:alt: Attack Discovery detail view
22+
:width: 600px
23+
:::
24+
25+
You can [schedule](/solutions/security/ai/attack-discovery.md#schedule-discoveries) Attack Discovery to run automatically, and notify you of any discoveries through a range of connectors such as Slack, Teams, PagerDuty, or email.
26+
27+
- **[AI Assistant](/solutions/security/ai/ai-assistant.md)**: An LLM-powered virtual assistant specialized for digital security; it helps with data analysis, alert investigation, incident response, and {{esql}} query generation. You can add custom background knowledge and data to its [knowledge base](/solutions/security/ai/ai-assistant-knowledge-base.md) and use natural language to ask for its assistance with your SOC operations.
28+
29+
:::{image} /solutions/images/security-ease-ai-assistant.png
30+
:alt: A new conversation with AI Assistant
31+
:width: 450px
32+
:::
33+
34+
You can add custom information to AI Assistant's [Knowledge Base](/solutions/security/ai/ai-assistant-knowledge-base.md), either in the form of individual documents or entire indices containing numerous documents. This information informs the AI Assistant's responses and can include everything from threat intelligence, to information about your team's on-call rotation, to information about your infrastructure, and more.
35+
36+
- **[Cases](/solutions/security/investigate/cases.md)**: Helps you track and share related information about security issues. Track key investigation details and collect alerts in a central location.
37+
38+
:::{image} /solutions/images/security-ease-cases.png
39+
:alt: The Cases page in an EASE project showing the default state
40+
:::
41+
42+
- **[Value report](/solutions/security/ai/ease/ease-value-report.md)**:
43+
44+
:::{include} /solutions/_snippets/value-report-intro.md
45+
:::
46+
1347
## Create an EASE project
1448

1549
To create an EASE project:
@@ -47,32 +81,3 @@ To ingest third-party security data:
4781

4882
EASE uses LLM connectors to enable its AI features such as Attack Discovery and AI Assistant. The Elastic Managed LLM is enabled by default. You can also [configure your own third-party LLM connector](/solutions/security/ai/set-up-connectors-for-large-language-models-llm.md). Keep in mind that different models [perform differently](/solutions/security/ai/large-language-model-performance-matrix.md) on different tasks.
4983

50-
51-
## Features
52-
53-
EASE provides a set of capabilities designed to help make the most of each security analyst’s time, fight alert fatigue, and reduce your mean time to respond. Once your data is ingested, you can start using the following features:
54-
55-
- **[Attack Discovery](/solutions/security/ai/attack-discovery.md)**: Helps you analyze alerts in your environment and identify threats. Each discovery represents a potential attack and describes relationships among multiple alerts to tell you which users and hosts are involved, how alerts correspond to the MITRE ATT&CK matrix, and which threat actor might be responsible.
56-
57-
:::{image} /solutions/images/security-attck-disc-example-disc.png
58-
:alt: Attack Discovery detail view
59-
:width: 600px
60-
:::
61-
62-
You can [schedule](/solutions/security/ai/attack-discovery.md#schedule-discoveries) Attack Discovery to run automatically, and notify you of any discoveries through a range of connectors such as Slack, Teams, PagerDuty, or email.
63-
64-
- **[AI Assistant](/solutions/security/ai/ai-assistant.md)**: An LLM-powered virtual assistant specialized for digital security; it helps with data analysis, alert investigation, incident response, and {{esql}} query generation. You can add custom background knowledge and data to its [knowledge base](/solutions/security/ai/ai-assistant-knowledge-base.md) and use natural language to ask for its assistance with your SOC operations.
65-
66-
:::{image} /solutions/images/security-ease-ai-assistant.png
67-
:alt: A new conversation with AI Assistant
68-
:width: 450px
69-
:::
70-
71-
You can add custom information to AI Assistant's [Knowledge Base](/solutions/security/ai/ai-assistant-knowledge-base.md), either in the form of individual documents or entire indices containing numerous documents. This information informs the AI Assistant's responses and can include everything from threat intelligence, to information about your team's on-call rotation, to information about your infrastructure, and more.
72-
73-
- **[Cases](/solutions/security/investigate/cases.md)**: Helps you track and share related information about security issues. Track key investigation details and collect alerts in a central location.
74-
75-
:::{image} /solutions/images/security-ease-cases.png
76-
:alt: The Cases page in an EASE project showing the default state
77-
:::
78-

solutions/security/ai/ease/ease-value-report.md

Lines changed: 19 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -3,18 +3,29 @@ navigation_title: Value report
33
applies_to:
44
serverless:
55
security: preview
6+
stack: preview 9.3
67
---
78

8-
# EASE Value Report
9+
# Value report
910

10-
The **Value report** page estimates your savings from using Elastic AI SOC Engine (EASE) for alert triage, in terms of **Analyst time saved** and **Cost Savings**. The message at the top of the page explains how those numbers were determined, and how many alerts were **Escalated** and **Filtered** by AI.
11+
:::{include} /solutions/_snippets/value-report-intro.md
12+
:::
1113

12-
You can interact with the page in the following ways:
14+
## Requirements
1315

14-
- **Update the time range:** Use the time selector in the upper right corner to select the time range for which to show value metrics.
15-
- **Export report:** Select **Export report** in the upper right corner to download a sharable PDF of the value report.
16+
```{applies_to}
17+
serverless: preview
18+
stack: preview 9.3
19+
```
1620

21+
* To access the **Value report** page, your subscription must include AI-powered features. For {{sec-serverless}}, this means you need either the Elastic AI SOC Engine (EASE) or Security Analytics Complete [feature tier](https://www.elastic.co/pricing/serverless-security).
1722

18-
:::{image} /solutions/images/security-ease-value-report.png
19-
:alt: The Value Report in an EASE project
20-
:::
23+
* To access the **Value report** page, you need the **SOC Management** Security sub-feature [{{kib}} privilege](/deploy-manage/users-roles/cluster-or-deployment-auth/kibana-privileges.md).
24+
25+
![value report RBAC setting](/solutions/images/security-value-report-rbac.png "=50%")
26+
27+
::::{note}
28+
The following default roles have the **SOC Management** privilege by default:
29+
- EASE feature tier: ` _search_ai_lake_soc_manager`
30+
- Security Analytics Complete: `admin` and `soc_manager`
31+
::::

solutions/toc.yml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -558,7 +558,6 @@ toc:
558558
- file: security/ai/ease/ease-intro.md
559559
children:
560560
- file: security/ai/ease/ease-alerts.md
561-
- file: security/ai/ease/ease-value-report.md
562561
- file: security/ai/ease/ease-upgrade.md
563562
- file: security/ai/ai-assistant.md
564563
children:
@@ -578,6 +577,7 @@ toc:
578577
- file: security/ai/triage-alerts.md
579578
- file: security/ai/identify-investigate-document-threats.md
580579
- file: security/ai/generate-customize-learn-about-esorql-queries.md
580+
- file: security/ai/ease/ease-value-report.md
581581
- file: security/detect-and-alert.md
582582
children:
583583
- file: security/detect-and-alert/detections-requirements.md

0 commit comments

Comments
 (0)