Blog
/
Network
/
November 6, 2023

How PlugX Malware Has Evolved & Adapted

Discover how Darktrace effectively detected and thwarted the PlugX remote access trojan in 2023 despite its highly evasive and adaptive nature.
Inside the SOC
Darktrace cyber analysts are world-class experts in threat intelligence, threat hunting and incident response, and provide 24/7 SOC support to thousands of Darktrace customers around the globe. Inside the SOC is exclusively authored by these experts, providing analysis of cyber incidents and threat trends, based on real-world experience in the field.
Written by
Nahisha Nobregas
Associate Principal Cyber Analyst & Team Lead
Default blog image
06
Nov 2023

What is PlugX Remote Access Trojan?

Understanding remote access trojans (RATs)

As malicious actors across the threat landscape continue to pursue more efficient and effective ways of compromising target networks, all while remaining undetected by security measures, it is unsurprising to see an increase in the use of remote access trojans (RATs) in recent years. RATs typically operate stealthily, evading security tools while offering threat actors remote control over infected devices, allowing attackers to execute a wide range of malicious activities like data theft or installing additional malware.

Definition and general functionality of RATs: A Remote Access Trojan (RAT) is a type of malware that enables unauthorized remote control of an infected computer. Once installed, RATs allow attackers to monitor user activities, steal sensitive information, manipulate files, and execute commands. RATs are typically distributed via phishing emails, malicious attachments, drive-by downloads, or exploiting software vulnerabilities. Due to their ability to provide comprehensive control over a compromised system, RATs pose a significant security threat to individuals and organizations.

Historical overview of PlugX

PlugX is one such example of a RAT that has attributed to Chinese threat actors such as Mustang Panda, since it first appeared in the wild back in 2008. It is known for its use in espionage, a modular and plug-in style approach to malware development. It has the ability to evolve with the latest tactics, techniques, and procedures (TTPs) that allow it to avoid the detection of traditional security tools as it implants itself target devices.

How does PlugX work?

The ultimate goal of any RAT is to remotely control affected devices with a wide range of capabilities, which in PlugX’s case has typically included rebooting systems, keylogging, managing critical system processes, and file upload/downloads. One technique PlugX heavily relies on is dynamic-link library (DLL) sideloading to infiltrate devices. This technique involves executing a malicious payload that is embedded within a benign executable found in a data link library (DLL) [1]. The embedded payload within the DLL is often encrypted or obfuscated to prevent detection.

What’s more, a new variant of PlugX was observed in the wild across Papua New Guinea, Ghana, Mongolia, Zimbabwe, and Nigeria in August 2022, that added several new capabilities to its toolbox.

Key capabilities of PlugX

The new variation is reported to continuously monitor affected environments for new USB devices to infect, allowing it to spread further through compromised networks [2]. It is then able to hide malicious files within a USB device by using a novel technique that prevents them from being viewed on Windows operating systems (OS). These hidden files can only be viewed on a Unix-like (.nix) OS, or by analyzing an affected USB devices with a forensic tool [2]. The new PlugX variant also has the ability to create a hidden directory, “RECYCLER.BIN”, containing a collection of stolen documents, likely in preparation for exfiltration via its command and control (C2) channels. [3]

Since December 2022, PlugX has been observed targeting networks in Europe through malware delivery via HTML smuggling campaigns, a technique that has been dubbed SmugX [4].

This evasive tactic allows threat actors to prepare and deploy malware via phishing campaigns by exploiting legitimate HTML5 and JavaScript features [5].

Darktrace Coverage of PlugX

Between January and March 2023, Darktrace observed activity relating to the PlugX RAT on multiple customers across the fleet. While PlugX’s TTPs may have bypassed traditional security tools, the anomaly-based detection capabilities of Darktrace allowed it to identify and alert the subtle deviations in the behavior of affected devices, while Darktrace was able to take immediate mitigative action against such anomalous activity and stop attackers in their tracks.  

C2 Communication

Between January and March 2023, Darktrace detected multiple suspicious connections related to the PlugX RAT within customer environments. When a device has been infected, it will typically communicate through C2 infrastructure established for the PlugX RAT. In most cases observed by Darktrace, affected devices exhibited suspicious C2 connections to rare endpoints that were assessed with moderate to high confidence to be linked to PlugX.

On the network of one Darktrace customer the observed communication was a mix of successful and unsuccessful connections at a high volume to rare endpoints on ports such as 110, 443, 5938, and 80. These ports are commonly associated with POP3, HTTPS, TeamViewer RDP / DynGate, and HTTP, respectively.  Figure 1 below showcases this pattern of activity.

Figure 1: Model Breach Event Log demonstrating various successful and unsuccessful connections to the PlugX C2 endpoint 103.56.53[.]46 via various destination ports.

On another customer’s network, Darktrace observed C2 communication involving multiple failed connection attempts to another rare external endpoint associated with PlugX. The device in this case was detected attempting connections to the endpoint, 45.142.166[.]112 on ports 110, 80, and 443 which caused the DETECT model ‘Anomalous Connection / Multiple Failed Connections to Rare Endpoint’ to breach. This model examines devices attempting connections to a rare external endpoint over a short period of time, and it breached in response to almost all PlugX C2 related activity detected by Darktrace. This highlights Darktrace DETECT’s unique ability to identify anomalous activity which appears benign or uncertain, rather than relying on traditional signature-based detections.

Figure 2: Device Event Log demonstrating various successful and unsuccessful connections to the PlugX C2 endpoint 45.142.166[.]112 via various destination on January 27, 2023.

New User Agent

Darktrace's Self-Learning AI approach to threat detection also allowed it to recognize connections to PlugX associated endpoints that utilized a new user agent. In almost all connections to PlugX endpoints detected by Darktrace, the same user agent, Mozilla/5.0 (Windows NT 10.0;Win64;x64)AppleWebKit/537.36, was observed, illustrating a clear pattern in PlugX-related activity

In one example from February 2023, an affected device successfully connected to an endpoint associated with PlugX, 45.142.166[.]112, while using the aforementioned new user agent, as depicted in Figure 3.

Figure 3: The Device Event log above showcases a successful connection to the PlugX associated IP address, 45.142.166[.]112 using the new user agent ‘Mozilla/5.0 (Windows NT 10.0;Win64;x64)AppleWebKit/537.36’.

On March 21, 2023, Darktrace observed similar activity on a separate customer’s network affected by connections to PlugX. This activity included connections to the same endpoint, 45.142.166[.]112. The connection was an HTTP POST request made via proxy with the same new user agent, ‘Mozilla/5.0 (Windows NT 10.0;Win64;x64)AppleWebKit/537.36’. When investigated further this user agent actually reveals very little about itself and appears to be missing a couple of common features that are typically contained in a user agent string, such as a web browser and its version or the mention of Safari before its build ID (‘537.36’).

Additionally, for this connection the URI observed consisted of a random string of 8 hexadecimal characters, namely ‘d819f07a’. This is a technique often used by malware to communicate with its C2 servers, while evading the detection of signature-based detection tools. Darktrace, however, recognized that this external connection to an endpoint with no hostname constituted anomalous behavior, and could have been indicative of a threat actor communicating with malicious infrastructure, thus the ‘Anomalous Connection / Possible Callback URI’ model was breached.

Figure 4: An affected device was detected using the new user agent, ‘Mozilla/5.0 (Windows NT 10.0;Win64;x64)AppleWebKit/537.36’ while connecting to the rare external endpoint 45.142.166[.]112 via proxy.

Numeric File Download

Darktrace’s detection of PlugX activity on another customer’s network, in February 2023, helped to demonstrate related patterns of activity within the C2 communication and tooling attack phases. Observed PlugX activity on this network followed the subsequent pattern; a connection to a PlugX endpoints is made, followed by a HTTP POST request to a numeric URI with a random string of 8 hexadecimal characters, as previously highlighted. Darktrace identified that this activity represented unusual ‘New Activity’ for this device, and thus treated it with suspicion.

Figure 5: New activity was identified by Darktrace in the Device Event Log shown above for connections to the endpoint 45.142.166[.]112 followed by HTTP POSTs to URIs “/8891431c” and “/ba12b866” on February 15, 2023.

The device in question continued to connect to the endpoint and make HTTP POST connections to various URIs relating to PlugX. Additionally, the user agent `Mozilla/5.0 (Windows NT 10.0;Win64;x64)AppleWebKit/537.36` was again detected for these connections. Figure 6 details the activity captured by Darktrace’s Cyber AI Analyst.

Figure 6: The image above showcases activity captured by Darktrace’s AI Analyst for PlugX connections made on February 15, 2023.

Darktrace detected that during these connections, the device in question attempted to download a suspicious file named only with numbers. The use of numeric file names is a technique often used by threat actors to obfuscate the download of malicious files or programs and bypass traditional security tools. Darktrace understood that the download of a numeric file, coupled with the use of an anomalous new user agent, mean the incident should be treated with suspicion. Fortunately, Darktrace RESPOND was enabled in autonomous response mode during this attack, meaning it was able to automatically block the device from downloading the file, or any other files, from the suspicious external location for a two-hour period, potentially preventing the download of PlugX’s malicious tooling.

Conclusion

Amid the continued evolution of PlugX from an espionage tool to a more widely available malware, it is essential that threat detection does not rely on a set of characteristics or indicators, but rather is focused on anomalies. Throughout these cases, Darktrace demonstrated the efficacy of its detection and alerting on emerging activity pertaining to a particularly stealthy and versatile RAT. Over the years, PlugX has continually looked to evolve and survive in the ever-changing threat landscape by adapting new capabilities and TTPs through which it can infect a system and spread to new devices without being noticed by security teams and their tools.

However, Darktrace’s Self-Learning AI allows it to gain a strong understanding of customer networks, learning what constitutes expected network behavior which in turn allows it to recognize the subtle deviations indicative of an ongoing compromise.

Darktrace’s ability to identify emerging threats through anomaly-based detection, rather than relying on established threat intelligence, uniquely positions it to detect and respond to highly adaptable and dynamic threats, like the PlugX malware, regardless of how it may evolve in the future.

Credit to: Nahisha Nobregas, SOC Analyst & Dylan Hinz, Cyber Analyst

Appendices

MITRE ATT&CK Framework

Execution

  • T1059.003 Command and Scripting Interpreter: Windows Command Shell

Persistence and Privilege Escalation

  • T1547.001 Boot or Logon AutoStart Execution: Registry Run Keys / Startup Folder
  • T1574.001 Hijack Execution Flow: DLL Search Order Hijacking
  • T1574.002 Hijack Execution Flow: DLL Side-Loading
  • T1543.003 Create or Modify System Process: Windows Service
  • T1140 Deobfuscate / Decode Files or Information
  • T1083 File and Directory Discovery

Defense Evasion

  • T1564.001 Hide Artifacts: Hidden Files and Directories
  • T1036.004 Masquerading: Task or Service
  • T1036.005 Masquerading: Match Legitimate Name or Location
  • T1027.006 Obfuscated Files or Information: HTML Smuggling

Credential Access

  • T1056.001 Input Capture: Keylogging

Collection

  • T1105 Ingress Tool Transfer

Command and Control

  • T1573.001 Encrypted Channel: Symmetric Cryptography
  • T1070.003 Mail Protocols
  • T1071.001 Web Protocol

DETECT Model Breaches

  • Anomalous Connection / Multiple Failed Connections to Rare Endpoint
  • Anomalous Connection / New User Agent to IP Without Hostname
  • Anomalous File / New User Agent Followed By Numeric File Download
  • Anomalous Connection / Possible Callback URL

Indicators of Compromise (IoCs)

IoC - Type - Description + Confidence

45.142.166[.]112 - IP - PlugX C2 Endpoint / moderate - high

103.56.53[.]46 - IP - PlugX C2 Endpoint / moderate - high

Mozilla/5.0 (Windows NT 10.0;Win64;x64)AppleWebKit/537.36 - User Agent - PlugX User Agent / moderate – high

/8891431c - URI - PlugX URI / moderate-high

/ba12b866 - URI - PlugX URI / moderate -high

References

1. https://www.crowdstrike.com/blog/dll-side-loading-how-to-combat-threat-actor-evasion-techniques/

2. https://unit42.paloaltonetworks.com/plugx-variants-in-usbs/

3. https://news.sophos.com/en-us/2023/03/09/border-hopping-plugx-usb-worm/

4. https://thehackernews.com/2023/07/chinese-hackers-use-html-smuggling-to.html

5. https://www.cyfirma.com/outofband/html-smuggling-a-stealthier-approach-to-deliver-malware/

Inside the SOC
Darktrace cyber analysts are world-class experts in threat intelligence, threat hunting and incident response, and provide 24/7 SOC support to thousands of Darktrace customers around the globe. Inside the SOC is exclusively authored by these experts, providing analysis of cyber incidents and threat trends, based on real-world experience in the field.
Written by
Nahisha Nobregas
Associate Principal Cyber Analyst & Team Lead

More in this series

No items found.

Blog

/

AI

/

November 17, 2026

How Microsoft and Darktrace Secure the AI-Powered Enterprise

Default blog imageDefault blog image

When legitimate activity creates business risk

AI is making information more accessible and enabling autonomous agents to act across enterprise systems. But legitimate access can still result in sensitive-data exposure, unintended actions, or activity that deviates from business expectations.

Microsoft's evolving security strategy recognizes this shift, emphasizing continuous risk assessment, stronger identity protection, and security that adapts as AI systems operate. For enterprises, the challenge is increasingly about recognizing when trusted activity introduces risk, even when existing controls are functioning as intended.

Where global intelligence meets deep business context

Microsoft brings global threat intelligence and comprehensive security capabilities, helping organizations protect identities, data, applications, and infrastructure. Its integrated approach connects security signals, governance, detection, and response across increasingly complex environments.

Darktrace complements these strengths with deep, organization-specific behavioral understanding. Powered by Adaptive AI, Darktrace continuously learns the patterns and relationships unique to each business, developing a Unique Behavioral Profile for each organization that helps distinguish meaningful threats from legitimate activity. By connecting identity, activity, context, and intent, it adds another dimension to security intelligence.

Together, Microsoft and Darktrace combine global intelligence with deeper knowledge of how each customer operates. Through supported integrations, this behavioral context enriches existing Microsoft security workflows, enabling more informed investigations and precise response.

This complementary approach extends across three interconnected areas of enterprise security- AI, People and Infrastructure. From understanding how AI and agents operate to protecting trusted communications and the infrastructure businesses depend on, Darktrace strengthens Microsoft's security capabilities with behavioral insight specific to each organization.

Understanding AI beyond permissions and policies

As AI moves into business-critical operations, security teams need to understand more than which applications and agents are approved. They need visibility into how AI is used, what information it accesses, and whether its actions remain aligned with business intent.

Microsoft provides extensive AI development, governance, and security capabilities. Darktrace / SECURE AI complements these with behavioral analysis across Shadow AI, prompts, agent identities and actions, and development risk. Policy Manager helps evaluate activity against organizational AI policies, while the announced integration with Microsoft Agent 365 is designed to enrich agent risk assessments with organization-specific behavioral signals. Together, these capabilities help organizations scale AI adoption with greater confidence.

Recognizing risk within trusted relationships

Sophisticated threats increasingly exploit established business relationships, familiar communications, and legitimate accounts. A message from a trusted supplier or an action taken through an authorized identity may appear routine until considered against the organization's normal behavior.

Darktrace / EMAIL complements Microsoft's native email, identity, and data protection capabilities by understanding how people and organizations communicate. This enables more precise detection of targeted phishing, business email compromise, account takeover, and data loss, supported by proportionate response. Integrations such as Unified Quarantine within Microsoft Defender for Office 365 bring this additional protection into existing security workflows.

Seeing the bigger picture behind an attack across domains

Threats rarely unfold within a single security domain. Suspicious identity activity, unexpected cloud connections, and unusual network behavior may appear unrelated until the relationships between them reveal a developing attack.

Darktrace / HYBRID NETWORK complements Microsoft's security capabilities with organization-specific behavioral detection across network, cloud, identity, and operational technology. Real-Time AI Analyst, including Cyber AI Analyst, connects related activity into investigated incidents that can be delivered into Microsoft Sentinel, helping security teams accelerate investigations and support targeted containment across the hybrid enterprise.

Turning security intelligence into business confidence

As AI becomes more deeply integrated into business operations, organizations need security that understands not only what technology can access, but how it behaves within their unique environment.

Microsoft and Darktrace bring complementary strengths to that challenge. By connecting global threat intelligence and integrated security capabilities with deep behavioral understanding, the partnership helps organizations recognize emerging risks, respond with greater precision, and strengthen their existing security investments.

The opportunity is to turn security intelligence into meaningful business context, enabling organizations to innovate and operate AI with confidence.

Darktrace named a 2026 Microsoft Partner of the Year Finalist for ISV Innovation

Darktrace has been named a finalist for the 2026 Microsoft Partner of the Year Award in the ISV Innovation category.  

This recognition reflects our collaboration with Microsoft to bring business context to enterprise security. By connecting Microsoft's global threat intelligence and integrated security capabilities with Darktrace's deep behavioral understanding, we help organizations recognize emerging risks and respond with greater precision across AI, People and Infrastructure.

Thank you to Microsoft, our customers, and our teams for their continued collaboration.

Meet Darktrace at Microsoft Ignite and the Microsoft Frontier Tour

Explore how Darktrace and Microsoft are bringing behavioral security to AI, people, and infrastructure.

Join Darktrace at Microsoft Ignite in San Francisco, November 17–19, or connect with our experts as we join the Microsoft Frontier Tour across 21 cities worldwide.

Meet Darktrace at Microsoft Ignite

Connect with Darktrace at the Microsoft Frontier Tour

[related-resource]

Continue reading
About the author

Blog

/

AI

/

November 13, 2026

Introducing Darktrace MCP: Connect your AI assistants to the Darktrace Behavioral Defense Platform

Default blog imageDefault blog image

The Darktrace MCP Server is now generally available to users of the Darktrace Platform Portal. It enables compatible AI assistants to query security data, retrieve Cyber AI Analyst findings, and execute supported actions across actively licensed Darktrace products. Customers can now use these capabilities in their own AI workflows to gather incident context, search telemetry, enrich investigations with information from other services, and carry out triage tasks.

What is MCP?
MCP is an open standard developed by Anthropic that lets AI systems connect to and use enterprise tools and data. Adoption of MCP servers creates an opportunity for SOC teams to move beyond isolated AI experiences toward truly operational AI workflows.

Available capabilities

The server exposes tools for three areas of security work:

  • Incident discovery and threat hunting. Retrieve model alerts and incident groups, search for relevant devices and investigate indicators of compromise. Assistants with access to other services can combine these results with external threat intelligence.
  • Investigation and analysis. Retrieve Cyber AI Analyst incident findings, examine related event data, and enrich the investigation with information from other platforms or external documentation.
  • Triage and workflow actions. Add comments, tags and statuses to alerts and assets, modify supported settings such as trusted domains and subnet details, or trigger a Cyber AI Analyst investigation.

Available capabilities depend on the licensed products connected to the server. The toolset also includes access to Secure AI prompt and shadow AI information, cloud misconfigurations and external exposure information, and Email threat trends and supported management functions.

The following examples show how the server’s discovery, investigation, and action capabilities can be combined within an AI assistant.

Check external threat indicators against your environment

An assistant can use Darktrace MCP alongside external threat intelligence to check whether reported indicators appear in an environment. Darktrace’s tools provide device information and endpoint context; the assistant’s other tools or connected services supply the external intelligence.

In this example, the assistant searched for recent threat reports, selected indicators of compromise (IoCs) to investigate, and checked for devices that had communicated with the reported IP addresses. It then examined endpoint information to put the matches into context.

Relevant Darktrace tools: search_devices, get_endpoint_information, get_model_alerts, get_incident_events

Example prompt: “See what IoCs are appearing in recent threat reports online, identify the most critical one from the last week, and then analyze to see if it exists in my environment.”

AI assistant output using external threat intelligence alongside data retrieved through the Darktrace MCP Server.

Enrich a Cyber AI Analyst investigation

Cyber AI Analyst provides Darktrace’s incident analysis. Through MCP, an assistant can retrieve those findings, explain specific parts of an incident, and bring in related data from other services.

In this example, the assistant examined a Potential AWS Account Hijack investigated by Cyber AI Analyst. It assembled a step-by-step account and raw event timeline, then consulted AWS documentation to add relevant prevention guidance. The assistant brings together the existing Darktrace analysis, supporting events, and external guidance in one response.

Relevant Darktrace tools: get_incident_groups, get_incident_events, get_detailed_events, get_ai_analyst_investigations, advanced_search

Example prompt: “Drill down on the identified potential AWS account hijack. Show me a detailed step-by-step of what happened using data from Cyber AI Analyst, including a raw event timeline, and provide info on how to prevent this from happening again using info from AWS documentation.”

AI assistant output combining Cyber AI Analyst findings and event data with guidance from AWS documentation. Some sensitive content has been redacted.

Work through triage with analyst confirmation

The server’s action tools allow an assistant to support repetitive triage tasks as well as retrieve information. For example, to improve efficiency of a daily triage workflow, an analyst could ask an AI assistant to present untriaged alerts one at a time, summarizing each issue and suggesting a next step for confirmation.

The example below shows the assistant proposing actions such as recording a finding, acknowledging an incident, tagging an asset, or triggering a Cyber AI Analyst investigation for more detail. The analyst chooses how to proceed.

Relevant Darktrace tools: get_model_alerts, update_model_alert, update_incident_group, manage_tags, create_ai_analyst_investigation

Example prompt: “Using the Darktrace MCP server, obtain all un-triaged alerts from the last 3 days and display them one at a time. Provide a summary of the issue, and a suggested triage and immediate response action. I will confirm what action should be performed.”

AI assistant output proposing triage actions using information retrieved through Darktrace MCP and asking the analyst how to proceed. Some sensitive content has been redacted.

Permissions and security considerations

The MCP server provides access to supported capabilities within the products a customer is licensed to use. Connections should follow the principle of least privilege, with access appropriate to the intended workflow.

A read-only connection mode is also available for workflows that do not require changes. This mode hides tools that mutate data; configuration details are provided in the Product Guide.

Some tools can change data or perform actions, including adding or removing asset tags, triggering Cyber AI Analyst investigations, and acting on assets. Consider which capabilities an assistant should be able to use before connecting it and retain human oversight of actions that could cause disruption or unwanted changes.

For further guidance, see:

Seven MCP risks CISOs should consider and how to prepare

Anthropic’s MCP Security Best Practices

Use the interface that suits the task

MCP gives customers another way to work with Darktrace alongside its product interfaces. Users may find that complex investigations requiring visual analysis, or strategic decisions involving impactful actions, are better suited to the graphical interfaces within Darktrace products. They can choose the approach that fits their workflow.

How to start using the Darktrace MCP Server

The Darktrace MCP Server is used to connect a compatible AI assistant to supported tools within your Darktrace deployment. The assistant can retrieve alerts and device information, draw on Cyber AI Analyst findings, and perform permitted actions across your licensed products.

To get started, you will need access to the Darktrace Platform Portal and a compatible AI assistant. Follow the Platform Portal MCP Server guide to find out how to create the required credentials and configure the connection today.

Contact a Darktrace representative to explore how the Darktrace MCP Server can support your security operations.

To learn more about Darktrace can help protect your MCP servers within your broader AI and agent use, discover Darktrace / SECURE AI.

‍

Appendix: Darktrace MCP available tools

The following tool catalogue reflects the list supplied for this announcement. Available tools depend on the connected products and access. The list may change as tools are added or removed.

ToolProductDescription
get_helpGeneral / MCP ServerReturns orientation info about the Darktrace MCP server: its purpose, tool categories, and documentation.
get_productsGeneral / MCP ServerLists available Darktrace product instances and their instance_id values needed by other tools.
submit_feedbackGeneral / MCP ServerLogs feedback about tool coverage, clarity, or usability for the Darktrace team.
count_devicesThreat VisualizerReturns the total count of devices/assets managed by Darktrace.
search_devicesThreat VisualizerSearches for devices by keyword and returns basic matching device details.
query_devicesThreat VisualizerQueries comprehensive device information using filters like IP, MAC, subnet, or SaaS module.
edit_deviceThreat VisualizerUpdates a device's label, type, priority, or notes.
get_device_activityThreat VisualizerReturns aggregated time-series data of a device's connection/data volume trends over 4 weeks.
get_detailed_eventsThreat VisualizerRetrieves individual low-level events (connections, notices, model breaches, processes) for a device or alert.
get_subnetsThreat VisualizerRetrieves monitored subnets with CIDR, device counts, DHCP status, and traffic stats.
update_subnetThreat VisualizerEdits subnet details such as label, network range, coordinates, and DHCP/exclusion flags.
get_model_alertsThreat VisualizerRetrieves model alerts (breaches) with model info, device details, and triggered components.
get_model_alert_credentialsThreat VisualizerReturns credentials seen on the device that triggered a given model alert.
update_model_alertThreat VisualizerComments on and/or acknowledges a model alert.
get_modelsThreat VisualizerRetrieves detection models with their logic, actions, and configuration.
get_incident_groupsThreat VisualizerRetrieves AI Analyst incident groups with scores, MITRE tactics, devices, and summaries.
get_incident_eventsThreat VisualizerRetrieves AI Analyst incident events with AI summaries, MITRE tactics, and breach details.
update_incident_groupThreat VisualizerComments on and/or acknowledges an AI Analyst incident group.
create_ai_analyst_investigationThreat VisualizerCreates a manual AI Analyst investigation for a device around a specified time.
get_ai_analyst_investigationsThreat VisualizerRetrieves the status and results of manual AI Analyst investigations.
advanced_searchThreat VisualizerExecutes a Lucene-syntax Advanced Search query against Darktrace log data.
get_advanced_search_syntaxThreat VisualizerReturns the full Advanced Search query syntax reference (must be called before querying).
get_response_actions_summaryThreat VisualizerReturns a summary of active and pending Autonomous Response actions and action counts over a time range.
get_endpoint_informationThreat VisualizerLooks up external endpoints (IPs/hostnames) for location, reputation, and connection history.
get_cvesThreat VisualizerRetrieves CVEs detected across assets with severity, scores, and affected devices.
get_system_healthThreat VisualizerReturns comprehensive system health metrics (CPU, memory, disk, licenses, bandwidth).
get_dam_alertsThreat VisualizerRetrieves health alerts from the Darktrace Alert Management system.
get_module_statusesThreat VisualizerRetrieves the status of Darktrace modules, optionally filtered to failing ones.
get_tagsThreat VisualizerRetrieves device tags and optionally the devices/credentials they are applied to.
manage_tagsThreat VisualizerCreates, deletes, applies, or removes tags on devices or credentials.
get_trusted_domainsThreat VisualizerRetrieves domains marked as trusted.
manage_trusted_domainsThreat VisualizerAdds or removes a trusted domain entry.
get_watched_domainsThreat VisualizerRetrieves watched domains monitored for suspicious activity.
manage_watched_domainsThreat VisualizerAdds or removes watched domain entries.
get_workflow_integration_ticketsThreat VisualizerRetrieves third-party platform tickets created by Workflow Integrations for Darktrace events.
get_cloud_accountsDarktrace / HYBRID NETWORKRetrieves cloud deployment accounts and their monitoring/compliance statuses.
get_cloud_architecturesDarktrace / HYBRID NETWORKRetrieves cloud architectures with risk breakdown, cost, and asset counts.
get_cloud_assetsDarktrace / HYBRID NETWORKRetrieves cloud assets with type, service, region, and attached/associated assets.
get_cloud_asset_filtersDarktrace / HYBRID NETWORKReturns available filter fields and operators for querying cloud assets.
get_cloud_misconfiguration_alertsDarktrace / HYBRID NETWORKRetrieves cloud security misconfiguration alerts grouped by rule.
get_cloud_misconfigured_assetsDarktrace / HYBRID NETWORKRetrieves the assets affected by a specific cloud misconfiguration rule.
get_cloud_rule_informationDarktrace / HYBRID NETWORKReturns detailed rationale, remediation, and compliance mappings for a cloud security rule.
get_emailDarktrace / EMAILRetrieves detailed information about a specific email by UUID.
search_emailsDarktrace / EMAILSearches for emails using filters and a time range.
get_email_search_filtersDarktrace / EMAILReturns available email search filter definitions and values.
action_emailDarktrace / EMAILPerforms an action (hold, release, approve/reject release) on an email for specific recipients.
analyse_email_linkDarktrace / EMAILAnalyzes a URL found in an email, returning classification tags and analysis metrics.
get_email_overviewDarktrace / EMAILReturns an aggregated email dashboard overview (threats, actions, campaigns, etc.).
get_email_listsDarktrace / EMAILRetrieves email lists and their entries.
manage_email_listsDarktrace / EMAILAdds or edits email lists, and adds or removes entries within an email list.
get_email_addin_recordsDarktrace / EMAILRetrieves Inbox Analysis or Misdirected Email add-in records.
get_email_audit_logsDarktrace / EMAILRetrieves EMAIL system audit log events for a time range.
get_email_audit_log_event_typesDarktrace / EMAILReturns available audit log event types for filtering.
get_secure_ai_overviewDarktrace / SECURE AIReturns a dashboard overview of Secure AI activity (anomaly scores, sessions, prompt categories).
get_secure_ai_sessionsDarktrace / SECURE AIRetrieves monitored generative-AI sessions with risk levels and anomaly scores.
get_secure_ai_promptsDarktrace / SECURE AIRetrieves individual prompts for a Secure AI session with anomaly/risk classifications.
get_secure_ai_usersDarktrace / SECURE AIRetrieves users interacting with generative-AI apps, with risk scores and session counts.
get_secure_ai_eventsDarktrace / SECURE AIRetrieves raw events ingested by the Secure AI post-handler.
get_secure_ai_detectionsDarktrace / SECURE AIRetrieves detections raised by Secure AI models with scores and OWASP/ATLAS mappings.
get_secure_ai_response_actionsDarktrace / SECURE AIRetrieves Autonomous Response actions taken by Secure AI.
manage_secure_ai_response_actionDarktrace / SECURE AIClears, confirms, extends, or reactivates a Secure AI response action.
get_shadow_ai_dashboardDarktrace / SECURE AIReturns the Shadow AI dashboard of unsanctioned AI/LLM services detected.
get_shadow_ai_detectionsDarktrace / SECURE AIRetrieves individual Shadow AI detections for unsanctioned AI/LLM service usage.
get_forensic_investigationsDarktrace / HYBRID NETWORKRetrieves forensic investigations with status, alarm counts, and AI summaries.
get_forensic_evidencesDarktrace / HYBRID NETWORKRetrieves evidence items with alarm counts, OS details, and processing status.
get_forensic_evidence_fileDarktrace / HYBRID NETWORKReturns detailed file metadata/content (hash, strings, VirusTotal, AI description) from an evidence item.
browse_forensic_evidence_filesDarktrace / HYBRID NETWORKBrowses the filesystem of a forensic evidence item, filtering by severity, path, or name.
get_forensic_alarmsDarktrace / HYBRID NETWORKRetrieves alarms from an investigation or evidence item with severity and MITRE techniques.
get_forensic_artifactsDarktrace / HYBRID NETWORKRetrieves detection artifacts (files, hashes, processes, users, IPs, domains) from an investigation.
get_forensic_detectionsDarktrace / HYBRID NETWORKRetrieves XDR/EDR detections with MITRE ATT&CK mappings.
get_forensic_indicatorsDarktrace / HYBRID NETWORKRetrieves indicators of compromise (IOCs) from an investigation.
get_forensic_vulnerabilitiesDarktrace / HYBRID NETWORKRetrieves vulnerabilities (CVEs) with CVSS scoring and package info.
get_forensic_pipelinesDarktrace / HYBRID NETWORKRetrieves processing/acquisition pipelines with real-time status.
get_forensic_timelineDarktrace / HYBRID NETWORKRetrieves or facets timeline events from a forensic investigation.
get_forensic_search_syntaxDarktrace / HYBRID NETWORKReturns the Forensic Search query syntax reference (call before forensic timeline queries).

[related-resource]

Continue reading
About the author
Jamie Bali
Technical Author (AI) Developer
Your data. Our AI.
Elevate your network security with Darktrace AI