Topic
This article discusses how to bulk import users in ControlOne.
Environment
- Cytracom ControlOne
Description
Procedure
Navigate to the CSV file
1. In the ControlOne Portal, select Users & Groups from the navigation menu.
Figure 1: The Navigation menu (click to enlarge)
2. Click the Create Users button.
Figure 2: Create users (click to enlarge)
3. Click the Import Users button, then click Next.
Figure 3: New Users (click to enlarge)
4. In the Import Users dialog box, clink the Sample file (CSV) link.
Figure 4: Import Users (click to enlarge)
5. Save the CSV file to your desired location, then open it.
Figure 5: Save the CSV file. (click to enlarge)
Add users to the CSV file
When you open the CSV file, you will see a spreadsheet page containing a header row and a sample entry which displays applicable cell entries in their proper formats.
Figure 6: The sample CSV file. (click to enlarge)
The header row contains the following data fields that Control One can use to add data about each user:
If you omit a required field, the import for that user will fail.
- email (required): The user's email address.
- first_name: The user's first name.
- last_name: The user's last name.
- phone number: Due to an issue with Multifactor Authentication (MFA) setup, Cytracom recommends leaving this field blank, then editing the user's phone number in the ControlOne Portal once added.
- agent_access: Permission for the user to access the ControlOne Agent. (enter allowed or denied).
- admin_portal (required): Permissions for the ControlOne Portal. Enter one of the following permission levels: modify, view, or none. By default, you should use the None permission unless the user needs access to the Admin Portal.
- reporting: Permissions for ControlOne's Reporting page. Enter one of the following permission levels: modify, view, or none. By default, you should use the none permission unless the user needs access to the Admin Portal.
- manage_users: Permissions for ControlOne's Manage Users page. Enter one of the following permission levels: modify, view, or none. By default, you should use the none permission unless the user needs access to the Admin Portal.
- zone: Enter the name of the zone in which the user will operate (this is case-sensitive and must match the name of the Zone exactly, or the user import will fail). Use this permission if a user needs agent access only.
To add users to the CSV file, delete the sample user information and enter the user's information in the first row. Use subsequent rows to add additional users. When finished, save the file with a .csv extension.
Upload the CSV file
1. Return to the Import Users dialog box in the ControlOne Portal. If you would like your users to receive an invite email, check the Send invite emails box. When finished, click Upload.
Figure 7: The Upload CSV button (click to enlarge)
2. Point to ControlOne_Users_Template.csv (or to it's new name, if you renamed it), and upload the file.
Figure 8: Uploading the .CSV file (click to enlarge)
3. The system will return you to the ControlOne Portal's Users & Groups page. Click the Users tab at the top of the window. You will now see your new users listed on the page.
Figure 9: The Users tab (click to enlarge)
Additional Resources
- Cytracom ControlOne: Creating and managing partner user accounts
- Cytracom ControlOne: Adding individual tenant users
Still have questions? Click here to learn how to contact Cytracom Technical Support or open a ticket.