From a2b37f762e59629a05a4ee39633f98ea78cb1994 Mon Sep 17 00:00:00 2001 From: Nastasha Solomon <79124755+nastasha-solomon@users.noreply.github.com> Date: Thu, 13 Feb 2025 10:45:10 -0500 Subject: [PATCH] Adds the "Enable threat intelligence integrations" page (#405) * first draft * More changes * Removes refs from raw migrated toc * Update solutions/security/get-started/enable-threat-intelligence-integrations.md * Update solutions/security/get-started/enable-threat-intelligence-integrations.md * Update solutions/security/get-started/enable-threat-intelligence-integrations.md * Update solutions/security/get-started/enable-threat-intelligence-integrations.md * Update solutions/security/get-started/enable-threat-intelligence-integrations.md * Update solutions/security/get-started/enable-threat-intelligence-integrations.md * Update solutions/security/get-started/enable-threat-intelligence-integrations.md * Update solutions/security/get-started/enable-threat-intelligence-integrations.md * Removes comments about anchors --- ...ting-started-threat-intelligence-view.png} | Bin .../serverless/security-overview-dashboard.md | 2 +- .../security-threat-intelligence.md | 72 ----------------- .../security/es-threat-intel-integrations.md | 68 ---------------- raw-migrated-files/toc.yml | 2 - ...enable-threat-intelligence-integrations.md | 76 +++++++++++++++--- 6 files changed, 68 insertions(+), 152 deletions(-) rename images/{serverless--getting-started-threat-intelligence-view.png => getting-started-threat-intelligence-view.png} (100%) delete mode 100644 raw-migrated-files/docs-content/serverless/security-threat-intelligence.md delete mode 100644 raw-migrated-files/security-docs/security/es-threat-intel-integrations.md diff --git a/images/serverless--getting-started-threat-intelligence-view.png b/images/getting-started-threat-intelligence-view.png similarity index 100% rename from images/serverless--getting-started-threat-intelligence-view.png rename to images/getting-started-threat-intelligence-view.png diff --git a/raw-migrated-files/docs-content/serverless/security-overview-dashboard.md b/raw-migrated-files/docs-content/serverless/security-overview-dashboard.md index d470eb02e..82e471098 100644 --- a/raw-migrated-files/docs-content/serverless/security-overview-dashboard.md +++ b/raw-migrated-files/docs-content/serverless/security-overview-dashboard.md @@ -58,7 +58,7 @@ For more information about connecting to threat intelligence sources, visit [Ena :::: -:::{image} ../../../images/serverless--getting-started-threat-intelligence-view.png +:::{image} ../../../images/getting-started-threat-intelligence-view.png :alt: Threat Intelligence view on the Overview dashboard :class: screenshot ::: diff --git a/raw-migrated-files/docs-content/serverless/security-threat-intelligence.md b/raw-migrated-files/docs-content/serverless/security-threat-intelligence.md deleted file mode 100644 index d7ffffc88..000000000 --- a/raw-migrated-files/docs-content/serverless/security-threat-intelligence.md +++ /dev/null @@ -1,72 +0,0 @@ -# Enable threat intelligence integrations [security-threat-intelligence] - -The Threat Intelligence view provides a streamlined way to collect threat intelligence data that you can use for threat detection and matching. Threat intelligence data consists of [threat indicators](../../../troubleshoot/security/indicators-of-compromise.md#ti-indicators) ingested from third-party threat intelligence sources. - -Threat indicators describe potential threats, unusual behavior, or malicious activity on a network or in an environment. They are commonly used in indicator match rules to detect and match known threats. When an indicator match rule generates an alert, it includes information about the matched threat indicator. - -::::{note} -To learn more about alerts with threat intelligence, visit [View alert details](../../../solutions/security/detect-and-alert/view-detection-alert-details.md). - -:::: - - -Refer to the following sections to learn how to connect to threat intelligence sources using an [{{agent}} integration](../../../solutions/security/get-started/enable-threat-intelligence-integrations.md#agent-ti-integration), the [Threat Intel module](../../../solutions/security/get-started/enable-threat-intelligence-integrations.md#ti-mod-integration), or a [custom integration](../../../solutions/security/get-started/enable-threat-intelligence-integrations.md#custom-ti-integration). - -:::{image} ../../../images/serverless--getting-started-threat-intelligence-view.png -:alt: The Threat Intelligence view on the Overview dashboard -:class: screenshot -::: - -There are a few scenarios when data won’t display in the Threat Intelligence view: - -* If you’ve chosen a time range that doesn’t contain threat indicator event data, you are prompted to choose a different range. Use the date and time picker in the {{security-app}} to select a new range to analyze. -* If the {{agent}} or {{filebeat}} agent hasn’t ingested Threat Intel module data yet, the threat indicator event counts won’t load. You can wait for data to be ingested or reach out to your administrator for help resolving this. - - -## Add an {{agent}} integration [agent-ti-integration] - -1. Install a [{{fleet}}-managed {{agent}}](https://www.elastic.co/guide/en/fleet/current/install-fleet-managed-elastic-agent.html) on the hosts you want to monitor. -2. In the Threat Intelligence view, click **Enable sources** to view the Integrations page. Scroll down and select **Elastic Agent only** to filter by {{agent}} integrations. - - ::::{tip} - If you know the name of {{agent}} integration you want to install, you can search for it directly. Alternatively, choose the **Threat Intelligence** category to display a list of available [threat intelligence integrations](https://docs.elastic.co/en/integrations/threat-intelligence-intro). - - :::: - -3. Select an {{agent}} integration, then complete the installation steps. -4. Return to the Threat Intelligence view on the Overview dashboard. If indicator data isn’t displaying, refresh the page or refer to these [troubleshooting steps](../../../troubleshoot/security/indicators-of-compromise.md#troubleshoot-indicators-page). - - -## Add a {{filebeat}} Threat Intel module integration [ti-mod-integration] - -1. Set up the [{{filebeat}} agent](https://www.elastic.co/guide/en/beats/filebeat/current/filebeat-installation-configuration.html) and enable the Threat Intel module. - - ::::{note} - For more information about enabling available threat intelligence filesets, refer to [Threat Intel module](https://www.elastic.co/guide/en/beats/filebeat/current/filebeat-module-threatintel.html). - - :::: - -2. Update the `securitySolution:defaultThreatIndex` [advanced setting](../../../solutions/security/get-started/configure-advanced-settings.md#update-threat-intel-indices) by adding the appropriate index pattern name after the default {{fleet}} threat intelligence index pattern (`logs-ti*`): - - 1. If you’re *only* using {{filebeat}} version 8.x, add the appropriate {{filebeat}} threat intelligence index pattern. For example, `logs-ti*`, `filebeat-8*`. - 2. If you’re using a previous version of Filebeat *and* a current one, differentiate between the threat intelligence indices by using unique index pattern names. For example, if you’re using {{filebeat}} version 7.0.0 and 8.0.0, update the setting to `logs-ti*`,`filebeat-7*`,`filebeat-8*`. - -3. Return to the Threat Intelligence view on the Overview dashboard. Refresh the page if indicator data isn’t displaying. - - -## Add a custom integration [custom-ti-integration] - -1. Set up a way to [ingest data](../../../solutions/security/get-started/ingest-data-to-elastic-security.md) into your system. -2. Update the `securitySolution:defaultThreatIndex` [advanced setting](../../../solutions/security/get-started/configure-advanced-settings.md#update-threat-intel-indices) by adding the appropriate index pattern name after the default {{fleet}} threat intelligence index pattern (`logs-ti*`), for example, `logs-ti*`,`custom-ti-index*`. - - ::::{note} - Threat intelligence indices aren’t required to be ECS compatible. However, we strongly recommend compatibility if you’d like your alerts to be enriched with relevant threat indicator information. You can find a list of ECS-compliant threat intelligence fields at [Threat Fields](https://www.elastic.co/guide/en/ecs/{{ecs_version}}/ecs-threat.html). - - :::: - -3. Return to the Threat Intelligence view on the Overview dashboard (**Dashboards** → **Overview**). Refresh the page if indicator data isn’t displaying. - - ::::{note} - The Threat Intelligence view searches for a `threat.feed.name` field value to define the source name in the **Name** column. If a custom source doesn’t have the `threat.feed.name` field or hasn’t defined a `threat.feed.name` field value, it’s considered unnamed and labeled as **Other**. Dashboards aren’t created for unnamed sources unless the `threat.feed.dashboard_id` field is defined. - - :::: diff --git a/raw-migrated-files/security-docs/security/es-threat-intel-integrations.md b/raw-migrated-files/security-docs/security/es-threat-intel-integrations.md deleted file mode 100644 index f5e2bc69e..000000000 --- a/raw-migrated-files/security-docs/security/es-threat-intel-integrations.md +++ /dev/null @@ -1,68 +0,0 @@ -# Enable threat intelligence integrations [es-threat-intel-integrations] - -The Threat Intelligence view provides a streamlined way to collect threat intelligence data that you can use for threat detection and matching. Threat intelligence data consists of [threat indicators](../../../troubleshoot/security/indicators-of-compromise.md#ti-indicators) ingested from third-party threat intelligence sources. - -Threat indicators describe potential threats, unusual behavior, or malicious activity on a network or in an environment. They are commonly used in indicator match rules to detect and match known threats. When an indicator match rule generates an alert, it includes information about the matched threat indicator. - -::::{note} -To learn more about alerts with threat intelligence, visit [View alert details](../../../solutions/security/detect-and-alert/view-detection-alert-details.md). -:::: - - -You can connect to threat intelligence sources using an [{{agent}} integration](../../../solutions/security/get-started/enable-threat-intelligence-integrations.md#agent-ti-integration), the [Threat Intel module](../../../solutions/security/get-started/enable-threat-intelligence-integrations.md#ti-mod-integration), or a [custom integration](../../../solutions/security/get-started/enable-threat-intelligence-integrations.md#custom-ti-integration). - -:::{image} ../../../images/security-threat-intelligence-view.png -:alt: threat intelligence view -:class: screenshot -::: - -There are a few scenarios when data won’t display in the Threat Intelligence view: - -* If you’ve chosen a time range that doesn’t contain threat indicator event data, you are prompted to choose a different range. Use the date and time picker in the {{security-app}} or Kibana to select a new range to analyze. -* If the {{agent}} or {{filebeat}} agent hasn’t ingested Threat Intel module data yet, the threat indicator event counts won’t load. You can wait for data to be ingested or reach out to your administrator for help resolving this. - - -## Add an {{agent}} integration [agent-ti-integration] - -1. Install a [{{fleet}}-managed {{agent}}](https://www.elastic.co/guide/en/fleet/current/install-fleet-managed-elastic-agent.html) on the hosts you want to monitor. -2. In the Threat Intelligence view, click **Enable sources** to view the Integrations page. Scroll down and select **Elastic Agent only** to filter by {{agent}} integrations. - - ::::{tip} - If you know the name of {{agent}} integration you want to install, you can search for it directly. Alternatively, choose the **Threat Intelligence** category to display a list of available [threat intelligence {{integrations}}](https://docs.elastic.co/en/integrations/threat-intelligence-intro). - - :::: - -3. Select an {{agent}} integration, then complete the installation steps. -4. Return to the Threat Intelligence view on the Overview dashboard. If indicator data isn’t displaying, refresh the page or refer to these [troubleshooting steps](../../../troubleshoot/security/indicators-of-compromise.md#troubleshoot-indicators-page). - - -## Add a {{filebeat}} Threat Intel module integration [ti-mod-integration] - -1. Set up the [{{filebeat}} agent](https://www.elastic.co/guide/en/beats/filebeat/current/filebeat-installation-configuration.html) and enable the Threat Intel module. - - ::::{note} - For more information about enabling available threat intelligence filesets, refer to [Threat Intel module](https://www.elastic.co/guide/en/beats/filebeat/current/filebeat-module-threatintel.html). - :::: - -2. Update the `securitySolution:defaultThreatIndex` [advanced setting](../../../solutions/security/get-started/configure-advanced-settings.md#update-threat-intel-indices) by adding the appropriate index pattern name after the default {{fleet}} threat intelligence index pattern (`logs-ti*`): - - 1. If you’re *only* using {{filebeat}} version 8.x, add the appropriate {{filebeat}} threat intelligence index pattern. For example, `logs-ti*`, `filebeat-8*`. - 2. If you’re using a previous version of Filebeat *and* a current one, differentiate between the threat intelligence indices by using unique index pattern names. For example, if you’re using {{filebeat}} version 7.0.0 and 8.0.0, update the setting to `logs-ti*`,`filebeat-7*`,`filebeat-8*`. - -3. Return to the Threat Intelligence view on the Overview dashboard. Refresh the page if indicator data isn’t displaying. - - -## Add a custom integration [custom-ti-integration] - -1. Set up a way to [ingest data](../../../solutions/security/get-started/ingest-data-to-elastic-security.md) into your system. -2. Update the `securitySolution:defaultThreatIndex` [advanced setting](../../../solutions/security/get-started/configure-advanced-settings.md#update-threat-intel-indices) by adding the appropriate index pattern name after the default {{fleet}} threat intelligence index pattern (`logs-ti*`), for example, `logs-ti*`,`custom-ti-index*`. - - ::::{note} - Threat intelligence indices aren’t required to be ECS compatible. However, we strongly recommend compatibility if you’d like your alerts to be enriched with relevant threat indicator information. You can find a list of ECS-compliant threat intelligence fields at [Threat Fields](https://www.elastic.co/guide/en/ecs/{{ecs_version}}/ecs-threat.html). - :::: - -3. Return to the Threat Intelligence view on the Overview dashboard (**Dashboards → Overview**). Refresh the page if indicator data isn’t displaying. - - ::::{note} - The Threat Intelligence view searches for a `threat.feed.name` field value to define the source name in the **Name** column. If a custom source doesn’t have the `threat.feed.name` field or hasn’t defined a `threat.feed.name` field value, it’s considered unnamed and labeled as **Other**. Dashboards aren’t created for unnamed sources unless the `threat.feed.dashboard_id` field is defined. - :::: diff --git a/raw-migrated-files/toc.yml b/raw-migrated-files/toc.yml index 827073fd5..869b24002 100644 --- a/raw-migrated-files/toc.yml +++ b/raw-migrated-files/toc.yml @@ -508,7 +508,6 @@ toc: - file: docs-content/serverless/security-shared-exception-lists.md - file: docs-content/serverless/security-signals-to-cases.md - file: docs-content/serverless/security-third-party-actions.md - - file: docs-content/serverless/security-threat-intelligence.md - file: docs-content/serverless/security-timeline-templates-ui.md - file: docs-content/serverless/security-timelines-ui.md - file: docs-content/serverless/security-triage-alerts-with-elastic-ai-assistant.md @@ -846,7 +845,6 @@ toc: - file: security-docs/security/environment-variable-capture.md - file: security-docs/security/ers-requirements.md - file: security-docs/security/es-overview.md - - file: security-docs/security/es-threat-intel-integrations.md - file: security-docs/security/es-ui-overview.md - file: security-docs/security/esql-queries-assistant.md - file: security-docs/security/event-filters.md diff --git a/solutions/security/get-started/enable-threat-intelligence-integrations.md b/solutions/security/get-started/enable-threat-intelligence-integrations.md index 6a21391c6..ae07fd31a 100644 --- a/solutions/security/get-started/enable-threat-intelligence-integrations.md +++ b/solutions/security/get-started/enable-threat-intelligence-integrations.md @@ -4,19 +4,77 @@ mapped_urls: - https://www.elastic.co/guide/en/serverless/current/security-threat-intelligence.html --- -# Enable threat intelligence integrations +# Enable threat intelligence integrations [security-enable-threat-intelligence-integrations] -% What needs to be done: Lift-and-shift +The Threat Intelligence view provides a streamlined way to collect threat intelligence data that you can use for threat detection and matching. Threat intelligence data consists of [threat indicators](../../../troubleshoot/security/indicators-of-compromise.md#ti-indicators) ingested from third-party threat intelligence sources. -% Use migrated content from existing pages that map to this page: +Threat indicators describe potential threats, unusual behavior, or malicious activity on a network or in an environment. They are commonly used in indicator match rules to detect and match known threats. When an indicator match rule generates an alert, it includes information about the matched threat indicator. -% - [ ] ./raw-migrated-files/security-docs/security/es-threat-intel-integrations.md -% - [ ] ./raw-migrated-files/docs-content/serverless/security-threat-intelligence.md +::::{note} +To learn more about alerts with threat intelligence, visit [View alert details](../detect-and-alert/view-detection-alert-details.md). -% Internal links rely on the following IDs being on this page (e.g. as a heading ID, paragraph ID, etc): +:::: -$$$agent-ti-integration$$$ -$$$custom-ti-integration$$$ +You can connect to threat intelligence sources using an [{{agent}} integration](#agent-ti-integration), the [Threat Intel module](#ti-mod-integration), or a [custom integration](#custom-ti-integration). -$$$ti-mod-integration$$$ \ No newline at end of file +:::{image} ../../../images/getting-started-threat-intelligence-view.png +:alt: The Threat Intelligence view on the Overview dashboard +:class: screenshot +::: + +There are a few scenarios when data won’t display in the Threat Intelligence view: + +* If you’ve chosen a time range that doesn’t contain threat indicator event data, you are prompted to choose a different range. Use the date and time picker in the {{security-app}} to select a new range to analyze. +* If the {{agent}} or {{filebeat}} agent hasn’t ingested Threat Intel module data yet, the threat indicator event counts won’t load. You can wait for data to be ingested or reach out to your administrator for help resolving this. + + +## Add an {{agent}} integration [agent-ti-integration] + +1. Install a [{{fleet}}-managed {{agent}}](https://www.elastic.co/guide/en/fleet/current/install-fleet-managed-elastic-agent.html) on the hosts you want to monitor. +2. In the Threat Intelligence view, click **Enable sources** to view the Integrations page. Scroll down and select **Elastic Agent only** to filter by {{agent}} integrations. + + ::::{tip} + If you know the name of {{agent}} integration you want to install, you can search for it directly. Alternatively, choose the **Threat Intelligence** category to display a list of available [threat intelligence integrations](https://docs.elastic.co/en/integrations/threat-intelligence-intro). + + :::: + +3. Select an {{agent}} integration, then complete the installation steps. +4. Return to the Threat Intelligence view on the Overview dashboard. If indicator data isn’t displaying, refresh the page or refer to these [troubleshooting steps](../../../troubleshoot/security/indicators-of-compromise.md#troubleshoot-indicators-page). + + +## Add a {{filebeat}} Threat Intel module integration [ti-mod-integration] + +% Substeps in step 2 will require inline versioning. Remember to update them when we have more guidance on handling line-level differences. + +1. Set up the [{{filebeat}} agent](https://www.elastic.co/guide/en/beats/filebeat/current/filebeat-installation-configuration.html) and enable the Threat Intel module. + + ::::{note} + For more information about enabling available threat intelligence filesets, refer to [Threat Intel module](https://www.elastic.co/guide/en/beats/filebeat/current/filebeat-module-threatintel.html). + + :::: + +2. Update the `securitySolution:defaultThreatIndex` [advanced setting](configure-advanced-settings.md#update-threat-intel-indices) by adding the appropriate index pattern name after the default {{fleet}} threat intelligence index pattern (`logs-ti*`): + + * If you’re *only* using {{filebeat}} version 8.x, add the appropriate {{filebeat}} threat intelligence index pattern. For example, `logs-ti*`, `filebeat-8*`. + * If you’re using a previous version of Filebeat *and* a current one, differentiate between the threat intelligence indices by using unique index pattern names. For example, if you’re using {{filebeat}} version 7.0.0 and 8.0.0, update the setting to `logs-ti*`,`filebeat-7*`,`filebeat-8*`. + +3. Return to the Threat Intelligence view on the Overview dashboard. Refresh the page if indicator data isn’t displaying. + + +## Add a custom integration [custom-ti-integration] + +1. Set up a way to [ingest data](ingest-data-to-elastic-security.md) into your system. +2. Update the `securitySolution:defaultThreatIndex` [advanced setting](configure-advanced-settings.md#update-threat-intel-indices) by adding the appropriate index pattern name after the default {{fleet}} threat intelligence index pattern (`logs-ti*`), for example, `logs-ti*`,`custom-ti-index*`. + + ::::{note} + Threat intelligence indices aren’t required to be ECS compatible. However, we strongly recommend compatibility if you’d like your alerts to be enriched with relevant threat indicator information. You can find a list of ECS-compliant threat intelligence fields at [Threat Fields](https://www.elastic.co/guide/en/ecs/{{ecs_version}}/ecs-threat.html). + + :::: + +3. Return to the Threat Intelligence view on the Overview dashboard (**Dashboards** → **Overview**). Refresh the page if indicator data isn’t displaying. + + ::::{note} + The Threat Intelligence view searches for a `threat.feed.name` field value to define the source name in the **Name** column. If a custom source doesn’t have the `threat.feed.name` field or hasn’t defined a `threat.feed.name` field value, it’s considered unnamed and labeled as **Other**. Dashboards aren’t created for unnamed sources unless the `threat.feed.dashboard_id` field is defined. + + ::::