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: azure_active_directory/README.md
+46-13Lines changed: 46 additions & 13 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -9,11 +9,39 @@ This integration allows you to forward your [Microsoft Entra ID][1] audit and si
9
9
10
10
### Installation
11
11
12
-
This integration forwards logs to Datadog using Azure with Event Hubs. Configure Entra ID to forward activity logs to the event hub.
12
+
This integration forwards logs to Datadog using either [Azure Automated Log Forwarding][2] (recommended) or [Azure with Event Hubs][3]. Datadog recommends using the automated solution because it requires less configuration and maintenance.
13
13
14
14
### Configuration
15
15
16
-
1. Set up the log forwarding pipeline from Azure to Datadog using Event Hubs by following the [Send Azure Logs to Datadog][2] guide.
16
+
<!-- xxx tabs xxx -->
17
+
<!-- xxx tab "Automated Log Forwarding" xxx -->
18
+
19
+
1. Set up the log forwarding pipeline from Azure to Datadog by following the [Azure Automated Log Forwarding Setup][2] guide.
20
+
21
+
2. In Azure portal, select _Microsoft Entra ID > Monitoring > Audit logs_.
22
+
23
+
3. Select **Export Data Settings**.
24
+
25
+
4. In the Diagnostics settings pane, do one of the following:
26
+
27
+
- To change existing settings, select **Edit setting**.
28
+
- To add new settings, select **Add diagnostics setting**. You can have up to three settings.
29
+
30
+
5. Select the **Archive to a storage account** check box.
31
+
32
+
6. Select any storage account that begins with `ddlogstorage`. These are all managed by the automated log forwarding infrastructure deployed by the ARM template, and any of them will forward logs successfully.
33
+
34
+
7. Do one or both of the following. Datadog recommends selecting both.
35
+
36
+
- To send audit logs, select the **AuditLogs** check box.
37
+
- To send sign-in logs, select the **SignInLogs** check box.
38
+
39
+
8. Select **Save**.
40
+
<!-- xxz tab xxx -->
41
+
42
+
<!-- xxx tab "Azure with Event Hubs" xxx -->
43
+
44
+
1. Set up the log forwarding pipeline from Azure to Datadog using Event Hubs by following the [Send Azure Logs to Datadog from an Event Hub][3] guide.
17
45
18
46
2. In Azure portal, select _Microsoft Entra ID > Monitoring > Audit logs_.
19
47
@@ -35,8 +63,12 @@ This integration forwards logs to Datadog using Azure with Event Hubs. Configure
35
63
36
64
8. Select **Save**.
37
65
66
+
For more details on the setup, see Microsoft's [Azure tutorial][4] on streaming Entra ID logs to an Event Hub.
67
+
68
+
<!-- xxz tab xxx -->
69
+
<!-- xxz tabs xxx -->
70
+
38
71
Logs should start coming into Datadog within 15 minutes.
39
-
For more details on the setup, see the [Azure tutorial][3].
40
72
41
73
## Data Collected
42
74
@@ -56,27 +88,28 @@ Microsoft Entra ID does not include any metrics.
56
88
57
89
### Events
58
90
59
-
Datadog sends credential expiry events, which grant visibility into credential expirations for Azure app registrations, Key Vault keys, Key Vault secrets, and Key Vault certificates. The Microsoft Entra ID integration must be installed to receive events for Azure app registrations. Receiving events from Azure also requires installation of the [Azure integration][7].
91
+
Datadog sends credential expiry events, which grant visibility into credential expirations for Azure app registrations, Key Vault keys, Key Vault secrets, and Key Vault certificates. The Microsoft Entra ID integration must be installed to receive events for Azure app registrations. Receiving events from Azure also requires installation of the [Azure integration][5].
60
92
61
93
62
94
-**Expiration events** are sent 60, 30, 15, and 1 day(s) before credential expiration, and once after expiration.
63
95
-**Missing permission events** are sent every 15 days. A missing permission event lists the Key Vaults for which Datadog has not been given permissions. If no changes have been made regarding Key Vault permissions in the previous 15-day cycle, the event notification is not sent again.
64
96
65
-
You can view these events in [Event Explorer][5].
97
+
You can view these events in [Event Explorer][6].
66
98
67
99
**Notes**:
68
100
69
-
- To collect Azure app registration expiration events, [enable access to the Microsoft Graph API][6].
101
+
- To collect Azure app registration expiration events, [enable access to the Microsoft Graph API][7].
70
102
- If a certificate and its associated key and secret expire at the exact same time, one expiration event is sent for all resources.
0 commit comments