{"id":186,"date":"2024-12-05T20:48:17","date_gmt":"2024-12-05T19:48:17","guid":{"rendered":"https:\/\/digitalmaterial.ch\/blog\/?p=186"},"modified":"2024-12-27T20:28:48","modified_gmt":"2024-12-27T19:28:48","slug":"microsoft-graph-managed-identities","status":"publish","type":"post","link":"https:\/\/digitalmaterial.ch\/blog\/microsoft-graph-managed-identities\/","title":{"rendered":"Microsoft Graph Managed Identities"},"content":{"rendered":"\n

Have you ever struggled with using PowerShell modules in function apps to access resources through MS Graph? In this article, we will break down how to add a managed identity to an existing Azure Function App and grant it permissions to Graph.<\/p>\n\n\n\n

Granting permissions<\/h1>\n\n\n\n

Granting permissions is only possible by using the MS Graph PowerShell Module. Be sure you have installed the latest one.<\/p>\n\n\n\n

PowerShell<\/span><\/path><\/path><\/svg><\/span>
Install-Module<\/span> -name Microsoft.Graph -scope AllUsers -Force<\/span><\/span><\/code><\/pre><\/div>\n\n\n\n
While this is downloading, head over to your Function App<\/strong> and select Settings > Identity > System assigned<\/strong>. Make sure the status is On<\/strong>, afterwards copy the Object ID<\/strong>.<\/p>\n\n\n\n
\"\"<\/figure>\n\n\n\n
Once the MS Graph module has downloaded, we can use the following script to grant our Managed Identity the needed permissions. The user connecting to MS Graph will need the following permissions Application.Read.All<\/strong> and AppRoleAssignment.ReadWrite.All <\/strong>. Be sure to add your TenantID<\/strong> and Managed Identity ObjectID<\/strong>. In our use case, the app roles «Group.ReadWrite.All»<\/strong>, «GroupMember.ReadWrite.All»<\/strong> are added.<\/p>\n\n\n\n
PowerShell<\/span><\/path><\/path><\/svg><\/span>
# The tenant ID<\/span><\/span>\n$TenantId<\/span> = <\/span>"xxxx-xxxx"<\/span><\/span>\n<\/span>\n# The array of app role names that the managed identity should be assigned to.<\/span><\/span>\n$appRoleNames<\/span> = <\/span>@<\/span>(<\/span>"Group.ReadWrite.All"<\/span>, <\/span>"GroupMember.ReadWrite.All"<\/span>)<\/span><\/span>\n<\/span>\n#The Object principal ID we've copied from our Function App.<\/span><\/span>\n$managedIdentityObjectId<\/span> = <\/span>"xxxx-xxxx"<\/span><\/span>\n<\/span>\nConnect-MgGraph<\/span> -TenantId <\/span>$TenantId<\/span> -Scopes <\/span>'Application.Read.All'<\/span>,<\/span>'AppRoleAssignment.ReadWrite.All'<\/span><\/span>\n<\/span>\n# Get Microsoft Graph app's service principal and app roles.<\/span><\/span>\n$serverApplicationName<\/span> = <\/span>"Microsoft Graph"<\/span><\/span>\n$serverServicePrincipal<\/span> = (<\/span>Get-MgServicePrincipal<\/span> -Filter <\/span>"DisplayName eq '<\/span>$serverApplicationName<\/span>'"<\/span>)<\/span><\/span>\n$serverServicePrincipalObjectId<\/span> = <\/span>$serverServicePrincipal<\/span>.Id<\/span><\/span>\n<\/span>\n# Loop through each app role name and assign the managed identity access to the app role.<\/span><\/span>\nforeach<\/span> (<\/span>$appRoleName<\/span> <\/span>in<\/span> <\/span>$appRoleNames<\/span>) {<\/span><\/span>\n\u00a0 \u00a0 <\/span>$appRoleId<\/span> = (<\/span>$serverServicePrincipal<\/span>.AppRoles<\/span> | <\/span>Where-Object<\/span> {<\/span>$_<\/span>.Value<\/span> -eq <\/span>$appRoleName<\/span> }).Id<\/span><\/span>\n<\/span>\n\u00a0 \u00a0 <\/span># Assign the managed identity access to the app role.<\/span><\/span>\n\u00a0 \u00a0 <\/span>New-MgServicePrincipalAppRoleAssignment<\/span> -ServicePrincipalId <\/span>$managedIdentityObjectId<\/span> -PrincipalId <\/span>$managedIdentityObjectId<\/span> -ResourceId <\/span>$serverServicePrincipalObjectId<\/span> -AppRoleId <\/span>$appRoleId<\/span><\/span>\n}<\/span><\/span>\n<\/span><\/code><\/pre><\/div>\n\n\n\n
Once set, these permissions will be reflected in Entra if you head over to the Enterprise Application.<\/p>\n\n\n\n
\"\"<\/figure>\n\n\n\n
Connection to Microsoft Graph<\/h1>\n\n\n\n
\n
Disclaimer:<\/strong> To use the connection to Microsoft Graph as described, ensure that the required Microsoft Graph PowerShell modules are available in your Azure Function App. If your app does not already have these modules installed, you can refer to this blog post<\/a> for detailed instructions on how to add them.<\/p>\n<\/blockquote>\n\n\n\n
Using Managed Identity to connect to Microsoft Graph is an efficient and secure way to authenticate in Azure Function Apps. This section explains how to configure your Function App to connect to Microsoft Graph at startup.<\/p>\n\n\n\n
The profile.ps1<\/strong><\/code> file in your Azure Function App is executed every time the app undergoes a «cold start». This makes it an ideal place to include the necessary connection commands. Below is an example profile.ps1<\/code> <\/strong>that establishes the connection using the Managed Identity (MSI) of your Function App.<\/p>\n\n\n\n
Navigate to your Function App in the Azure Portal, then go to Functions<\/strong> and select App Files<\/strong>. From the list of files, choose profile.ps1<\/strong><\/code>. Once you have opened the file, add the necessary connection commands. Use the following script to establish a connection to Microsoft Graph using the Managed Identity of your Function App:<\/p>\n\n\n\n
PowerShell<\/span><\/path><\/path><\/svg><\/span>
# Authenticate using MSI.<\/span><\/span>\nif<\/span> (<\/span>$env:MSI_SECRET<\/span>) {<\/span><\/span>\n    <\/span>Connect-MgGraph<\/span> -Identity<\/span><\/span>\n}<\/span><\/span><\/code><\/pre><\/div>\n\n\n\n
After adding the connection commands to the profile.ps1<\/strong><\/code> file, save your changes directly in the Azure Portal. To ensure the updates take effect, restart <\/strong>your Function App, which will trigger a «cold start» and execute the modified profile.ps1<\/strong><\/code> script. Finally, verify the connection to Microsoft Graph by checking the logs of your Function App to confirm that the connection was successfully established using the Managed Identity.<\/p>\n\n\n\n
Usecases<\/h1>\n\n\n\n
You can change the managed identity <\/strong>permissions to your liking and use any PowerShell module available to interact with Microsoft’s cloud services. Some examples for function apps are:<\/p>\n\n\n\n
    \n
  • Cleaning up stale devices in Entra ID<\/li>\n\n\n\n
  • Automate group memberships based on user attributes like department, location, or role<\/li>\n\n\n\n
  • Onboarding and offboarding workflows<\/li>\n\n\n\n
  • Shutting down unused AVD Hosts<\/li>\n<\/ul>\n","protected":false},"excerpt":{"rendered":"
    Have you ever struggled with using PowerShell modules in function apps to access resources through MS Graph? In this article, we will break down how to add a managed identity to an existing Azure Function App and grant it permissions to Graph. Granting permissions Granting permissions is only possible by using the MS Graph PowerShell […]<\/p>\n","protected":false},"author":4,"featured_media":196,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[21],"tags":[],"class_list":["post-186","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-azure"],"_links":{"self":[{"href":"https:\/\/digitalmaterial.ch\/blog\/wp-json\/wp\/v2\/posts\/186","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/digitalmaterial.ch\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/digitalmaterial.ch\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/digitalmaterial.ch\/blog\/wp-json\/wp\/v2\/users\/4"}],"replies":[{"embeddable":true,"href":"https:\/\/digitalmaterial.ch\/blog\/wp-json\/wp\/v2\/comments?post=186"}],"version-history":[{"count":11,"href":"https:\/\/digitalmaterial.ch\/blog\/wp-json\/wp\/v2\/posts\/186\/revisions"}],"predecessor-version":[{"id":324,"href":"https:\/\/digitalmaterial.ch\/blog\/wp-json\/wp\/v2\/posts\/186\/revisions\/324"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/digitalmaterial.ch\/blog\/wp-json\/wp\/v2\/media\/196"}],"wp:attachment":[{"href":"https:\/\/digitalmaterial.ch\/blog\/wp-json\/wp\/v2\/media?parent=186"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/digitalmaterial.ch\/blog\/wp-json\/wp\/v2\/categories?post=186"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/digitalmaterial.ch\/blog\/wp-json\/wp\/v2\/tags?post=186"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}