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: articles/active-directory/reports-monitoring/tutorial-access-api-with-certificates.md
+17-20Lines changed: 17 additions & 20 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -2,44 +2,41 @@
2
2
title: Tutorial for AD Reporting API with certificates | Microsoft Docs
3
3
description: This tutorial explains how to use the Azure AD Reporting API with certificate credentials to get data from directories without user intervention.
4
4
services: active-directory
5
-
documentationcenter: ''
6
-
author: MarkusVi
5
+
author: shlipsey3
7
6
manager: amycolannino
8
-
9
-
ms.assetid:
10
7
ms.service: active-directory
11
8
ms.workload: identity
12
-
ms.tgt_pltfrm: na
13
9
ms.topic: tutorial
14
10
ms.subservice: report-monitor
15
-
ms.date: 08/26/2022
16
-
ms.author: markvi
11
+
ms.date: 10/31/2022
12
+
ms.author: sarahlipsey
17
13
ms.reviewer: dhanyahk
18
-
19
-
# Customer intent: As a developer, I want to learn how to access the Azure AD reporting API using certificates so that I can create an application that does not require user intervention to access reports.
20
14
ms.collection: M365-identity-device-management
21
15
ms.custom: has-adal-ref
16
+
17
+
# Customer intent: As a developer, I want to learn how to access the Azure AD reporting API using certificates so that I can create an application that does not require user intervention to access reports.
18
+
22
19
---
23
20
24
21
# Tutorial: Get data using the Azure Active Directory reporting API with certificates
25
22
26
-
The [Azure Active Directory (Azure AD) reporting APIs](concept-reporting-api.md) provide you with programmatic access to the data through a set of REST-based APIs. You can call these APIs from a variety of programming languages and tools. If you want to access the Azure AD Reporting API without user intervention, you must configure your access to use certificates.
23
+
The [Azure Active Directory (Azure AD) reporting APIs](concept-reporting-api.md) provide you with programmatic access to the data through a set of REST-based APIs. You can call these APIs from various programming languages and tools. If you want to access the Azure AD Reporting API without user intervention, you must configure your access to use certificates.
27
24
28
25
In this tutorial, you learn how to use a test certificate to access the MS Graph API for reporting. We don't recommend using test certificates in a production environment.
29
26
30
27
## Prerequisites
31
28
32
-
1. To access sign-in data, make sure you have an Azure Active Directory tenant with a premium (P1/P2) license. See [Getting started with Azure Active Directory Premium](../fundamentals/active-directory-get-started-premium.md) to upgrade your Azure Active Directory edition. Note that if you did not have any activities data prior to the upgrade, it will take a couple of days for the data to show up in the reports after you upgrade to a premium license.
29
+
1. To access sign-in data, make sure you have an Azure AD tenant with a premium (P1/P2) license. See [Getting started with Azure Active Directory Premium](../fundamentals/active-directory-get-started-premium.md) to upgrade your Azure AD edition. If you didn't have any activities data prior to the upgrade, it will take a couple of days for the data to show up in the reports after you upgrade to a premium license.
33
30
34
-
2. Create or switch to a user account in the **global administrator**, **security administrator**, **security reader** or **report reader** role for the tenant.
31
+
2. Create or switch to a user account in the **Global Administrator**, **Security Administrator**, **Security Reader** or **Report Reader** role for the tenant.
35
32
36
33
3. Complete the [prerequisites to access the Azure Active Directory reporting API](howto-configure-prerequisites-for-reporting-api.md).
37
34
38
35
4. Download and install [Azure AD PowerShell V2](https://github.com/Azure/azure-docs-powershell-azuread/blob/master/docs-conceptual/azureadps-2.0/install-adv2.md).
39
36
40
37
5. Install [MSCloudIdUtils](https://www.powershellgallery.com/packages/MSCloudIdUtils/). This module provides several utility cmdlets including:
41
-
- The ADAL libraries needed for authentication
42
-
- Access tokens from user, application keys, and certificates using ADAL
38
+
- The Microsoft Authentication Library libraries needed for authentication
39
+
- Access tokens from user, application keys, and certificates using Microsoft Authentication Library
43
40
- Graph API handling paged results
44
41
45
42
6. If it's your first time using the module run **Install-MSCloudIdUtilsModule**, otherwise import it using the **Import-Module** PowerShell command. Your session should look similar to this screen:
@@ -60,13 +57,13 @@ In this tutorial, you learn how to use a test certificate to access the MS Graph
60
57
61
58
## Get data using the Azure Active Directory reporting API with certificates
62
59
63
-
1.Navigate to the [Azure portal](https://portal.azure.com), select**Azure Active Directory**, then select**App registrations** and choose your application from the list.
60
+
1.Go to the [Azure portal](https://portal.azure.com) >**Azure Active Directory** >**App registrations** and choose your application from the list.
64
61
65
-
2.Select **Certificates & secrets** under **Manage** section on Application registration blade and select **Upload Certificate**.
62
+
2.From the Application registration area, select **Certificates & secrets** under the **Manage** section, and then select **Upload Certificate**.
66
63
67
64
3. Select the certificate file from the previous step and select **Add**.
68
65
69
-
4. Note the Application ID, and the thumbprint of the certificate you just registered with your application. To find the thumbprint, from your application page in the portal, go to **Certificates & secrets** under **Manage** section. The thumbprint will be under the **Certificates** list.
66
+
4. Note the Application ID, and the thumbprint of the certificate you registered with your application. To find the thumbprint, from your application page in the portal, go to **Certificates & secrets** under **Manage** section. The thumbprint will be under the **Certificates** list.
70
67
71
68
5. Open the application manifest in the inline manifest editor and verify the *keyCredentials* property is updated with your new certificate information as shown below -
72
69
@@ -85,13 +82,13 @@ In this tutorial, you learn how to use a test certificate to access the MS Graph
85
82
86
83

87
84
88
-
7. Use the access token in your PowerShell script to query the Graph API. Use the **Invoke-MSCloudIdMSGraphQuery** cmdlet from the MSCloudIDUtils to enumerate the signins and directoryAudits endpoint. This cmdlet handles multi-paged results, and sends those results to the PowerShell pipeline.
85
+
7. Use the access token in your PowerShell script to query the Graph API. Use the **Invoke-MSCloudIdMSGraphQuery** cmdlet from the MSCloudIDUtils to enumerate the `signins` and `directoryAudits` endpoint. This cmdlet handles multi-paged results, and sends those results to the PowerShell pipeline.
89
86
90
-
8. Query the directoryAudits endpoint to retrieve the audit logs.
87
+
8. Query the `directoryAudits` endpoint to retrieve the audit logs.
91
88
92
89

93
90
94
-
9. Query the signins endpoint to retrieve the sign-in logs.
91
+
9. Query the `signins` endpoint to retrieve the sign-in logs.
95
92
96
93

Copy file name to clipboardExpand all lines: articles/active-directory/reports-monitoring/tutorial-azure-monitor-stream-logs-to-event-hub.md
+5-11Lines changed: 5 additions & 11 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -2,23 +2,18 @@
2
2
title: Tutorial - Stream logs to an Azure event hub | Microsoft Docs
3
3
description: Learn how to set up Azure Diagnostics to push Azure Active Directory logs to an event hub
4
4
services: active-directory
5
-
documentationcenter: ''
6
-
author: MarkusVi
5
+
author: shlipsey3
7
6
manager: amycolannino
8
-
editor: ''
9
-
10
-
ms.assetid: 045f94b3-6f12-407a-8e9c-ed13ae7b43a3
11
7
ms.service: active-directory
12
8
ms.topic: tutorial
13
-
ms.tgt_pltfrm: na
14
9
ms.workload: identity
15
10
ms.subservice: report-monitor
16
-
ms.date: 08/26/2022
17
-
ms.author: markvi
11
+
ms.date: 10/31/2022
12
+
ms.author: sarahlipsey
18
13
ms.reviewer: besiler
14
+
ms.collection: M365-identity-device-management
19
15
20
16
# Customer intent: As an IT administrator, I want to learn how to route Azure AD logs to an event hub so I can integrate it with my third party SIEM system.
21
-
ms.collection: M365-identity-device-management
22
17
---
23
18
# Tutorial: Stream Azure Active Directory logs to an Azure event hub
24
19
@@ -30,7 +25,7 @@ To use this feature, you need:
30
25
31
26
* An Azure subscription. If you don't have an Azure subscription, you can [sign up for a free trial](https://azure.microsoft.com/free/).
32
27
* An Azure AD tenant.
33
-
* A user who's a *global administrator* or *security administrator* for the Azure AD tenant.
28
+
* A user who's a *Global Administrator* or *Security Administrator* for the Azure AD tenant.
34
29
* An Event Hubs namespace and an event hub in your Azure subscription. Learn how to [create an event hub](../../event-hubs/event-hubs-create.md).
35
30
36
31
## Stream logs to an event hub
@@ -95,6 +90,5 @@ After data is displayed in the event hub, you can access and read the data in tw
95
90
*[Integrate Azure Active Directory logs with ArcSight using Azure Monitor](howto-integrate-activity-logs-with-arcsight.md)
96
91
*[Integrate Azure AD logs with Splunk by using Azure Monitor](./howto-integrate-activity-logs-with-splunk.md)
97
92
*[Integrate Azure AD logs with SumoLogic by using Azure Monitor](howto-integrate-activity-logs-with-sumologic.md)
98
-
*[Integrate Azure AD logs with Elastic using an event hub](https://github.com/Microsoft/azure-docs/blob/master/articles/active-directory/reports-monitoring/tutorial-azure-monitor-stream-logs-to-event-hub.md)
99
93
*[Interpret audit logs schema in Azure Monitor](./overview-reports.md)
100
94
*[Interpret sign-in logs schema in Azure Monitor](reference-azure-monitor-sign-ins-log-schema.md)
Copy file name to clipboardExpand all lines: articles/active-directory/reports-monitoring/tutorial-log-analytics-wizard.md
+5-5Lines changed: 5 additions & 5 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -6,10 +6,10 @@ services: active-directory
6
6
ms.service: active-directory
7
7
ms.subservice: report-monitor
8
8
ms.topic: tutorial
9
-
ms.date: 08/26/2022
9
+
ms.date: 10/31/2022
10
10
11
-
ms.author: markvi
12
-
author: MarkusVi
11
+
ms.author: sarahlipsey
12
+
author: shlipsey3
13
13
manager: amycolannino
14
14
ms.reviewer: sandeo
15
15
@@ -33,9 +33,9 @@ In this tutorial, you learn how to:
33
33
34
34
- An Azure subscription with at least one P1 licensed admin. If you don't have an Azure subscription, you can [sign up for a free trial](https://azure.microsoft.com/free/).
35
35
36
-
- An Azure AD tenant.
36
+
- An Azure Active Directory (Azure AD) tenant.
37
37
38
-
- A user who's a global administrator or security administrator for the Azure AD tenant.
38
+
- A user who's a Global Administrator or Security Administrator for the Azure AD tenant.
0 commit comments