Skip to content

Commit db7afbc

Browse files
committed
Update streaming-api-storage.md
1 parent 22c1e1d commit db7afbc

File tree

1 file changed

+24
-20
lines changed

1 file changed

+24
-20
lines changed

defender-xdr/streaming-api-storage.md

Lines changed: 24 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -44,30 +44,34 @@ Once the storage account is created, you'll need to define the user who is signi
4444

4545
## Enable raw data streaming
4646

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-
5247
> [!NOTE]
5348
> 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.
5449
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+
5555
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).
5656

5757
3. Select **Add**.
5858

5959
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:
6360

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**.
6763

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:
6965

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**.
7175

7276
## The schema of the events in the Storage account
7377

@@ -96,7 +100,9 @@ Once the storage account is created, you'll need to define the user who is signi
96100

97101
In order to get the data types for our events properties do the following:
98102

99-
1. Log in to <a href="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).
100106

101107
2. On the **Query** tab, run the following query to get the data types mapping for each event:
102108

@@ -106,19 +112,17 @@ In order to get the data types for our events properties do the following:
106112
| project ColumnName, ColumnType
107113
```
108114

109-
- Here's an example for Device Info event:
115+
Here's an example for Device Info event:
110116

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":::
112118

113119
## Monitoring created resources
114120

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).
117122

118-
## Related topics
123+
## Related articles
119124

120125
- [Use the Microsoft Graph security API - Microsoft Graph | Microsoft Learn](/graph/api/resources/security-api-overview)
121-
122126
- [Overview of Advanced Hunting](advanced-hunting-overview.md)
123127
- [Microsoft Defender XDR Streaming API](streaming-api.md)
124128
- [Stream Microsoft Defender XDR events to your Azure storage account](streaming-api-storage.md)

0 commit comments

Comments
 (0)