Configure Grafana teams with Microsoft Entra groups and Grafana Team Sync

In this guide, you learn how to use Microsoft Entra groups with Grafana Team Sync to manage dashboard permissions in Azure Managed Grafana.

In Azure Managed Grafana, you can use Azure's role-based access control (RBAC) roles for Grafana to define access rights. These permissions apply to all resources in your Grafana workspace by default, not per folder or dashboard. If you assign a user to the Grafana Editor role, that user can edit any dashboard in your Grafana workspace. However, with Grafana's granular permission model, you can adjust a user's default permission level for specific dashboards or dashboard folders.

Microsoft Entra group sync helps you manage this. With it, you can create a Grafana team in a Grafana workspace, link it to a Microsoft Entra group, and then configure your dashboard permissions for that team. For example, you can allow a Grafana viewer to modify a dashboard, or prevent a Grafana editor from making changes.

Prerequisites

Before you start, make sure you have:

Assign a permission to a Microsoft Entra group

The Microsoft Entra group must have a Grafana role to access the Grafana instance.

  1. In your Grafana workspace, open the Access control (IAM) menu select Add > Add new role assignment.

    Screenshot of the Azure portal. Adding a new role assignment.

  2. Assign a role, such as Grafana viewer, to the Microsoft Entra group. For more information about assigning a role, go to Grant access.

Create a Grafana team

Set up a Microsoft Entra ID-backed Grafana team.

  1. In the Azure portal, open your Grafana instance and select Configuration under Settings.

  2. Select the Microsoft Entra Team Sync Settings tab.

  3. Select Create new Grafana team.

    Screenshot of the Azure portal. Configuring Microsoft Entra Team Sync.

  4. Enter a name for the Grafana team and select Add.

    Screenshot of the Azure portal. Creating a new Grafana team.

Assign a Microsoft Entra group to a Grafana team

  1. In Assign access to, select the newly created Grafana team.

  2. Select + Add a Microsoft Entra group.

  3. In the search box, enter a Microsoft Entra group name and select the group name in the results. Click Select to confirm.

    Screenshot of the Azure portal. Finding and selecting a Microsoft Entra group.

  4. Optionally repeat the previous three steps to add more Microsoft Entra groups to the Grafana team.

Assign access to a Grafana folder or dashboard

  1. In the Grafana UI, open a folder or a dashboard.

  2. In the Permissions tab, select Add a permission.

    Screenshot of the Azure portal, selecting Add a permission.

  3. Under Add permission for, select Team, then select the team name, the View, Edit or Admin permission, and save. You can add permissions for a user, a team or a role.

    Screenshot of the Grafana UI, adding a permission for a team in a Grafana folder.

    Tip

    To check existing access permissions for a dashboard, open a dashboard and go to the Permissions tab. This page shows all permissions assigned for this dashboard and all inherited permissions. Screenshot of the Grafana UI, showing permission for a Grafana dashboard.

Scope down access

You can limit access by removing permissions to access one or more folders.

For example, to disable access to a user who has the Grafana Viewer role on a Grafana instance, remove their access to a Grafana folder by following these steps:

  1. In the Grafana UI, go to a folder you want to hide from the user.

  2. In the Permissions tab, select the X button to the right of the Viewer permission to remove this permission from this folder.

  3. Repeat this step for all folders you want to hide from the user.

    Screenshot of the Grafana UI, removing the Viewer permission in a Grafana folder.

Remove a Grafana team

If you no longer need a Grafana team, follow these steps to delete it. Deleting a Grafana team also removes the link to the Microsoft Entra group.

  1. In the Azure portal, open your Azure Managed Grafana workspace.

  2. Select Administration > Teams.

  3. Select the X button to the right of a team you're deleting.

    Screenshot of the Grafana platform. Removing a Grafana team.

  4. Select Delete to confirm.

Next steps

In this how-to guide, you learned how to set up Grafana teams backed by Microsoft Entra groups. To learn how to use teams to control access to dashboards in your workspace, see Manage dashboard permissions.