This guide explains how to invite users to Cmd projects, and choose which privileges to give them.
For organizations with multiple Cmd projects, users (other than global admins) must be added to each project individually. Note that users who are not global admins can have different account types in different projects.
Table of contents
Adding a new user
In the top-right corner of the web app, click the current project's name to open the drop-down menu. To add users to a project other than the current one, switch to it before proceeding.
Select Project & app settings.
You'll find yourself on the 'Users & roles' page.
On the right side, click Create user.
Add the new user's basic information:
'Name' — a real name
'User name' — a unique identifier for the Cmd account. Used to enforce custom policies and identify the user in exported and in-app Cmd data.
'Email address' — the user's email
Note: To later enable SAML, ensure this email address matches the user's account in your SAML application.To grant global admin access, check 'Set as global admin'. (Only possible for global admins.)
Otherwise, choose an account type for the user from the available options.
Add any desired roles to the user.
Click Create.
Cmd will email the new user an invitation with instructions for setting up their account.
Granting a user access to an additional project
Note that this process applies only to viewers and server operators. To grant an existing user access to an additional project, do the following:
In the top-right corner of the web app, click the current project's name to open the drop-down menu. Select the project you wish to grant access to.
Open the drop-down menu again. Select Project & app settings.
You'll find yourself on the 'Users & roles' page.
On the right side, click the down arrow next to 'Create user' and select Assign user.
Type the name or email of the user, or select them from the drop-down list.
Click Save.
Adding multiple users to a project simultaneously
To add a large number of users to a project at once, create a simple CSV (comma-separated value) file. Here is an example of the correct format:
John Doe,johndoe@gmail.com
Jane Doe,jonedoe@gmail.com
If you're planning to enable SAML, ensure the email addresses used here match the email addresses used in the related SAML application.
With your CSV prepared, follow these steps to add the users to Cmd:
In the top-right corner of the web app, click the current project's name to open the drop-down menu.
Select Project & app settings.
You'll find yourself on the 'Users & roles' page.
On the right side of the page, click the down arrow and select Import users.
Click Choose File and upload the CSV.
If prompted, enter your password and click Verify.
All the users in the CSV file get added to the system. To finish setting up these users, edit each user and assign them a user role.
Related resources: