Add users to your data labeling project

This article shows how to add users to your data labeling project so that they can label data, but can't see the rest of your workspace. These steps can add anyone to your project, whether or not they are from a data labeling vendor company.

Prerequisites

You need certain permission levels to follow the steps in this article. If you can't follow one of the steps because of a permissions issue, contact your administrator to request the appropriate permissions.

  • To add a guest user, your organization's external collaboration settings needs the correct configuration to allow you to invite guests.
  • To add a custom role, you must have Microsoft.Authorization/roleAssignments/write permissions for your subscription - for example, User Access Administrator or Owner.
  • To add users to your workspace, you must be an Owner of the workspace.

Add custom role

To add a custom role, you must have Microsoft.Authorization/roleAssignments/write permissions for your subscription - for example, User Access Administrator.

  1. Open your workspace in Azure Machine Learning studio

  2. Open the menu on the top right, and select View all properties in Azure Portal. You use the Azure portal for the remaining steps in this article.

  3. Select the Resource group link in the middle of the page.

  4. On the left, select Access control (IAM).

  5. At the top, select + Add > Add custom role.

  6. For the Custom role name, type the name you want to use. For example, Labeler.

  7. In the Description box, add a description. For example, Labeler access for data labeling projects.

  8. Select Start from JSON.

  9. At the bottom of the page, select Next.

  10. Don't do anything for the Permissions tab. You add permissions in a later step. Select Next.

  11. The Assignable scopes tab shows your subscription information. Select Next.

  12. In the JSON tab, above the edit box, select Edit.

  13. Select lines starting with "actions:" and "notActions:".

    Create custom role: select lines to replace them in the editor.

  14. Replace these two lines with the Actions and NotActions from the appropriate role listed at Manage access to an Azure Machine Learning workspace. Make sure to copy from Actions through the closing bracket, ],

  15. Select Save at the top of the edit box to save your changes.

    Important

    Don't select Next until you've saved your edits.

  16. After you save your edits, select Next.

  17. Select Create to create the custom role.

  18. Select OK.

Add guest user

If your labelers are outside of your organization, add them, so they can access your workspace. If labelers are already inside your organization, skip this step.

To add a guest user, your organization's external collaboration settings need the correct configuration to allow you to invite guests.

  1. In Azure portal, in the top-left corner, expand the menu and select Microsoft Entra ID.

    Select Microsoft Entra ID from the menu.

  2. On the left, select Users.

  3. At the top, select New user.

  4. Select Invite external user.

  5. Fill in the name and email address for the user.

  6. Add a message for the new user.

  7. At the bottom of the page, select Invite.

    Invite guest user from Microsoft Entra ID.

Repeat these steps for each of your labelers. You can also use the link at the bottom of the Invite user box to invite multiple users in bulk.

Tip

Inform your labelers that they will receive this email. They must accept the invitation in order to gain access to your project.

Add users to your workspace

Now that you added your labelers to the system, you can add them to your workspace.

To add users to your workspace, you must be an owner of the workspace.

  1. In Azure portal, in the top search field, type Machine Learning.

  2. Select Machine Learning. Search for Azure Machine Learning workspace.

  3. Select the workspace that contains your data labeling project.

  4. On the left, select Access control (IAM).

  5. At the top, select + Add > Add role assignment.

    Add role assignment from your workspace.

  6. Select the Labeler or Labeling Team Lead role in the list. Use Search if necessary to find it.

  7. Select Next.

  8. In the middle of the page, next to Members, select the + Select members link.

  9. Select each of the users you want to add. Use Search if necessary to find them.

  10. At the bottom of the page, select the Select button.

  11. Select Next.

  12. Verify that the Role is correct, and that your users appear in the Members list.

  13. Select Review + assign.

For your labelers

Now, your labelers can begin labeling in your project. However, they still need information from you to access the project.

Be sure to create your labeling project before you contact your labelers.

Send the following information to your labelers, after you fill in your workspace and project names:

  1. Accept the invite from Microsoft Invitations (invites@microsoft.com).
  2. Follow the steps on the web page after you accept. Don't worry if, at the end, you find yourself on a page that says you don't have any apps.
  3. Open Azure Machine Learning studio.
  4. Use the dropdown to select the workspace <workspace-name>.
  5. Select the Label data tool for <project-name>. Screenshot showing the label data tool.
  6. For more information about how to label data, see Labeling images and text documents.

Next steps