Assign AzureAD/O365 Roles based on groups

In nearly every engagement I get the question why it’s not possible to assign Azure AD roles based on Azure AD or synced AD groups. Also, in my opinion this would be a nice feature to have in a productive environment. I started building a solution based on Azure Automation, which takes care of it with the following features:

  • Assigning Azure AD Roles based on group memberships.
  • Ignoring Service principals assigned to roles.
  • Automatically creates new groups for new roles.
  • Possibility to exclude some roles and user accounts from automatic management. For example, the Emergency Account can be excluded so it will never lose his permissions.

In this blog I explain how you can setup this in your environment. First of all we need an Azure Automation account, if you don’t have one you can start by following this guide: https://docs.microsoft.com/en-us/azure/automation/automation-create-standalone-account

Important is, that you also create the Run As account:

As soon you have setup the Automation account, we can start configuring the solution.

Grant Azure AD Permission to the Automation account

The newly created account does not have any permissions in our environment. This we have to change first.

First of all, we have to get the Service principal ID of the Run As account. To get this click on “Run as Accounts” in the main menu of the Automation account.
Then select the “Azure Run As Account” and not the classic account.
Now you can copy the Service Principal Object ID.

# Enter your Run as account Service Principal ID

$SPId
=
“ENTER YOUR GUID”

# Connect to Azure AD

Connect-AzureAD

# Get the associated Service Principal for the Azure Run As Account

$runAsServicePrincipal = Get-AzureADServicePrincipal –ObjectId $SPId

# Add the Service Principal to the Global Administrator Role

Add-AzureADDirectoryRoleMember -ObjectId (Get-AzureADDirectoryRole | where-object {$_.DisplayName -eq
“Company Administrator”}).Objectid -RefObjectId $runAsServicePrincipal.ObjectId

Start PowerShell and connect to you Azure AD. If you have not installed the AzureAD PowerShell module install it by using the following command:

Install-Module AzureAD

The commands will grant the Global Admin Permission to this Run As account.

The Script can be found on GitHub.

Add the AzureAD module to the Automation Account

To enable the AzureAD module you should open the “Modules gallery” in the main menu.
Search for AzureAD and click on it.
Then select “Import” …
… and approve start the import with “ok”.

Creating the RB-AAD-RoleGroups Runbook

The main part of the implementation is configuring the runbook, which is the intelligent component to manage the roles for you.

In the main menu select “Runbooks”.
Create new runbook of Type PowerShell. As name you can use “RB-AAD-RoleGroups” and as description “This RB creates an AAD group per AAD role and assigns roles according to them.”.
In the new runbook click on “Edit”.
You can copy in the content from Github.

The script creates a group for every role which is available in AzureAD. To have a meaningful name I suggest changing the prefix according to your naming convention. To do this you have just to switch the change the GroupPrefix variable:

$GroupPrefix = “sg-Role-”

Some Roles from Azure AD you cannot, or you don’t like to manage. You can exclude them by their name (Do not remove User and Guest User):

$ExcludeRoles = @(“User”,“Guest User”)

Additionally, I highly recommend specifying your emergency account or your own account at the beginning in the ExcludeUsers variable:

$ExcludeUsers = @(“admin@aaaaaa.onmicrosoft.com”)

Then “save” and “publish” the runbook.
Now you can start the runbook …
… monitor the execution and by clicking on it. It is important, that you add now all users to the groups which currently have one of the roles. Otherwise all users will loose their assigned roles.
You can also see detailed logs when you click on the job.

Result

The script created automatically new groups which you can start using. If you like to execute the script for example daily you can easily create a schedule for the runbook according to docs.microsoft.com.

Thomas Kurth
Follow me

Thomas Kurth

Principal Workplace Consultant | MVP at baseVISION AG
I’m a consultant, trainer and architect for modern workplace and enterprise mobility projects with Microsoft Technologies in the past eight years. I love to push and design the modern workplace based on Windows 10, EM&S and O365 for my customers which is the only answer for the current security threats, agile world and the fast-changing business requirements of my customers. Important for me is to simplify and automate the operational processes, because there are the highest costs.
Thomas Kurth
Follow me

0 Comments

Leave a Reply

Your email address will not be published. Required fields are marked *

This site uses Akismet to reduce spam. Learn how your comment data is processed.