You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: defender-for-cloud-apps/ai-agent-inventory.md
+28-15Lines changed: 28 additions & 15 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -10,24 +10,22 @@ ms.reviewer: gayasalomon
10
10
#customer-intent: As a security administrator, I want view all of the AI Agents in my organization, and detect threats on my AI agents using advanced hunting.
11
11
---
12
12
13
-
# Discover and protect your Copilot Studio custom AI Agents (Preview)
13
+
# Discover and protect your custom AI Agents (Preview)
14
14
15
15
Microsoft Defender detects all Copilot Studio custom AI agents in your tenant and provides tools to identify misconfigured or potentially risky agents, and collects data from Copilot Studio for use in [advanced hunting](/defender-xdr/advanced-hunting-overview).
16
16
17
17
## Prerequisites
18
-
To enable AI agent threat protection inventory and detection you must opt in to public preview features of:
18
+
To enable AI agent inventory and detection you must opt in to the [Microsoft Defender preview features](https://security.microsoft.com/securitysettings/defender/preview_features) of:
19
19
- Microsoft Defender for Cloud Apps
20
20
- Microsoft Defender for Cloud
21
21
- Microsoft Defender XDR
22
22
23
-
For more information, see [Microsoft Defender preview features](https://security.microsoft.com/securitysettings/defender/preview_features).
24
-
25
-
## Enable Copilot Studio AI agent threat protection inventory
23
+
## Enable the Copilot Studio AI agent inventory
26
24
27
25
> [!NOTE]
28
-
> The onboarding process for AI Agent threat protection inventory requires collaboration with Power Platform administrators.
26
+
> The onboarding process for the AI agent inventory requires collaboration with Power Platform administrators.
29
27
30
-
To enable Copilot Studio AI agent threat protection inventory, follow these steps:
28
+
To enable the Copilot Studio AI agent inventory, follow these steps:
31
29
32
30
1.**Sign in to the [Microsoft Defender portal](https://security.microsoft.com)** as the System Administrator.
33
31
1. Go to **System > Settings > Cloud Apps > Copilot Studio AI Agents**.
@@ -42,19 +40,34 @@ To enable Copilot Studio AI agent threat protection inventory, follow these step
42
40
When Copilot Studio AI Agents are connected, a green indicator appears in the **AI Agents Inventory** section in the Microsoft Defender system settings. It can take up to 30 minutes for the initial connection status to update. Depending on the size and complexity of your environment, it might take longer to see the full deployment of the AI agent inventory.
43
41
44
42
45
-
## Identify misconfigured or risky AI agents
43
+
## Identify misconfigured or risky AI agents using advanced hunting
46
44
47
45
After you give Microsoft Defender access to your custom agents, you can use advanced hunting to help identify misconfigured or risky agents and minimize organizational exposure to potential threats.
46
+
We recommend that you reach out to the owners of the risky agents for more information, and that you consider quarantining or deleting risky agents.
47
+
48
+
1. Sign in to the Defender portal, and go **Investigation & response** -> **Hunting** -> **Advanced hunting**.
49
+
1. In the **Apps & identities** section, the [AIAgentsInfo table](/defender-xdr/advanced-hunting-aiagentsinfo-table) contains data for all your custom AI agents created using Copilot Studio. You can use this data to create custom queries.
50
+
51
+
### Sample queries
52
+
53
+
Run this query to get a list of all the agents in your tenant:
54
+
55
+
```kusto
56
+
AIAgentsInfo
57
+
| summarize arg_max(Timestamp, *) by AIAgentId
58
+
```
48
59
49
-
1. Sign in to the Defender portal, and go to **Advanced hunting**.
50
-
1. In the **Apps & identities** section, the [AIAgentsInfo](/defender-xdr/advanced-hunting-aiagentsinfo-table) contains data for all your custom AI agents created using Copilot Studio. You can use this data to create custom queries.
51
-
1. In the **Queries** tab, see the **MCS AI Agents** section for predefined KQL queries to help identify misconfigured or risky agents.
60
+
Run this query to identify all published agents that are configured with an incorrect authentication mechanism:
52
61
53
-
For example, you can use queries to: :
54
-
- locate published agents that use maker authentication mechanisms, which might allow access to data users shouldn't have
55
-
- locate published agents that haven't been used for over 30 days, as they might create unnecessary exposure without contributing to productivity.
62
+
```kusto
63
+
AIAgentsInfo
64
+
| summarize arg_max(Timestamp, *) by AIAgentId
65
+
| where AgentStatus != "Deleted"
66
+
| where AgentStatus == "Published"
67
+
| where UserAuthenticationType == "None" or AuthenticationTrigger == "As Needed"
We recommend that you reach out to the owners of the risky agents for more information, and that you consider quarantining or deleting the risky agents.
58
71
59
72
See [Proactively hunt for threats with advanced hunting in Microsoft Defender](/defender-xdr/advanced-hunting-overview) to learn how to use queries to proactively hunt for threats.
Copy file name to clipboardExpand all lines: defender-for-cloud-apps/ai-agent-protection.md
+8-8Lines changed: 8 additions & 8 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -8,20 +8,20 @@ ms.reviewer: gayasalomon
8
8
#customer-intent: As a security administrator, I want my Copilot Studio AI agents to be protected against suspicious or harmful actions so that I can reduce security risks to my organization.
9
9
---
10
10
11
-
# Protect your Microsoft Copilot Studio AI agents (Preview)
11
+
# Protect your Microsoft Copilot Studio custom AI agents (Preview)
12
12
13
-
As no code/low code platforms become increasingly accessible, organizations face new types of security risks. These platforms empower non-technical users to build and deploy custom agents without centralized security review or controls in place. Attackers can attempt to manipulate these agents by:
14
-
-injecting malicious prompts
15
-
-triggering unintended tool executions
16
-
-exploiting data sources to escalate privileges or exfiltrate data.
13
+
As No code/Low code platforms become increasingly accessible, organizations face new types of security risks. These platforms empower non-technical users to build and deploy custom agents without centralized security review or controls in place. Attackers can attempt to manipulate these agents by:
14
+
-Injecting malicious prompts
15
+
-Triggering unintended tool executions
16
+
-Exploiting data sources to escalate privileges or exfiltrate data.
17
17
18
-
## AI agent threat protection features
18
+
## AI agent protection features
19
19
20
20
Microsoft Defender addresses critical security gaps with comprehensive AI agent protection that includes proactive exposure, threat hunting, real time protection, and alerts. With AI agent protection, Microsoft Defender:
21
21
22
-
- Detects all of your custom AI agents created with Microsoft Copilot Studio, and integrates their data into advanced hunting for proactive threat detection. You can use this data to create custom queries and hunt for potential threats. See [Copilot Studio AI agent threat protection inventory (Preview)](ai-agent-inventory.md) to learn how to set up and make use of the AI agent inventory.
22
+
- Detects all of your custom AI agents created with Microsoft Copilot Studio, and integrates their data into advanced hunting for proactive threat detection. You can use this data to create custom queries and hunt for potential threats. See [Copilot Studio AI agent inventory (Preview)](ai-agent-inventory.md) to learn how to set up and make use of the AI agent inventory.
23
23
- Collects audit logs for your custom AI agents created with Copilot Studio, continuously monitors the agents for suspicious acitivity, and enables detections and alerts. To enable this monitoring, make sure that you:
24
-
-[Enable the AI agent threat protection inventory](ai-agent-inventory.md#enable-copilot-studio-ai-agent-threat-protection-inventory).
24
+
-[Enable the AI agent inventory](ai-agent-inventory.md#enable-copilot-studio-ai-agent-threat-protection-inventory).
25
25
-[Enable the Microsoft 365 app connector](protect-office-365.md#connect-microsoft-365-to-microsoft-defender-for-cloud-apps).
26
26
- Provides real-time protection to block suspicious or harmful actions initiated by your AI agents, and triggers an informative alert integrated into the XDR incidents and alerts environment. See [Enable real-time protection for Microsoft Copilot Studio Agents](/real-time-agent-protection-during-runtime.md) to learn how to set up real-time protection.
0 commit comments