From 188144db3666f490e790173f5c741130521a5827 Mon Sep 17 00:00:00 2001 From: Faith Moraa Ombongi Date: Tue, 30 Jan 2024 21:02:01 +0300 Subject: [PATCH 1/2] Link to license requirements for different Entra reports --- .../resources/azure-ad-auditlog-overview.md | 22 +++++++------------ .../beta/resources/credentialusagesummary.md | 2 +- .../credentialuserregistrationcount.md | 2 +- .../resources/usercredentialusagedetails.md | 2 +- .../beta/resources/userregistrationdetails.md | 2 +- .../userregistrationfeaturesummary.md | 2 +- .../userregistrationmethodsummary.md | 2 +- .../resources/azure-ad-auditlog-overview.md | 21 +++++++----------- .../v1.0/resources/userregistrationdetails.md | 2 +- .../userregistrationfeaturesummary.md | 2 +- .../userregistrationmethodsummary.md | 2 +- 11 files changed, 25 insertions(+), 36 deletions(-) diff --git a/api-reference/beta/resources/azure-ad-auditlog-overview.md b/api-reference/beta/resources/azure-ad-auditlog-overview.md index 548e9421d82..e59e9f4a493 100644 --- a/api-reference/beta/resources/azure-ad-auditlog-overview.md +++ b/api-reference/beta/resources/azure-ad-auditlog-overview.md @@ -66,20 +66,14 @@ GET custom security attribute audit logs | [https://graph.microsoft.com/beta/aud GET tenant user sign-ins | [https://graph.microsoft.com/beta/auditLogs/signIns](https://developer.microsoft.com/graph/graph-explorer?request=auditLogs/signIns&version=beta) GET provisioning logs | [https://graph.microsoft.com/beta/auditLogs/provisioning](https://developer.microsoft.com/graph/graph-explorer?request=auditLogs/Provisioning&version=beta) -## What licenses do I need? +## License requirements -Activity reports are available for features that you've licensed. If you have a license for a specific feature, you also have access to the reports. +Activity reports are available for features that you've licensed. If you have a license for a specific feature, you also have access to the reports. For more information about license requirements for the different activity reports, see [Microsoft Entra audit logs: License and role requirements](/entra/identity/monitoring-health/concept-audit-logs#license-and-role-requirements). -For example, you need a Microsoft Entra ID P1 license to access self-service password audit reports. To learn more, see [Microsoft Entra ID licensing](https://azure.microsoft.com/pricing/details/active-directory/). +## Related content -Sign-in reports require a Microsoft Entra ID P1 or P2 license. - -To learn more, see [Microsoft Entra pricing](https://azure.microsoft.com/pricing/details/active-directory/). - -## Next steps - -- [Register your app](/azure/active-directory/active-directory-reporting-api-prerequisites-azure-portal) to satisfy report prerequisites. -- To learn how to retrieve audit logs while authenticated using certificates, see [Tutorial: Get data using the Microsoft Entra reporting API with certificates](/azure/active-directory/reports-monitoring/tutorial-access-api-with-certificates). -- Review the [directoryAudit](directoryaudit.md) resource and actions. -- Review the [signIn](signin.md) resource and actions. -- Review the [provisioningObjectSummary](provisioningobjectsummary.md) resource. +- Start working with the following resources representing the different activity reports: + - [directoryAudit](directoryaudit.md) resource type. + - [signIn](signin.md) resource type. + - [provisioningObjectSummary](provisioningobjectsummary.md) resource type. + - [customSecurityAttributeAudit](customsecurityattributeaudit.md) resource type. diff --git a/api-reference/beta/resources/credentialusagesummary.md b/api-reference/beta/resources/credentialusagesummary.md index 9a1a7ca1ef5..e0dd809b729 100644 --- a/api-reference/beta/resources/credentialusagesummary.md +++ b/api-reference/beta/resources/credentialusagesummary.md @@ -13,7 +13,7 @@ Namespace: microsoft.graph [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] -Represents the current state of how many users in your organization are using self-service password reset capabilities. +Represents the current state of how many users in your organization are using self-service password reset capabilities. For more information about license requirements for this feature, see [Authentication Methods Activity: Permissions and licenses](/entra/identity/authentication/howto-authentication-methods-activity#permissions-and-licenses). ## Methods diff --git a/api-reference/beta/resources/credentialuserregistrationcount.md b/api-reference/beta/resources/credentialuserregistrationcount.md index f188020cc0d..3131df667d3 100644 --- a/api-reference/beta/resources/credentialuserregistrationcount.md +++ b/api-reference/beta/resources/credentialuserregistrationcount.md @@ -13,7 +13,7 @@ Namespace: microsoft.graph [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] -Represents the current state of how many users in your organization are registered for self-service password reset and multifactor authentication capabilities. +Represents the current state of how many users in your organization are registered for self-service password reset and multifactor authentication capabilities. For more information about license requirements for this feature, see [Authentication Methods Activity: Permissions and licenses](/entra/identity/authentication/howto-authentication-methods-activity#permissions-and-licenses). ## Methods diff --git a/api-reference/beta/resources/usercredentialusagedetails.md b/api-reference/beta/resources/usercredentialusagedetails.md index 63112165714..da37e1ec031 100644 --- a/api-reference/beta/resources/usercredentialusagedetails.md +++ b/api-reference/beta/resources/usercredentialusagedetails.md @@ -13,7 +13,7 @@ Namespace: microsoft.graph [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] -Represents the self-service password reset usage for a given tenant. Details include user information, status of the reset, and the reason for failure. +Represents the self-service password reset usage for a given tenant. Details include user information, status of the reset, and the reason for failure. For more information about license requirements for this feature, see [Authentication Methods Activity: Permissions and licenses](/entra/identity/authentication/howto-authentication-methods-activity#permissions-and-licenses). ## Methods diff --git a/api-reference/beta/resources/userregistrationdetails.md b/api-reference/beta/resources/userregistrationdetails.md index ebb7cf724b5..99354e25b9e 100644 --- a/api-reference/beta/resources/userregistrationdetails.md +++ b/api-reference/beta/resources/userregistrationdetails.md @@ -13,7 +13,7 @@ Namespace: microsoft.graph [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] -Represents the state of a user's authentication methods, including which methods are registered and which features the user is registered and capable of. (For example, multifactor authentication, self-service password reset, and passwordless authentication.) +Represents the state of a user's authentication methods, including which methods are registered and which features the user is registered and capable of. For example, multifactor authentication, self-service password reset, and passwordless authentication. For more information about license requirements for this feature, see [Authentication Methods Activity: Permissions and licenses](/entra/identity/authentication/howto-authentication-methods-activity#permissions-and-licenses). Inherits from [entity](../resources/entity.md). diff --git a/api-reference/beta/resources/userregistrationfeaturesummary.md b/api-reference/beta/resources/userregistrationfeaturesummary.md index d7feae88e6c..00c69f2d694 100644 --- a/api-reference/beta/resources/userregistrationfeaturesummary.md +++ b/api-reference/beta/resources/userregistrationfeaturesummary.md @@ -13,7 +13,7 @@ Namespace: microsoft.graph [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] -Represents the summary of users capable of multifactor authentication, self-service password reset, and passwordless authentication in an organization. +Represents the summary of users capable of multifactor authentication, self-service password reset, and passwordless authentication in an organization. For more information about license requirements for this feature, see [Authentication Methods Activity: Permissions and licenses](/entra/identity/authentication/howto-authentication-methods-activity#permissions-and-licenses). ## Methods diff --git a/api-reference/beta/resources/userregistrationmethodsummary.md b/api-reference/beta/resources/userregistrationmethodsummary.md index d48876e3ded..1a2ae20c4c6 100644 --- a/api-reference/beta/resources/userregistrationmethodsummary.md +++ b/api-reference/beta/resources/userregistrationmethodsummary.md @@ -13,7 +13,7 @@ Namespace: microsoft.graph [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] -Represents the summary of number of users registered for each authentication method. +Represents the summary of number of users registered for each authentication method. For more information about license requirements for this feature, see [Authentication Methods Activity: Permissions and licenses](/entra/identity/authentication/howto-authentication-methods-activity#permissions-and-licenses). ## Methods diff --git a/api-reference/v1.0/resources/azure-ad-auditlog-overview.md b/api-reference/v1.0/resources/azure-ad-auditlog-overview.md index 7a4504241be..f49068b56c4 100644 --- a/api-reference/v1.0/resources/azure-ad-auditlog-overview.md +++ b/api-reference/v1.0/resources/azure-ad-auditlog-overview.md @@ -50,22 +50,17 @@ Operation | URL GET tenant user activities | [GET https://graph.microsoft.com/v1.0/auditLogs/directoryAudits](https://developer.microsoft.com/graph/graph-explorer?request=auditLogs/directoryAudits&version=v1.0) GET tenant user sign-ins | [GET https://graph.microsoft.com/v1.0/auditLogs/signIns](https://developer.microsoft.com/graph/graph-explorer?request=auditLogs/signIns&version=v1.0) -## What licenses do I need? +## License requirements -Activity reports are available for features that you've licensed. If you have a license for a specific feature, you also have access to the reports. +Activity reports are available for features that you've licensed. If you have a license for a specific feature, you also have access to the reports. For more information about license requirements for the different activity reports, see [Microsoft Entra audit logs: License and role requirements](/entra/identity/monitoring-health/concept-audit-logs#license-and-role-requirements). -For example, you need a Microsoft Entra ID P1 license to access self-service password audit reports. To learn more, see [Microsoft Entra ID licensing](https://azure.microsoft.com/pricing/details/active-directory/). +## Related content -Sign-in reports require a Microsoft Entra ID P1 or P2 license. - -To learn more, see [Microsoft Entra pricing](https://azure.microsoft.com/pricing/details/active-directory/). - -## Next Steps - -- [Register your app](/azure/active-directory/active-directory-reporting-api-prerequisites-azure-portal) to satisfy report prerequisites. -- To learn how to retrieve audit logs while authenticated using certificates, see [Tutorial: Get data using the Microsoft Entra reporting API with certificates](/azure/active-directory/reports-monitoring/tutorial-access-api-with-certificates). -- Review [directoryAudit](directoryaudit.md) resource and actions. -- Review [signIn](signin.md) resource and actions. +- Start working with the following resources representing the different activity reports: + - [directoryAudit](directoryaudit.md) resource type. + - [signIn](signin.md) resource type. + - [provisioningObjectSummary](provisioningobjectsummary.md) resource type. + - [customSecurityAttributeAudit](customsecurityattributeaudit.md) resource type. + \ No newline at end of file