Edit

Add licenses, users, and roles to Microsoft Entra security groups

  • Article

Note

Azure Active Directory is now Microsoft Entra ID. Learn more.

Use Microsoft Entra security groups to better organize and manage Guides users and user roles.

For example, you have 15 Authors and 20 Operators. Create an Entra security group for your Authors, adding them as users and assigning them licenses. Create another Entra security group for your Operators adding them as users and assigning them licenses. When you create a Dataverse team for your authors and one for your operators, link these teams to your Entra security groups. The Entra security group memberships sync automatically from the security group to the Dataverse group team. Then, you can assign the roles to the Dataverse teams rather than to each individual.

Prerequisites

Add users and assign licenses with a Microsoft Entra security group

  1. Create a Microsoft Entra security group and add users.

  2. Assign Guides licenses to the Entra security group.

    Important

    Make sure each group is assigned Dynamics 365 Guides, Common Data Service, and PowerApps for Guides.

  3. Create a Dataverse group team in the environment where you installed the Guides solution, linking the group to the Microsoft Entra security group you created.

    Note

    When setting a value for membership type by selecting one of the options (Members, Members & Guests, Guests, or Owners), be aware that this value determines which users in the group will flow into the Dataverse group team. Setting the membership type is similar to setting a pass-through filter. For example, if Members is selected and a guest is added to the group, the guest will not flow down into the team and will not inherit the role from the Dataverse group team.

  4. Repeat this process for each group of users.

Assign Guides roles to a Dataverse group team

You can assign roles to a team in two ways:

  • Assign a Dataverse group team to a Guides role. In this case, the additions must be made to the Basic User role and any other roles that you want to modify. This assignment is the best option if you need to assign a role to many Dataverse group teams.

  • Assign a Guides role to a Dataverse group team. This assignment is the best option if you need to modify a few Dataverse group teams. For example, if you add the Author role to a Microsoft 365 group, anyone in the group has a role that allows them to create and edit a guide. The guide is owned by the group.

Assign a Dataverse group team to a Guides role

For this option, update a role to include the Dataverse group team that was created using the Power Platform admin center.

  1. Access a Guides role.

  2. Under Role, select Basic User.

    Note

    The Basic User role must be added to the group to enable Dynamics 365 Guides for the users in this group team.

  3. Select Members > Add people, then search and select the Dataverse group team you created. Then select Add. Repeat for each Dataverse group team.

  4. Repeat these steps for each Guides role.

Assign a Guides role to a Dataverse group team

For this option, update the Guides role to include the Dataverse group team created using the Power Platform admin center.

  1. Access the Dataverse group team.

  2. Confirm that the Basic User role is selected, and then select any other roles that you want to apply to the group.

  3. Repeat these steps for each Dataverse group team.

Next steps