Skip to content

Commit 476902b

Browse files
Merge pull request #4696 from MicrosoftDocs/main
[AutoPublish] main to live - 08/07 07:34 PDT | 08/07 20:04 IST
2 parents 76566a6 + cb0a6b4 commit 476902b

File tree

2 files changed

+23
-9
lines changed

2 files changed

+23
-9
lines changed

defender-xdr/advanced-hunting-cloudstorageaggregatedevents-table.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -28,7 +28,7 @@ ms.date: 08/05/2025
2828

2929
[!INCLUDE [Microsoft Defender XDR rebranding](../includes/microsoft-defender.md)]
3030

31-
The `CloudStorageAggregatedEvents` table in the [advanced hunting](advanced-hunting-overview.md) contains information about storage activity and related events. Use this reference to construct queries that return information from this table.
31+
The `CloudStorageAggregatedEvents` table in the [advanced hunting](advanced-hunting-overview.md) schema contains information about storage activity and related events. Use this reference to construct queries that return information from this table.
3232

3333
> [!IMPORTANT]
3434
> Some information relates to prereleased product, which may be substantially modified before it's commercially released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

defender-xdr/phishing-triage-agent.md

Lines changed: 22 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -4,8 +4,8 @@ description: Learn about the Security Copilot Phishing Triage Agent, including r
44
ms.service: defender-xdr
55
f1.keywords:
66
- NOCSH
7-
ms.author: diannegali
8-
author: diannegali
7+
ms.author: guywild
8+
author: guywi-ms
99
ms.localizationpriority: medium
1010
manager: deniseb
1111
audience: ITPro
@@ -18,7 +18,7 @@ ms.topic: how-to
1818
search.appverid:
1919
- MOE150
2020
- MET150
21-
ms.date: 06/13/2025
21+
ms.date: 08/07/2025
2222
appliesto:
2323
- Microsoft Defender XDR
2424
- Microsoft Defender for Office 365 Plan 2
@@ -51,6 +51,17 @@ The Phishing Triage Agent is a [Security Copilot agent](/copilot/security/agents
5151
- **Transparent rationale:** The agent provides a transparent rationale for its classification verdicts in natural language, detailing the reasoning behind its conclusions and the evidence used to reach them. Additionally, it presents a visual representation of its reasoning process.
5252
- **Learning based on feedback:** The agent continuously improves based on feedback provided by analysts. Over time, this feedback loop fine-tunes the agent’s behavior, aligning it more closely with organizational nuances and reducing the need for manual verification.
5353

54+
## Permissions required
55+
56+
| Action | Permission required |
57+
|:------------------------------|:----------------------------------------------------------------------------------------------------------------------|
58+
| Set up, pause, remove or the agent | **Security Administrator** in Microsoft Entra ID |
59+
| View and manage agent settings and activity | **Security Copilot (read)** and **Security data basics (read)** under the **Security operations** permissions group in the Defender portal |
60+
| View and manage feedback | **Security Copilot (read)**, **Security data basics (read)**, and **Email & collaboration metadata (read)** under the **Security operations** permissions group in the Defender portal|
61+
|Reject feedback|**Security Administrator** in Microsoft Entra ID|
62+
63+
For more information about unified RBAC in the Defender portal, see [Microsoft Defender XDR Unified role-based access control (RBAC)](/defender-xdr/manage-rbac).
64+
5465
## Prerequisites
5566

5667
The following are organizational requirements to run Phishing Triage Agent in your environment:
@@ -86,7 +97,7 @@ The Phishing Triage Agent addresses phishing incidents that include alerts with
8697
## Set up the Phishing Triage Agent
8798

8899
> [!NOTE]
89-
> Setting up of the Phishing Triage Agent is only available to users with the **Security Administrator** role. Ensure that all [prerequisites](#prerequisites) are met before setting up the agent.
100+
> To set up the Phishing Triage Agent, you need the **Security Administrator** role in Microsoft Entra ID. Ensure that all [prerequisites](#prerequisites) are met before setting up the agent.
90101
91102
### Create the agent’s identity and assign permissions
92103

@@ -157,6 +168,9 @@ You can access the Phishing Triage Agent setup in two ways:
157168

158169
:::image type="content" source="/defender/media/agents-in-defender/phishing-triage/phishing-triage-setup.png" alt-text="Screenshot of the Overview page for the Phishing Triage set up" lightbox="/defender/media/agents-in-defender/phishing-triage/phishing-triage-setup.png":::
159170

171+
> [!NOTE]
172+
> To view and manage setting in the Defender portal, you need **Security Copilot (read)** and **Security data basics (read)** permissions. If you don't have these permissions, you can't intiate setup from the **Settings** page, but you can still set up the agent from the incident queue if you have the **Security Administrator** role.
173+
160174
Follow the steps in the setup wizard, which includes:
161175

162176
1. Select the [identity](#identity) type to assign to the agent.
@@ -273,7 +287,7 @@ Here are examples of how you can write your feedback to the agent.
273287
| Feedback about the sender and email body | Emails offering file sharing or document access should only come from our authorized provider Contoso.com. | Emails offering file sharing or document access should only come from our authorized providers. | Well-written feedback clearly states specific requirements (for example, sender domain), while vague references (for example “authorized providers”) do not contain actionable information. |
274288
| Feedback about email subject | Any email that its subject contains a request for billing transaction is not allowed in our organization and is considered as phishing. | If the subject has a positive natural sentiment, it’s legitimate. | Feedback that is descriptive and specific can be effectively validated, while subjective feedback may lead to unintended outcomes. |
275289
| Feedback about the email body | Emails requesting credential verification should include a reference to the specific account or service. Any generic 'verify your account' request without details should be treated as phishing. | This email should be treated as phishing. | Feedback that includes detailed information is more likely to be clearly understood, while feedback lacking detail may be interpreted in various ways and could lead to unpredictable outcomes. |
276-
| Feedback about a recipient and email body | This email was sent to multiple employees, and the body instructs recipients to download an 'important attachment' without describing its contents—legitimate emails always specify attachment details. | Mass internal emails with attachments are phishing. | Feedback that highlights specific missing details commonly found in legitimate emails is more effective. Feedback that contains broad generalizations (mass emails) or vague terms (such as “internal”) may lead to an excessive amount of true positives. |
290+
| Feedback about a recipient and email body | This email was sent to multiple employees, and the body instructs recipients to download an 'important attachment' without describing its contents—legitimate emails always specify attachment details. | Mass internal emails with attachments are phishing. | Feedback that highlights specific missing details commonly found in legitimate emails is more effective. Feedback that contains broad generalizations (mass emails) or vague terms (such as “internal”) may lead to an excessive number of true positives. |
277291
| Feedback about a recipient and a domain | New contractor onboarding emails should only be sent to email addresses starting with 'v-' to ensure they are directed to the correct recipients. | Contractor emails look different from usual, so they might be phishing. | Well-written feedback clearly defines the expected recipient format, while feedback that is indecisive (“might be”) and lacks clear identification criteria (“looks different from usual” without specifying what is different), makes detection unreliable. |
278292

279293

@@ -297,7 +311,7 @@ Once the agent is taught and equipped with organizational knowledge, it begins t
297311
## Manage the Phishing Triage Agent
298312

299313
> [!NOTE]
300-
> Viewing and managing the Phishing Triage Agent settings is only available to users with the **Security Copilot (read)** and **Security data basics (read)** permissions.
314+
> To view and manage Phishing Triage Agent settings, you need **Security Copilot (read)** and **Security data basics (read)** permissions.
301315
302316
You can manage the Phishing Triage Agent’s settings, review its activity, and review user interaction with the agent. To do so, select **Manage agent** in the card above the incident queue. Alternatively, you can navigate to **Settings > Microsoft Defender XDR > Agents**.
303317

@@ -311,7 +325,7 @@ To view all previous runs by the agent:
311325
### View and manage feedback to the agent
312326

313327
> [!NOTE]
314-
> Managing feedback is only available to users with the **Security Copilot (read)**, **Security data basics (read)**, and **Email & collaboration metadata (read)** permissions.
328+
> To manage feedback, you need **Security Copilot (read)**, **Security data basics (read)**, and **Email & collaboration metadata (read)** permissions.
315329
316330
The Phishing Triage Agent uses feedback to improve its performance over time. It stores applicable feedback in its memory as lessons. You can view and manage user-submitted feedback for the Phishing Triage Agent by navigating to the Feedback management page.
317331

@@ -342,7 +356,7 @@ To review the details of a specific feedback, select an entry from the feedback
342356
:::image type="content" source="/defender/media/agents-in-defender/phishing-triage/review-feedback-pane.png" alt-text="Screenshot of the Review feedback pane" lightbox="/defender/media/agents-in-defender/phishing-triage/review-feedback-pane.png":::
343357

344358
> [!NOTE]
345-
> Rejecting feedback provided to the agent is only available to users with the **Security Administrator** role.
359+
> To reject feedback provided, you need the **Security Administrator** role in Microsoft Entra ID.
346360
347361
To reject specific feedback, open the Review feedback pane and select **Reject feedback**. When you do so, the agent records it as rejected and stops using it in future triage decisions.
348362

0 commit comments

Comments
 (0)