Instead of manually adding users one at a time, runZero administrators can add multiple users via bulk import. To bulk import users, you will need to create a CSV (comma separated values) file that contains the user information, such as their first name, last name, email, role, and organizational access.
Bulk imports will only add new users; it will not update existing users. If the file contains a user that already exists in the system, the import will not complete. You’ll need to remove all duplicate users from your CSV file and import the file again.
Here are the high-level steps for bulk-importing users:
- Create a CSV file with your user information.
- Import the CSV file into runZero.
- Verify users have registered their accounts.
Creating the CSV file for importing users
To create the CSV file, you can use the provided template or create a file from scratch. You’ll need to follow the guidelines and include the fields outlined below.
- The first row of the CSV file is the header row and it must be included in the file. It contains the required fields needed for importing users, and those fields must follow a specific order (
- runZero requires the
email fields. The organization-level fields,
org_roles, are optional.
- To define the
org_roles field, use the following format:
orgName=role. You can use pipes to separate multiple definitions.
- Excluding the
all_orgs_role field from the CSV will result in users being assigned a no-access role in all organizations.
- Excluding the
orgs_role field from the CSV will result in users being assigned the role defined in the
all_orgs_role field. If both fields are excluded from the file, all users will be assigned the no-access role. They will need to contact the runZero administrator to modify their account access.
User fields for the CSV file
The following table lists the fields you can include in your CSV file:
|The user’s first name.
|The user’s last name.
|The user’s email address.
|The role assigned to the user for all organizations. This is optional.
|The role assigned to the user for a specific site. Use pipes to separate the organizations. This field is optional.
Your resulting CSV file should look like the following example:
Importing users into runZero
- Go to your Team Import page.
- Choose the CSV file that contains your user information and upload it to runZero.
- Import the file.
runZero will alert you if there are issues with your file. For example, if the file contains an existing user, the import will not complete. You’ll need to remove all duplicate users from your file and import it again.
Verifying users have registered
After you add new users via import, each user receives an email invitation to join your team. The email contains a link to register their email address, which prompts them to enter their name and password for their account. After they create an account, they’ll be able to log in to the runZero console.
You can visit the Teams page to find the status and last login for each user. Users who have completed the registration process will show an