diff --git a/config/_default/menus/main.en.yaml b/config/_default/menus/main.en.yaml index 21f512e55cf..fe0517be670 100644 --- a/config/_default/menus/main.en.yaml +++ b/config/_default/menus/main.en.yaml @@ -1438,21 +1438,26 @@ menu: parent: bits_ai_dev_agent identifier: bits_ai_dev_agent_setup weight: 200 + - name: Bits AI Security Analyst + url: bits_ai/bits_ai_security_analyst + identifier: bits_ai_bits_ai_security_analyst + parent: bits_ai + weight: 3 - name: Bits Assistant url: bits_ai/bits_assistant identifier: bits_ai_bits_assistant parent: bits_ai - weight: 3 + weight: 4 - name: MCP Server url: bits_ai/mcp_server identifier: bits_ai_mcp_server parent: bits_ai - weight: 4 + weight: 5 - name: Setup url: bits_ai/mcp_server/setup identifier: bits_ai_mcp_server_setup parent: bits_ai_mcp_server - weight: 401 + weight: 501 - name: Dashboards url: dashboards/ pre: dashboard diff --git a/content/en/bits_ai/_index.md b/content/en/bits_ai/_index.md index b45a2cd0b11..09ab3e8a23d 100644 --- a/content/en/bits_ai/_index.md +++ b/content/en/bits_ai/_index.md @@ -27,7 +27,7 @@ Bits AI is your agentic teammate in Datadog, built to automate development, secu {{< whatsnext desc="Learn about how you can use Bits AI:" >}} {{< nextlink href="bits_ai/bits_ai_sre" >}}Investigate alerts with Bits AI SRE{{< /nextlink >}} {{< nextlink href="bits_ai/bits_ai_dev_agent" >}}Automate code fixes with Bits AI Dev Agent{{< /nextlink >}} - + {{< nextlink href="bits_ai/bits_ai_security_analyst" >}}Triage security threat signals with Bits AI Security Analyst{{< /nextlink >}} {{< nextlink href="bits_ai/bits_assistant" >}}Explore your observability data with Bits Assistant{{< /nextlink >}} {{< nextlink href="bits_ai/mcp_server" >}}Get observability insights from AI agents with the Datadog MCP server{{< /nextlink >}} {{< /whatsnext >}} diff --git a/content/en/bits_ai/bits_ai_security_analyst.md b/content/en/bits_ai/bits_ai_security_analyst.md new file mode 100644 index 00000000000..f72f2ef465a --- /dev/null +++ b/content/en/bits_ai/bits_ai_security_analyst.md @@ -0,0 +1,107 @@ +--- +title: Bits AI Security Analyst +further_reading: + - link: https://www.datadoghq.com/blog/bits-ai-security-analyst/ + tag: Blog + text: Automate Cloud SIEM investigations with Bits AI Security Analyst +--- + +## Overview + +Bits AI Security Analyst is an autonomous AI agent that investigates Cloud SIEM signals end to end. It queries security signals and logs, and uses data-based reasoning to help security engineers investigate threat alerts and make a recommendation on the verdict of each alert signal. By reducing manual effort and analyst fatigue, Bits AI Security Analyst makes security operations smoother and more efficient. + +### Key capabilities + +Bits AI Security Analyst investigations are autonomous. If a detection rule is enabled, Bits AI autonomously investigates signals associated with it. + +In the [Cloud SIEM Signals Explorer][5], you can click the **Bits AI Security Analyst** tab to only show signals that Bits AI investigated. In the Severity column, a Bits AI status displays as Investigating, Benign, or Suspicious. + +{{< img src="bits_ai/bits_ai_security_analyst_signals_explorer.png" alt="The Cloud SIEM signals explorer, on the Bits AI Security Analyst tab" style="width:100%;" >}} + +When you click a row with a Bits AI investigation, the Bits AI Investigation side panel opens: + +{{< img src="bits_ai/bits_ai_security_analyst_example.png" alt="Bits AI Security Analyst example detection, titled 'Okta phishing detection with FastPass origin check'." style="width:100%;" >}} + +In the side panel, you can see Bits AI's investigative findings, including: +- Overall conclusion +- Key evidence used to come to that conclusion +- Investigative steps showing Bits AI's data queries, including embedded results and links to full queries +- Analysis on each investigative step + +You can also take additional steps directly from the side panel: +- Create a case with pre-populated Bits AI investigation results +- Run a workflow with a SOAR blueprint +- Declare an incident +- Add a rule suppression +- Archive the signal, or view the signal with the usual Cloud SIEM interface +- Give Bits AI feedback on its analysis + +Additionally, when you use Cloud SIEM notifications to send new signal alerts to Slack or Jira, Bits AI automatically updates those notifications. It includes replies showing the Bits AI investigative conclusion, with a link to the full investigation. + +### Supported sources + +Bits AI can run investigations on the following Security log sources: +- AWS CloudTrail +- Azure +- GCP +- Kubernetes +- Microsoft Entra ID +- Okta +- Google Workspace +- Microsoft 365 +- GitHub +- Snowflake +- SentinelOne +- Email phishing + +## Set up Bits AI Security Analyst + +### Prerequisites + +To use Bits AI Security Analyst: +- Ensure your organization is using a non-legacy version of Cloud SIEM. If you need assistance, contact [Datadog support][1]. +- To set up Bits AI Security Analyst, you need the **Bits AI Security Analyst Config Write** [permission][2]. +- To view investigations, you must have **14 days or more** of log history. If you have a shorter log history, you can still set up Bits AI Security Analyst, but won't see any investigations until you have that much history. + +### Setup + +As soon as you enable Bits AI Security Analyst, by default, it starts autonomously investigating signals for all eligible rules above medium severity. + +1. In Datadog, go to **Security** > **Settings** > **[Bits AI Security Analyst][3]**. +1. Turn on the toggle to enable Bits AI Security Analyst. Additional settings appear. +1. (Optional) Configure which rules and which severities you want Bits AI Security Analyst to automatically investigate signals for. There are two ways to do so: + - Click **Rule Settings** to configure investigations for individual rules. You can change the minimum severity for signals to be investigated, and enable or disable individual rules for investigation. +
When you enable Bits AI Security Analyst, Datadog analyzes your custom rules to determine whether it can confidently investigate signals associated with it. If you have new custom rules to evaluate, or want to ask about a rule that wasn't made eligible, contact Datadog support.
+ - Click **Query Filter** to write a signal query filter, so Bits AI Security Analyst only investigates signals that match your filter. +1. Some log sources require credentials to run or enhance investigations by accessing logs, telemetry, or other data that isn't in Datadog. To add credentials, click **Edit credentials**. In the **Select or Add Connection** window that opens, follow the prompts to select an [existing connection][4] from Actions Catalog, or add a connection. Datadog securely stores and restricts all credentials using Actions Catalog. + - Some log sources require additional setup so you can create HTTP connections. Here's an example: + {{< collapse-content title="Configure SentinelOne" level="h4" expanded=false id="sentinelone" >}} +
    +
  1. In SentinelOne, ensure you have permission to create an API token. Create an S1 API service user, then assign the Viewer role to that user.
    2. +
  2. In Datadog, in the Select or Add Connection window, in the dropdown, select New Connection, then click the HTTP tile.
    3. +
  3. Add the following information: + +
    4. +
  4. Click Next, Confirm Access to verify your connection.
    5. +
+ {{< /collapse-content >}} + +## Disable Bits AI Security Analyst + +1. In Datadog, go to **Security** > **Settings** > **[Bits AI Security Analyst][3]**. +1. Scroll to the bottom of the page. Under **Disable Bits AI Security Analyst**, turn off the **Enabled** toggle. +
Disabling Bits AI Security Analyst permanently resets all configuration settings.
+ +## Further reading + +{{< partial name="whats-next/whats-next.html" >}} + +[1]: /help +[2]: /account_management/rbac/permissions/#cloud-security-platform +[3]: https://app.datadoghq.com/security/configuration/bits-ai-security-analyst +[4]: /actions/connections/ +[5]: https://app.datadoghq.com/security/siem/signals \ No newline at end of file diff --git a/static/images/bits_ai/bits_ai_security_analyst_example.png b/static/images/bits_ai/bits_ai_security_analyst_example.png new file mode 100644 index 00000000000..099b2dfa34f Binary files /dev/null and b/static/images/bits_ai/bits_ai_security_analyst_example.png differ diff --git a/static/images/bits_ai/bits_ai_security_analyst_signals_explorer.png b/static/images/bits_ai/bits_ai_security_analyst_signals_explorer.png new file mode 100644 index 00000000000..07fdbfb091e Binary files /dev/null and b/static/images/bits_ai/bits_ai_security_analyst_signals_explorer.png differ