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 not see the rest of your workspace. You can use these steps to add anyone to your project, whether or not they are from a data labeling vendor company.

Prerequisites

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

  • To add a guest user, your organization's external collaboration settings must be configured to allow you to invite guests.
  • To add a custom role, you must have Microsoft.Authorization/roleAssignments/write permissions for your subscription, such as 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, such as 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'll use Azure portal for all the rest of the 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'll 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, you'll now add them so that 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 must be configured to allow you to invite guests.

  1. In Azure portal, in the top-left corner, expand the menu and select Azure Active Directory.

    Select Azure Active Directory 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 Azure Active Directory.

Repeat for each of your labelers. Or use the link at the bottom of the Invite user box to invite multiple users in bulk.

Tip

Inform your labelers that they'll be receiving this email. They need to accept the invitation in order to gain access to your project.

Add users to your workspace

Now that you have your labelers added to the system, you're ready to 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

Your labelers are now all set up to begin labeling in your project. But they'll still need information from you to access the project.

If you haven't created your labeling project yet, do so before you contact your labelers.

Send the following to your labelers, after filling 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're 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