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-xdr/streaming-api-storage.md
+24-20Lines changed: 24 additions & 20 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -44,30 +44,34 @@ Once the storage account is created, you'll need to define the user who is signi
44
44
45
45
## Enable raw data streaming
46
46
47
-
1. Go to the [Microsoft Defender portal](https://go.microsoft.com/fwlink/p/?linkid=2077139) and sign in using an account with at least Security Administrator permissions.
48
-
49
-
> [!IMPORTANT]
50
-
> Microsoft recommends that you use roles with the fewest permissions. Using lower permissioned accounts helps improve security for your organization. Global Administrator is a highly privileged role that should be limited to emergency scenarios when you can't use an existing role.
51
-
52
47
> [!NOTE]
53
48
> When using the Streaming API to an Azure Storage account, ensure the option `Allow trusted Microsoft services to access this storage account` is enabled in the storage account settings to allow for data to be streamed from Microsoft Defender for Endpoint.
54
49
50
+
1. Go to the [Microsoft Defender portal](https://go.microsoft.com/fwlink/p/?linkid=2077139) and sign in using an account with at least Security Administrator permissions.
51
+
52
+
> [!IMPORTANT]
53
+
> Microsoft recommends that you use roles with the fewest permissions. Using lower permissioned accounts helps improve security for your organization. Global Administrator is a highly privileged role that should be limited to emergency scenarios when you can't use an existing role.
54
+
55
55
2. Go to **Settings** > **Microsoft Defender XDR** > **Streaming API**. To go directly to the **Streaming API** page, use [https://security.microsoft.com/settings/mtp_settings/raw_data_export](https://security.microsoft.com/settings/mtp_settings/raw_data_export).
56
56
57
57
3. Select **Add**.
58
58
59
59
4. In the **Add new Streaming API settings** flyout that appears, configure the following settings:
60
-
1.**Name**: Choose a name for your new settings.
61
-
2. Select **Forward events to Azure Storage**.
62
-
4. To display the Azure Resource Manager resource ID for a storage account in the Azure portal, follow these steps:
63
60
64
-
1. Navigate to your storage account in the Azure portal.
65
-
2. On the **Overview** page, in the **Essentials** section, select the **JSON View** link.
66
-
3. The resource ID for the storage account is displayed at the top of the page, copy the text under **Storage Account Resource ID**.
61
+
-**Name**: Choose a name for your new settings.
62
+
- Select **Forward events to Azure Storage**.
67
63
68
-
4. Back on the **Add new Streaming API settings** flyout, choose the **Event types** that you want to stream.
64
+
5. To display the Azure Resource Manager resource ID for a storage account in the Azure portal, follow these steps:
69
65
70
-
When you're finished, select **Submit**.
66
+
1. Navigate to your storage account in the [Azure portal](https://portal.azure.com).
67
+
68
+
2. In the **Overview** page, in the **Essentials** section, select the **JSON View** link.
69
+
70
+
3. The resource ID for the storage account is displayed at the top of the page. Copy the text under **Storage Account Resource ID**.
71
+
72
+
4. In the **Add new Streaming API settings** flyout, choose the **Event types** that you want to stream.
73
+
74
+
5. When you're finished, select **Submit**.
71
75
72
76
## The schema of the events in the Storage account
73
77
@@ -96,7 +100,9 @@ Once the storage account is created, you'll need to define the user who is signi
96
100
97
101
In order to get the data types for our events properties do the following:
98
102
99
-
1. Log in to <ahref="https://go.microsoft.com/fwlink/p/?linkid=2077139"target="_blank">Microsoft Defender XDR</a> and go to **Hunting**\>**Advanced hunting**. To go directly to the **Advanced hunting** page, use <security.microsoft.com/advanced-hunting>.
103
+
1. Go to the [Microsoft Defender portal](https://go.microsoft.com/fwlink/p/?linkid=2077139) and sign in.
104
+
105
+
2. Go to **Hunting**\>**Advanced hunting**. To go directly to the **Advanced hunting** page, use [https://security.microsoft.com/advanced-hunting](https://security.microsoft.com/advanced-hunting).
100
106
101
107
2. On the **Query** tab, run the following query to get the data types mapping for each event:
102
108
@@ -106,19 +112,17 @@ In order to get the data types for our events properties do the following:
106
112
| project ColumnName, ColumnType
107
113
```
108
114
109
-
- Here's an example for Device Info event:
115
+
Here's an example for Device Info event:
110
116
111
-
:::image type="content" source="/defender-endpoint/media/machine-info-datatype-example.png" alt-text="An example device info query" lightbox="/defender-endpoint/media/machine-info-datatype-example.png":::
117
+
:::image type="content" source="/defender-endpoint/media/machine-info-datatype-example.png" alt-text="An example device info query" lightbox="/defender-endpoint/media/machine-info-datatype-example.png":::
112
118
113
119
## Monitoring created resources
114
120
115
-
You can monitor the resources created by the streaming API using **Azure Monitor**.
116
-
For more information, see [Monitor destinations - Azure Monitor | Microsoft Docs](/azure/azure-monitor/logs/logs-data-export?tabs=portal#monitor-destinations).
121
+
You can monitor the resources created by the streaming API using **Azure Monitor**. For more information, see [Monitor destinations - Azure Monitor](/azure/azure-monitor/logs/logs-data-export?tabs=portal#monitor-destinations).
117
122
118
-
## Related topics
123
+
## Related articles
119
124
120
125
-[Use the Microsoft Graph security API - Microsoft Graph | Microsoft Learn](/graph/api/resources/security-api-overview)
121
-
122
126
-[Overview of Advanced Hunting](advanced-hunting-overview.md)
0 commit comments