Skip to content

Commit 257c2a8

Browse files
committed
rearranging
1 parent f856ddc commit 257c2a8

File tree

2 files changed

+49
-60
lines changed

2 files changed

+49
-60
lines changed

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

Lines changed: 40 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -23,18 +23,51 @@ The Azure Active Directory (Azure AD) recommendations feature provides you with
2323

2424
This article covers how to work with Azure AD recommendations. Each Azure AD recommendation contains similar details such as a description, the value of addressing the recommendation, and the steps to address the recommendation. Microsoft Graph API guidance is also provided in this article.
2525

26-
## Access and view the details of a recommendation
26+
## Role requirements
2727

28-
To update the status of a recommendation or a related resource, sign in to Azure using a least privilege role for *update and read-only* access.
28+
There are different role requirements for viewing or updating a recommendation. Use the least-privileged role for the type of access needed.
2929

30-
- Security Administrator
31-
- Security Operator
32-
- Cloud apps Administrator
33-
- Apps Administrator
30+
| Azure AD role | Access type |
31+
|---- |---- |
32+
| Reports Reader | Read-only |
33+
| Security Reader | Read-only |
34+
| Global Reader | Read-only |
35+
| Cloud apps Administrator | Update and read |
36+
| Apps Administrator | Update and read |
37+
| Security Operator | Update and read |
38+
| Security Administrator | Update and read |
39+
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).
41+
42+
## How to read a recommendation
43+
44+
Each recommendation provides the same set of details that explain what the recommendation is, why it's important, and how to fix it.
45+
46+
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.
47+
48+
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.
49+
50+
- **High**: Must do. Not acting will result in severe security implications or potential downtime.
51+
- **Medium**: Should do. No severe risk if action isn't taken.
52+
- **Low**: Might do. No security risks or health concerns if action isn't taken.
53+
54+
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.
55+
56+
![Screenshot of a recommendation's status, priority, and impacted resource type.](./media/overview-recommendations/recommendation-status-risk.png)
57+
58+
The **Status description** tells you the date the recommendation status changed and if it was changed by the system or a user.
59+
60+
The recommendation's **Value** is an explanation of why completing the recommendation will benefit you, and the value of the associated feature.
61+
62+
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.
63+
64+
## How to update a recommendation
65+
66+
To update the status of a recommendation or a related resource, sign in to Azure using a least-privileged role for updating a recommendation.
3467

3568
1. Go to **Azure AD** > **Recommendations**.
3669

37-
1. Select a recommendation from the list to view the details, status, and action plan.
70+
1. Select a recommendation from the list to view the details, status, and action plan.
3871

3972
![Screenshot of the list of recommendations.](./media/howto-use-recommendations/recommendations-list.png)
4073

articles/active-directory/reports-monitoring/overview-recommendations.md

Lines changed: 9 additions & 53 deletions
Original file line numberDiff line numberDiff line change
@@ -35,60 +35,18 @@ This article gives you an overview of how you can use Azure AD recommendations.
3535
The Azure AD recommendations feature is the Azure AD specific implementation of [Azure Advisor](../../advisor/advisor-overview.md), which is a personalized cloud consultant that helps you follow best practices to optimize your Azure deployments. Azure Advisor analyzes your resource configuration and usage data to recommend solutions that can help you improve the cost effectiveness, performance, reliability, and security of your Azure resources.
3636

3737
*Azure AD recommendations* use similar data to support you with the roll-out and management of Microsoft's best practices for Azure AD tenants to keep your tenant in a secure and healthy state. The Azure AD recommendations feature provides a holistic view into your tenant's security, health, and usage.
38-
39-
## How it works
40-
41-
On a daily basis, Azure AD analyzes the configuration of your tenant. During this analysis, Azure AD compares the data of a recommendation with the actual configuration of your tenant. If a recommendation is flagged as applicable to your tenant, the recommendation appears in the **Recommendations** section of the Azure AD Overview area. The recommendations are listed in order of priority so you can quickly determine where to focus first.
42-
43-
Each recommendation contains a description, a summary of the value of addressing the recommendation, and a step-by-step action plan. If applicable, impacted resources associated with the recommendation are listed, so you can resolve each affected area. If a recommendation doesn't have any associated resources, the impacted resource type is *Tenant level*, so your step-by-step action plan impacts the entire tenant and not just a specific resource.
44-
45-
![Screenshot of the Overview page of the tenant with the Recommendations option highlighted.](./media/overview-recommendations/recommendations-preview-option-tenant-overview.png)
46-
47-
>[!TIP]
48-
>Looking for how to view and manage recommendations using Microsoft Graph? Check out the Microsoft Graph section of the **[How to use Azure AD recommendations](howto-use-recommendations.md#use-microsoft-graph-with-azure-active-directory-recommendations)** article.
49-
>
50-
51-
## Recommendation details
52-
53-
Each recommendation provides the same set of details that explain what the recommendation is, why it's important, and how to fix it.
54-
55-
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.
56-
57-
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.
58-
59-
- **High**: Must do. Not acting will result in severe security implications or potential downtime.
60-
- **Medium**: Should do. No severe risk if action isn't taken.
61-
- **Low**: Might do. No security risks or health concerns if action isn't taken.
6238

63-
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.
64-
65-
![Screenshot of a recommendation's status, priority, and impacted resource type.](./media/overview-recommendations/recommendation-status-risk.png)
66-
67-
The **Status description** tells you the date the recommendation status changed and if it was changed by the system or a user.
68-
69-
The recommendation's **Value** is an explanation of why completing the recommendation will benefit you, and the value of the associated feature.
70-
71-
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.
72-
73-
## Roles and licenses
39+
## How it works
7440

75-
| Azure AD role | Access type |
76-
|---- |---- |
77-
| Reports Reader | Read-only |
78-
| Security Reader | Read-only |
79-
| Global Reader | Read-only |
80-
| Cloud apps Administrator | Update and read |
81-
| Apps Administrator | Update and read |
82-
| Security Operator | Update and read |
83-
| Security Administrator | Update and read |
41+
On a daily basis, Azure AD analyzes the configuration of your tenant. During this analysis, Azure AD compares the data of a recommendation with the actual configuration of your tenant. If a recommendation is flagged as applicable to your tenant, the recommendation appears in the **Recommendations** section of the Azure AD Overview area. The recommendations are listed in order of priority so you can quickly determine where to focus first.
8442

85-
The Azure AD recommendations feature is automatically enabled. If you'd like to disable this feature, go to **Azure AD** > **Preview features**. Locate the **Recommendations** feature, and change the **State**.
43+
![Screenshot of the Overview page of the tenant with the Recommendations option highlighted.](./media/overview-recommendations/recommendations-preview-option-tenant-overview.png)
8644

87-
Azure AD only displays the recommendations that apply to your tenant, so you may not see all supported recommendations listed. Currently, all recommendations are available in all tenants, regardless of the license type.
45+
Each recommendation contains a description, a summary of the value of addressing the recommendation, and a step-by-step action plan. If applicable, impacted resources associated with the recommendation are listed, so you can resolve each affected area. If a recommendation doesn't have any associated resources, the impacted resource type is *Tenant level*, so your step-by-step action plan impacts the entire tenant and not just a specific resource.
8846

89-
### Recommendation availability and license requirements
47+
## Recommendation availability and license requirements
9048

91-
The recommendations listed in the following table are currently available as a public preview or general availability. The license requirements for recommendations in public preview are subject to change. The table provides the impacted resources and links to available documentation.
49+
The recommendations listed in the following table are currently available in public preview or general availability. The license requirements for recommendations in public preview are subject to change. The table provides the impacted resources and links to available documentation.
9250

9351
| Recommendation | Impacted resources | Required license | Availability |
9452
|---- |---- |---- |---- |
@@ -101,11 +59,9 @@ The recommendations listed in the following table are currently available as a p
10159
| [Renew expiring application credentials](recommendation-renew-expiring-application-credential.md) | Applications | P2 | Preview |
10260
| [Renew expiring service principal credentials](recommendation-renew-expiring-service-principal-credential.md) | Applications | P2 | Preview |
10361

62+
Azure AD only displays the recommendations that apply to your tenant, so you may not see all supported recommendations listed.
63+
10464
## Next steps
10565

10666
* [Learn how to use Azure AD recommendations](howto-use-recommendations.md)
107-
* [Explore the details of the "Turn off per-user MFA" recommendation](recommendation-turn-off-per-user-mfa.md)
108-
109-
110-
111-
The recommendations listed in the following table are currently available to Azure AD tenants with a P2 license (subject to change).
67+
* [Explore the details of the "Turn off per-user MFA" recommendation](recommendation-turn-off-per-user-mfa.md)

0 commit comments

Comments
 (0)