Merge pull request #209435 from yelevin/yelevin/add-entity-ti

Add Entity to TI

Author: LJSpiller

articles/sentinel/TOC.yml

@@ -286,6 +286,8 @@
       href: indicators-bulk-file-import.md
     - name: Work with threat indicators
       href: work-with-threat-indicators.md
+    - name: Add entity to threat indicators
+      href: add-entity-to-threat-intelligence.md
   - name: Monitor and visualize data
     items:
     - name: Visualize collected data

articles/sentinel/add-entity-to-threat-intelligence.md

@@ -0,0 +1,107 @@
+---
+title: Add entities to threat intelligence in Microsoft Sentinel
+description: This article shows you, if you discover a malicious entity in an incident investigation, how to add the entity to your threat intelligence indicator lists in Microsoft Sentinel.
+author: yelevin
+ms.topic: how-to
+ms.date: 08/25/2022
+ms.author: yelevin
+---
+
+# Add entities to threat intelligence in Microsoft Sentinel
+
+When investigating an incident, you examine entities and their context as an important part of understanding the scope and nature of the incident. In the course of the investigation, you may discover a domain name, URL, file, or IP address in the incident that should be labeled and tracked as an indicator of compromise (IOC), a threat indicator.
+
+For example, you may discover an IP address performing port scans across your network, or functioning as a command and control node, sending and/or receiving transmissions from large numbers of nodes in your network.
+
+Microsoft Sentinel allows you to flag these types of entities as malicious, right from within the investigation graph, and add it to your threat indicator lists. You'll then be able to view the added indicators both in Logs and in the Threat Intelligence blade, and use them across your Microsoft Sentinel workspace.
+
+> [!IMPORTANT]
+> Adding entities as TI indicators is currently in PREVIEW. The [Azure Preview Supplemental Terms](https://azure.microsoft.com/support/legal/preview-supplemental-terms/) include additional legal terms that apply to Azure features that are in beta, preview, or otherwise not yet released into general availability.
+
+## Add an entity to your indicators list
+
+The [investigation graph](investigate-cases.md) is a visual, intuitive tool that presents connections and patterns and enables your analysts to ask the right questions and follow leads. You can use it to add entities to your threat intelligence indicator lists, making them available across your workspace.
+
+1. From the Microsoft Sentinel navigation menu, select **Incidents**.
+
+1. Select an incident to investigate. In the incident details panel, select the **Actions** button and choose **Investigate** from the pop-up menu. This will open the investigation graph.
+
+    :::image type="content" source="media/add-entity-to-threat-intelligence/select-incident-to-investigate.png" alt-text="Screenshot of selecting incident from queue to investigate.":::
+
+1. Select the entity from the graph that you want to add as a threat indicator. A side panel will open on the right. Select **Add to TI**.
+
+    Only the following types of entities can be added as threat indicators:
+    - Domain name
+    - IP address (IPv4 and IPv6)
+    - URL
+    - File (hash)
+
+    :::image type="content" source="media/add-entity-to-threat-intelligence/add-entity-to-ti.png" alt-text="Screenshot of adding entity to threat intelligence.":::
+
+1. The **New indicator** side panel will open. The following fields will be populated automatically:
+
+    - **Type**
+        - The type of indicator represented by the entity you're adding.  
+            Drop-down with possible values: *ipv4-addr*, *ipv6-addr*, *URL*, *file*, *domain-name*
+        - Required; automatically populated based on the **entity type**.
+
+    - **Value**
+        - The name of this field changes dynamically to the selected indicator type.
+        - The value of the indicator itself.
+        - Required; automatically populated by the **entity value**.
+
+    - **Tags** 
+        - Free-text tags you can add to the indicator.
+        - Optional; automatically populated by the **incident ID**. You can add others.
+    
+    - **Name**
+        - Name of the indicator - this is what will be displayed in your list of indicators.
+        - Optional; automatically populated by the **incident name.**
+    
+    - **Created by**
+        - Creator of the indicator.
+        - Optional; automatically-populated by the user logged into Microsoft Sentinel.
+
+    Fill in the remaining fields accordingly.
+
+    - **Threat type**
+        - The threat type represented by the indicator.
+        - Optional; free text.
+
+    - **Description**
+        - Description of the indicator.
+        - Optional; free text.
+
+    - **Revoked**
+        - Revoked status of the indicator. Mark checkbox to revoke the indicator, clear checkbox to make it active.
+        - Optional; boolean.
+
+    - **Confidence**
+        - Score reflecting confidence in the correctness of the data, by percent.
+        - Optional; integer, 1-100
+
+    - **Kill chain**
+        - Phases in the [*Lockheed Martin Cyber Kill Chain*](https://www.lockheedmartin.com/en-us/capabilities/cyber/cyber-kill-chain.html#OVERVIEW) to which the indicator corresponds.
+        - Optional; free text 
+
+    - **Valid from**
+        - The time from which this indicator is considered valid.
+        - Required; date/time 
+
+    - **Valid until**
+        - The time at which this indicator should no longer be considered valid.
+        - Optional; date/time 
+
+    :::image type="content" source="media/add-entity-to-threat-intelligence/new-indicator-panel.png" alt-text="Screenshot of entering information in new threat indicator panel.":::
+
+1. When all the fields are filled in to your satisfaction, select **Apply**. You'll see a confirmation message in the upper-right-hand corner that your indicator was created.
+
+1. The entity will be added as a threat indicator in your workspace. You can find it [in the list of indicators in the **Threat intelligence** page](work-with-threat-indicators.md#find-and-view-your-indicators-in-the-threat-intelligence-page), and also [in the *ThreatIntelligenceIndicators* table in **Logs**](work-with-threat-indicators.md#find-and-view-your-indicators-in-logs). 
+
+## Next steps
+
+In this article, you learned how to add entities to your threat indicator lists. For more information, see:
+
+- [Investigate incidents with Microsoft Sentinel](investigate-cases.md)
+- [Understand threat intelligence in Microsoft Sentinel](understand-threat-intelligence.md)
+- [Work with threat indicators in Microsoft Sentinel](work-with-threat-indicators.md)

articles/sentinel/media/add-entity-to-threat-intelligence/add-entity-to-ti.png

@@ -4,7 +4,7 @@ description: A description of what's new and changed in Azure Sentinel from six
 author: yelevin
 ms.author: yelevin
 ms.topic: conceptual
-ms.date: 11/22/2021
+ms.date: 08/31/2022
 ms.custom: ignite-fall-2021
 ---
 

articles/sentinel/media/add-entity-to-threat-intelligence/new-indicator-panel.png

@@ -4,7 +4,7 @@ description: This article describes new features in Microsoft Sentinel from the
 author: yelevin
 ms.author: yelevin
 ms.topic: conceptual
-ms.date: 08/08/2022
+ms.date: 08/31/2022
 ms.custom: ignite-fall-2021
 ---
 
@@ -25,6 +25,18 @@ If you're looking for items older than six months, you'll find them in the [Arch
 >
 > You can also contribute! Join us in the [Microsoft Sentinel Threat Hunters GitHub community](https://github.com/Azure/Azure-Sentinel/wiki).
 
+## September 2022
+
+- [Add entities to threat intelligence (Preview)](#add-entities-to-threat-intelligence-preview)
+
+### Add entities to threat intelligence (Preview)
+
+When investigating an incident, you examine entities and their context as an important part of understanding the scope and nature of the incident. In the course of the investigation, you may discover an entity in the incident that should be labeled and tracked as an indicator of compromise (IOC), a threat indicator.
+
+Microsoft Sentinel allows you to flag the entity as malicious, right from within the investigation graph. You'll then be able to view this indicator both in Logs and in the Threat Intelligence blade in Sentinel.
+
+Learn how to [add an entity to your threat intelligence](add-entity-to-threat-intelligence.md).
+
 ## August 2022
 
 - [Heads up: Microsoft 365 Defender now integrates Azure Active Directory Identity Protection (AADIP)](#heads-up-microsoft-365-defender-now-integrates-azure-active-directory-identity-protection-aadip)