Skip to content

Commit bf27127

Browse files
committed
image-updates
1 parent a4486b3 commit bf27127

17 files changed

+55
-24
lines changed

articles/active-directory/reports-monitoring/howto-use-recommendations.md

Lines changed: 22 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@ ms.service: active-directory
88
ms.topic: how-to
99
ms.workload: identity
1010
ms.subservice: report-monitor
11-
ms.date: 03/03/2023
11+
ms.date: 03/06/2023
1212
ms.author: sarahlipsey
1313
ms.reviewer: hafowler
1414
---
@@ -37,31 +37,39 @@ There are different role requirements for viewing or updating a recommendation.
3737
| Security Operator | Update and read |
3838
| Security Administrator | Update and read |
3939

40-
Some recommendations may require a P2 or other license. Refer to the [Recommendation availability and license requirements](overview-recommendations.md#recommendation-availability-and-license-requirements).
40+
Some recommendations may require a P2 or other license. For more information, see [Recommendation availability and license requirements](overview-recommendations.md#recommendation-availability-and-license-requirements).
4141

4242
## How to read a recommendation
4343

44-
To view the details of a recommendation, sign in to Azure using a least-privileged role for read-only access.
44+
To view the details of a recommendation:
45+
1. Sign in to Azure using the appropriate least-privilege role.
46+
1. Go to **Azure AD** > **Recommendations** and select a recommendation from the list.
47+
48+
![Screenshot of the list of recommendations.](./media/howto-use-recommendations/recommendations-list.png)
4549

4650
Each recommendation provides the same set of details that explain what the recommendation is, why it's important, and how to fix it.
4751

48-
The **Status** of a recommendation can be updated manually or automatically by the system. If all resources are addressed according to the action plan, the status automatically changes to *Completed* the next time the recommendations service runs. The recommendation service runs every 24-48 hours, depending on the recommendation.
52+
![Screenshot of a recommendation's status, priority, and impacted resource type.](./media/howto-use-recommendations/recommendation-status-risk.png)
4953

50-
The **Priority** of a recommendation could be low, medium, or high. These values are determined by several factors, such as security implications, health concerns, or potential breaking changes.
54+
- The **Status** of a recommendation can be updated manually or automatically by the system. If all resources are addressed according to the action plan, the status automatically changes to *Completed* the next time the recommendations service runs. The recommendation service runs every 24-48 hours, depending on the recommendation.
5155

52-
- **High**: Must do. Not acting will result in severe security implications or potential downtime.
53-
- **Medium**: Should do. No severe risk if action isn't taken.
54-
- **Low**: Might do. No security risks or health concerns if action isn't taken.
56+
- The **Priority** of a recommendation could be low, medium, or high. These values are determined by several factors, such as security implications, health concerns, or potential breaking changes.
5557

56-
The **Impacted resources** for a recommendation could be things like applications or users. This detail gives you an idea of what type of resources you need to address. The impacted resource could also be at the tenant level, so you may need to make a global change.
58+
- **High**: Must do. Not acting will result in severe security implications or potential downtime.
59+
- **Medium**: Should do. No severe risk if action isn't taken.
60+
- **Low**: Might do. No security risks or health concerns if action isn't taken.
5761

58-
![Screenshot of a recommendation's status, priority, and impacted resource type.](./media/howto-use-recommendations/recommendation-status-risk.png)
62+
- The **Impacted resource type** for a recommendation could be applications, users, or your full tenant. This detail gives you an idea of what type of resources you need to address. If the impacted resource is at the tenant level, you may need to make a global change.
5963

60-
The **Status description** tells you the date the recommendation status changed and if it was changed by the system or a user.
64+
![Screenshot of the recommendation status description, description, and value.](media/howto-use-recommendations/status-description-value.png)
6165

62-
The recommendation's **Value** is an explanation of why completing the recommendation will benefit you, and the value of the associated feature.
66+
- The **Status description** tells you the date the recommendation status changed and if it was changed by the system or a user.
6367

64-
The **Action plan** provides step-by-step instructions to implement a recommendation. May include links to relevant documentation or direct you to other pages in the Azure AD portal.
68+
- The recommendation's **Value** is an explanation of why completing the recommendation will benefit you, and the value of the associated feature.
69+
70+
- The **Action plan** provides step-by-step instructions to implement a recommendation. The Action plan may include links to relevant documentation or direct you to other pages in the Azure AD portal.
71+
72+
- If the impacted resource type is applications, a list of the **Impacted resources** appears at the bottom of the recommendation. The resource's name, ID, date it was first detected, and status are provided.
6573

6674
## How to update a recommendation
6775

@@ -71,8 +79,6 @@ To update the status of a recommendation or a related resource, sign in to Azure
7179

7280
1. Select a recommendation from the list to view the details, status, and action plan.
7381

74-
![Screenshot of the list of recommendations.](./media/howto-use-recommendations/recommendations-list.png)
75-
7682
1. Follow the **Action plan**.
7783

7884
1. If applicable, *right-click on the status* of a resource in a recommendation, select **Mark as**, then select a status.
@@ -101,7 +107,7 @@ Continue to monitor the recommendations in your tenant for changes.
101107

102108
Azure Active Directory recommendations can be viewed and managed using Microsoft Graph on the `/beta` endpoint. You can view recommendations along with their impacted resources, mark a recommendation as completed by a user, postpone a recommendation for later, and more.
103109

104-
To get started, follow these instructions to work with recommendations using Microsoft Graph in Graph Explorer. The example uses the Migrate apps from Active Directory Federated Services (ADFS) to Azure AD recommendation.
110+
To get started, follow these instructions to work with recommendations using Microsoft Graph in Graph Explorer. The example uses the "Migrate apps from Active Directory Federated Services (ADFS) to Azure AD" recommendation.
105111

106112
1. Sign in to [Graph Explorer](https://aka.ms/ge).
107113
1. Select **GET** as the HTTP method from the dropdown.
13.2 KB
Loading
102 KB
Loading
Loading
Loading
Loading
Loading
Loading

0 commit comments

Comments
 (0)