How to manage user accounts
How to add a user
To add a user:
-
Go to Settings >> Users.
-
Select Add user.
-
Fill in the fields in the displayed form.
-
Optionally make the user a MAAS administrator by checking the box.
-
Select Save user to register your changes.
How to change a user’s preferences
-
Select the MAAS username near the bottom of the left-hand navigation panel.
-
Under Details, change the Username, Full name, or Email address as desired.
-
Under Details, select Change password… to change the user’s password.
-
Under API key, edit, delete, or Generate MAAS API keys as desired.
-
Under SSH keys, delete or Import SSH keys as desired.
-
Under SSL keys, delete or Add SSL keys as desired.
To add a user:
-
Go to Settings >> Users.
-
Select Add user.
-
Fill in the fields in the displayed form.
-
Optionally make the user a MAAS administrator by checking the box.
-
Select Add user to register your changes.
How to change a user’s preferences
Clicking the MAAS username in the top right corner will show that user’s preferences.
To add a regular user, enter the following command:
maas $PROFILE users create username=$USERNAME \
email=$EMAIL_ADDRESS password=$PASSWORD is_superuser=0
All the options are necessary. Note that stipulating a password on the CLI may be a security hazard, depending on your environment.
How to add an SSH key for a user
Assuming a public key exists in /home/ubuntu/.ssh/id_rsa.pub
- add a key with the following command:
ubuntu@maas:~$ maas $PROFILE sshkeys create key="$(cat /home/ubuntu/.ssh/id_rsa.pub)"
Success.
The user normally imports their initial SSH key on the first login to the web UI.
To add a locally-generated public key to a user:
-
Select Settings > Users.
-
Select the pencil icon to the right of the user that needs the additional key.
-
Select Import SSH key.
-
Select Upload from the Source dropdown and paste the complete contents of the key file, usually called
id_rsa.pub
. -
Alternatively, you can select Launcpad or GitHub, if you want to load a SSH key from there. You will need to enter the user ID associated with the key.
-
Select Import SSH key to register your changes.
How to add an API key for a user
To add an API key for a user:
-
Select Settings > Users.
-
Select the pencil icon to the right of the user that needs an API key.
-
Select API keys.
-
Select Generate MAAS API key.
-
Optionally enter a name for the API key.
-
Select Generate API key to create the new key.
We recommend that you use the web UI to set or change a user’s API key. To see how, select the “UI” choice in the dropdown above.
How users can change their password
The current user can change their password with the following procedure:
-
Select Settings > Users.
-
Select the pencil icon to the far right of the username.
-
Select Details.
-
Select Change password… at the bottom of the screen. The screen will extend.
-
Enter the Current password.
-
Enter the New password.
-
Enter the New password (again). Note that both new password entries must match.
-
Select Save to register the changes.
An administrator can change any user’s password from Settings > Users.
We recommend that you use the web UI to change user passwords. To see how, select the “UI” choice in the dropdown above.
Last updated a month ago.