Managing users

A user is an identity used to access Altair SLC Hub. A user can have roles and permissions associated with it that define the types of tasks it can perform.

Creating a user

A user is created using the hubcli user create command. The minimum information required to create a user is the username:

hubcli user create Author1

If no --password flag is provided, you will be prompted to enter and confirm a password. The password must meet the password policy configured for the Altair SLC Hub instance, for example a minimum length and blacklist restrictions:

enter password :
confirm password :

You can provide additional information when creating a user, such as a display name, email address, first and last name, and OS user details:

hubcli user create Author1 --displayName "Documentation User 1" --firstName Documentation --lastName User --email "[email protected]" --unixUserName author1 --unixHomeDirectory /home/author1

The --displayName flag sets a user-friendly name that is shown in the Altair SLC Hub Portal and command output. The --email flag specifies the email address to which Altair SLC Hub can send information, for example to reset the user password.

Adding users to a group

You can add users to a group to collect together users who undertake similar tasks or require similar permissions.

To view a list of available groups, use the hubcli group list command. To view a list of users, use the hubcli user list command. To add a user to a group, use the hubcli group member add command:

hubcli group member add --user Author1 group1

This adds the user Author1 to the group group1.

To confirm the user has been added, list the members of the group:

hubcli group member list group1

Removing users from a group

To remove a user from a group without deleting the user, use the hubcli group member rm command:

hubcli group member rm --user Author1 group1

This removes Author1 from group1 but does not delete the user. To verify the correct group name before removing, use hubcli group list.

Removing users

You might want to remove a user from Altair SLC Hub. You can do this with the hubcli user rm command.

If you want to check you have the correct user name, or want to view a list of users, you use the command hubcli user list, described above.

You can then remove the user by name; for example:

hubcli user rm user1

This removes the user user1.

You cannot remove the user name you have used to login and use hubcli. For example, if you have logged in as AdminUser, you cannot use the command:

hubcli user rm AdminUser

if you do, the following message is returned:

Forbidden : Cannot delete yourself