Grant user-level access to projects in Microsoft Dev Box

In this article, you learn how to grant developers access to create and manage a dev box in the Microsoft Dev Box developer portal. Microsoft Dev Box uses Azure role-based access control (Azure RBAC) to grant access to functionality in the service.

Team members must have access to a specific Microsoft Dev Box project before they can create dev boxes. By using the built-in DevCenter Dev Box User role, you can assign permissions to Active Directory users or groups. You assign the role at the project level in Microsoft Dev Box.

Note

Microsoft Dev Box supports work and school accounts. It doesn't support the use of guest accounts or personal accounts.

A DevCenter Dev Box User can:

  • View pools within a project.
  • Create dev boxes.
  • Connect to a dev box.
  • Manage dev boxes that they created.
  • Delete dev boxes that they created.

Assign permissions to dev box users

To grant a user access to create and manage a dev box in Microsoft Dev Box, you assign the DevCenter Dev Box User role at the project level.

  1. Sign in to the Azure portal.

  2. In the search box, enter projects. In the list of results, select Projects.

  3. Select the project that you want to give your team members access to.

    Screenshot that shows a list of existing projects.

  4. On the left menu, select Access Control (IAM).

  5. Select Add > Add role assignment.

  6. Assign the following role. For detailed steps, see Assign Azure roles using the Azure portal.

    Setting Value
    Role Select DevCenter Dev Box User.
    Assign access to Select User, group, or service principal.
    Members Select the users or groups that you want to have access to the project.

    Screenshot that shows the pane for adding role assignments.

The users can now view the project and all the pools within it. Dev box users can create dev boxes from any of the pools and manage those dev boxes from the developer portal.

Important

A dev box is automatically started and running when the creation process finishes. Dev boxes incur costs whenever they're running.