Create an access review of group members or application access with Azure AD

Access to groups and applications for employees and guests changes over time. To reduce the risk associated with stale access assignments, administrators can use Azure Active Directory (Azure AD) to create access reviews for group members or application access. If you need to routinely review access, you can also create recurring access reviews. For more information about these scenarios, see Manage user access and Manage guest access.

This article describes how to create a new access review for group members or application access.

Prerequisites

Create an access review

  1. Sign-in to the Azure portal and open the Access Reviews page.

  2. Click Controls.

  3. Click New access review to create a new access review.

    Access review - Controls

  4. Name the access review. Optionally, give the review a description. The name and description are shown to the reviewers.

    Create an access review - Review name and description

  5. Set the Start date. By default, an access review occurs once, starts the same time it's created, and it ends in one month. You can change the start and end dates to have an access review start in the future and last however many days you want.

    Create an access review - Start and end dates

  6. To make the access review recurring, change the Frequency setting from One time to Weekly, Monthly, Quarterly or Annually, and use the Duration slider or text box to define how many days each review of the recurring series will be open for input from reviewers. For example, the maximum duration that you can set for a monthly review is 27 days, to avoid overlapping reviews.

  7. Use the End setting to specify how to end the recurring access review series. The series can end in three ways: it runs continuously to start reviews indefinitely, until a specific date, or after a defined number of occurrences has been completed. You, another User Account Administrator, or another Global Administrator can stop the series after creation by changing the date in Settings, so that it ends on that date.

  8. In the Users section, specify the users that access review applies to. Access reviews can be for the members of a group or for users who were assigned to an application. You can further scope the access review to review only the guest users who are members (or assigned to the application), rather than reviewing all the users who are members or who have access to the application.

    Create an access review - Users

  9. In the Reviewers section, select either one or more people to review all the users in scope. Or you can select to have the members review their own access. If the resource is a group, you can ask the group owners to review. You also can require that the reviewers supply a reason when they approve access.

    Create an access review - Reviewers

  10. In the Programs section, select the program you want to use. You can simplify how to track and collect access reviews for different purposes by organizing them into programs. Default Program is always present, or you can create a different program. For example, you can choose to have one program for each compliance initiative or business goal.

    Create an access review - Programs

Upon completion settings

  1. To specify what happens after a review completes, expand the Upon completion settings section.

    Upon completion settings

  2. If you want to automatically remove access for users that were denied, set Auto apply results to resource to Enable. If you want to manually apply the results when the review completes, set the switch to Disable.

  3. Use the Should reviewer not respond list to specify what happens for users that are not reviewed by the reviewer within the review period. This setting does not impact users who have been reviewed by the reviewers manually. If the final reviewer's decision is Deny, then the user's access will be removed.

    • No change - Leave user's access unchanged
    • Remove access - Remove user's access
    • Approve access - Approve user's access
    • Take recommendations - Take the system's recommendation on denying or approving the user's continued access

Advanced settings

  1. To specify additional settings, expand the Advanced settings section.

    Advanced settings

  2. Set Show recommendations to Enable to show the reviewers the system recommendations based the user's access information.

  3. Set Require reason on approval to Enable to require the reviewer to supply a reason for approval.

  4. Set Mail notifications to Enable to have Azure AD send email notifications to reviewers when an access review starts, and to administrators when a review completes.

  5. Set Reminders to Enable to have Azure AD send reminders of access reviews in progress to reviewers who have not completed their review.

Start the access review

Once you have specified the settings for an access review, click Start.

By default, Azure AD sends an email to reviewers shortly after the review starts. If you choose not to have Azure AD send the email, be sure to inform the reviewers that an access review is waiting for them to complete. You can show them the instructions for how to review access. If your review is for guests to review their own access, show them the instructions for how to review your own access.

If some of the reviewers are guests, guests are notified via email only if they've already accepted their invitation.

Manage the access review

You can track the progress as the reviewers complete their reviews in the Azure AD dashboard in the Access Reviews section. No access rights are changed in the directory until the review is completed.

If this is a one-time review, then after the access review period is over or the administrator stops the access review, follow the steps in Complete an access review to see and apply the results.

To manage a series of access reviews, navigate to the access review from Controls, and you will find upcoming occurrences in Scheduled reviews, and edit the end date or add/remove reviewers accordingly.

Based on your selections in Upon completion settings, auto-apply will be executed after the review's end date or when you manually stop the review. The status of the review will change from Completed through intermediate states such as Applying and finally to state Applied. You should expect to see denied users, if any, being removed from the group membership or application assignment in a few minutes.

Create reviews via APIs

You can also create access reviews using APIs. What you do to manage access reviews of groups and application users in the Azure portal can also be done using Microsoft Graph APIs. For more information, see the Azure AD Access Reviews API reference. For a code sample, see Example of retrieving Azure AD Access Reviews via Microsoft Graph.

Next steps