Skip to content

Commit 57c2342

Browse files
committed
Add SCU role requirements for entity analyzer
Update ms.date and add documentation about Security Compute Units (SCUs) and required roles for the entity analyzer tool. The changes introduce prerequisites noting that Security Reader and Security Copilot Contributor are needed to run the analyzer and Security Copilot Owner is required to view SCU usage, and add an IMPORTANT callout explaining SCU usage and role requirements.
1 parent 53ebbca commit 57c2342

1 file changed

Lines changed: 10 additions & 1 deletion

File tree

articles/sentinel/datalake/sentinel-mcp-data-exploration-tool.md

Lines changed: 10 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ titleSuffix: Microsoft Security
44
description: Learn about the different tools available in the Data exploration collection in Microsoft Sentinel
55
author: poliveria
66
ms.topic: how-to
7-
ms.date: 04/02/2026
7+
ms.date: 04/08/2026
88
ms.author: pauloliveria
99
ms.service: microsoft-sentinel
1010
ms.subservice: sentinel-platform
@@ -29,6 +29,10 @@ To access the data exploration tool collection, you need the following prerequis
2929
- [Microsoft Foundry](sentinel-mcp-use-tool-azure-ai-foundry.md#add-a-microsoft-sentinel-tool-collection)
3030
- [Visual Studio Code](sentinel-mcp-use-tool-visual-studio-code.md)
3131

32+
To use the [entity analyzer tool](#entity-analyzer), you also need the following roles:
33+
- **Security Reader** and **Security Copilot Contributor** - To use the tool, which uses [Security Compute Units (SCUs)](/copilot/security/manage-usage) to deliver the reasoned entity risk analysis.
34+
- **Security Copilot Owner** - To view SCU usage. For more information, see [Understand authentication in Microsoft Security Copilot](/copilot/security/authentication).
35+
3236
## Add the data exploration collection
3337

3438
To add the data exploration collection, first set up Microsoft Sentinel's unified MCP server interface. Follow the step-by-step instructions for compatible [AI-powered code editors and agent-building platforms](sentinel-mcp-get-started.md#add-microsoft-sentinels-collection-of-mcp-tools).
@@ -78,6 +82,11 @@ For example, `analyze_user_entity` reasons over the user's authentication patter
7882

7983
Entity analysis tools might require a few minutes to generate results, so there are tools to start analysis for each entity and another one that polls for the analysis results.
8084

85+
> [!IMPORTANT]
86+
> This tool uses [Security Compute Units (SCUs)](/copilot/security/manage-usage) to deliver the reasoned entity risk analysis, so you need to have the **Security Reader** and **Security Copilot Contributor** roles to use it and generate results.
87+
>
88+
> To view SCU usage, you also need to have the **Security Copilot Owner** role. For more information, see [Understand authentication in Microsoft Security Copilot](/copilot/security/authentication).
89+
8190
#### Start analysis (`analyze_user_entity` and `analyze_url_entity`)
8291

8392
| Parameters | Required? | Description |

0 commit comments

Comments
 (0)