Add users to your data labeling project

Article
10/21/2022
4 minutes to read

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

An Azure subscription. If you don't have an Azure subscription create a free account before you begin.
An Azure Machine Learning workspace. See Create workspace resources.

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.

Open your workspace in Azure Machine Learning studio
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.
Select the Resource group link in the middle of the page.
On the left, select Access control (IAM).
At the top, select + Add > Add custom role.
For the Custom role name, type the name you want to use. For example, Labeler.
In the Description box, add a description. For example, Labeler access for data labeling projects.
Select Start from JSON.
At the bottom of the page, select Next.
Don't do anything for the Permissions tab, you'll add permissions in a later step. Select Next.
The Assignable scopes tab shows your subscription information. Select Next.
In the JSON tab, above the edit box, select Edit.
Select lines starting with "actions:" and "notActions:".
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, ],
Select Save at the top of the edit box to save your changes.

Important

Don't select Next until you've saved your edits.
After you save your edits, select Next.
Select Create to create the custom role.
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.

In Azure portal, in the top-left corner, expand the menu and select Azure Active Directory.
On the left, select Users.
At the top, select New user.
Select Invite external user.
Fill in the name and email address for the user.
Add a message for the new user.
At the bottom of the page, select Invite.

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.

In Azure portal, in the top search field, type Machine Learning.
Select Machine Learning.
Select the workspace that contains your data labeling project.
On the left, select Access control (IAM).
At the top, select + Add > Add role assignment.
Select the Labeler or Labeling Team Lead role in the list. Use Search if necessary to find it.
Select Next.
In the middle of the page, next to Members, select the + Select members link.
Select each of the users you want to add. Use Search if necessary to find them.
At the bottom of the page, select the Select button.
Select Next.
Verify that the Role is correct, and that your users appear in the Members list.
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:

Accept the invite from Microsoft Invitations (invites@microsoft.com).
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.
Open Azure Machine Learning studio.
Use the dropdown to select the workspace <workspace-name>.
Select the Label data tool for <project-name>.
For more information about how to label data, see Labeling images and text documents.