Bulk add users to your Azure Quantum workspace

Learn how to grant a group of users access to your Azure Quantum workspace. For example, you may need to grant your team members or students access to your workspace.

We recommend using the instructions in this article if you need to grant access to more than 10 users. For a smaller number of users, see Share access to your Azure Quantum workspace.

In this article you'll:

1. Create a group using the Azure Active Directory portal.
2. Add the group as a contributor to your Quantum workspace.
3. Bulk invite your users to the Azure Active Directory.
4. Bulk import those users to your group.

Prerequisites

You need the following prerequisites to bulk add users to an Azure Quantum workspace:

• An Azure account with an active subscription. If you don’t have an Azure account, register for free and sign up for a pay-as-you-go subscription.
• An Azure Quantum workspace. See Create an Azure Quantum workspace.
• An aka.ms shortlink for your Quantum Workspace (for example, aka.ms/aq/hackathon-notebooks). To create the link, use the Aka link manager tool.

Create a group in the Azure Active Directory

1. Sign in to the Azure portal. You must be an Owner of the workspace in order to add the group in the next step.

2. Search for and select Azure Active Directory.

3. On the Active Directory page, select Groups from the left menu and then select New group.

   

4. Fill out the required information on the New Group page.

   • Select Microsoft 365 as the Group type.
   • Create and add a Group name.
   • Add a Group email address for the group, or keep the email address that is filled in automatically.
   • Group description. Add an optional description to your group.
   • Select Assigned as the Membership type.

   

5. Select Create. You should get a notification that you've successfully created your group.

Add your group as a contributor to your Quantum workspace

1. Sign in to the Azure portal. You must be an Owner of the workspace in order to add the group as a contributor.

2. Navigate to your Azure Quantum workspace.

3. Allow your group to access your workspace. Select Access control (IAM) from the left-side menu. Select Add, and then Add role assignment.

4. The Add role assignment page opens. On the Role pane, select Contributor and then select Next.

   

5. On the Members pane, select Assign access to User, group, or service principal. Then select +Select members. The Select members blade opens. Search for your group name and select your group. Then select Select.

   

6. Your group name will appear under Members. Select Review + assign. On the Review + assign pane, Select Review + assign again. You should get a notification that your group was added as Contributor for your workspace.

   

Bulk invite users to the Azure Active Directory

1. Go to Users - Microsoft Azure. On the left-side menu, go to All users.

2. Select Bulk Operations, and then Bulk invite.

3. On the Bulk invite users pane, select Download to get a valid CSV template with invitation properties.

   

4. Open the CSV template and add a line for each user. The first two rows of the upload template must not be removed or modified, or the upload can't be processed. The third row provides examples of values for each column. You must remove the examples row and replace it with your own entries. Required values are:

   • Email address to invite - the user who will receive an invitation

   • Redirection url - the aka.ms shortlink to which the invited user is forwarded after accepting the invitation

   

5. Save the file.

6. On the Bulk invite users pane, under Upload your csv file, browse to the file. When you select the file, validation of the CSV file starts. Once the File uploaded successfully message appears, select Submit to start the bulk invite operation.

   

7. After the bulk invite users operation completes, your users will receive an invitation email. They want to accept the invitation.

8. On the Review permissions page, users must select Accept before they can continue.

9. After permissions are accepted, your users will be added to the Azure Active Directory.

Bulk import members to your group

1. After the bulk invite is complete, download all Azure Active Directory users into a CSV file. Go to All users, and select Download users.

2. In the Download users pane, select Start.

   

3. After the bulk users export is complete, click on Download results to download the CSV file with all your Azure Active Directory users.

4. After the download is complete, import your group members. Go to Groups - Microsoft Azure. Select your group, on the left-side menu, go to Members. In this blade, select Bulk operations, and then Import members.

5. On the Bulk import group pane, select Download to get a valid CSV template.

6. Open the CSV template and add a line for each user you want to invite to the group. Copy and paste your users' User Principal Names from the CSV that you downloaded in step 1. The third row provides an example value. You must remove the example row and replace it with your own entry.

   

7. Save the file.

8. On the Bulk import group pane, under Upload your csv file, browse to the file and upload it.

9. Once the File uploaded successfully message appears, select Submit to start the bulk import operation.

10. After the bulk import group operation completes, your group members will be added to the group successfully.