01-Access.md

July 27, 2023 ยท View on GitHub

Scenario

Suppose we need to give a member in our organization (Johanna L) access to search the Unified Audit Log (UAL) natively using Purview Audit within the Compliance Portal. Additionally, we need to make sure that the principle of least privilege has been followed to align with security best practices. How would we do this? Read on to find out!

Pitfalls to avoid

Even though there are "Audit Reader" roles in both Microsoft 365 Defender and Microsoft Purview Compliance, these will not give someone access to Purview Audit. The correct way detailed below is by assigning the permission within Exchange Online.

The reason for this is because searching the audit log leverages Exchange Online PowerShell Cmdlets under the hood.

Pre-Requisites

You will need to have the appropriate licensing & Role Management RBAC role in Exchange Online before executing the below steps.

Steps

Screenshot Key

Colour of boxMeaning
RedRed boxes indicate where to click and/or enter text
OrangeOrange boxes indicates reviewing the information entered
  1. Navigate to Admin Roles within the Exchange Admin Center (EAC) and Click Add Role Group which will start the wizard.

  1. Specify a name and description for the role group. An example is provided below. Once satisfied, Click Next.

  1. Search for "Audit" and you should see the two roles below.

  1. Tick the "View-Only Audit Logs" option and Click Next.

  1. Type in the user who should receive this permission. For our scenario, we will choose Johanna L as shown below. Once satisfied, Click Next.

  1. Review the details you've provided in Steps 2-5. If there are any mistakes, go back and change them. If all is fine then click Create Role Group and wait a short while.

  • 7a) Verify the Status shows the role group has been added. Once satisfied, click Done.

  • 7b) Ensure the newly created Role Group is available within EAC. This will be useful if we need to add more members in future. To do this, search for "Audit" in the Exchange Admin Center > Admin Roles page. As you can see, the screenshot below shows our role group is visible within the EAC Admin Roles page.

Validating Access

  1. Navigate to the Purview Audit solution within the Compliance Portal and log in as the member who you gave permissions to. For our scenario, the member was Johanna L. If you've done everything correctly, the Audit page will be visible and clickable to said member as shown below.

Troubleshooting

  • If the member sees a greyed out page for Purview Audit then it means the permissions haven't been assigned correctly.
  • To fix this, repeat the steps on this page ensuring everything is done correctly and this should resolve the issue.

References

Assign permissions to search the audit log