How to manage user accounts

How to add a user

To add a user:

  1. Go to Settings >> Users.

  2. Select Add user.

  3. Fill in the fields in the displayed form.

  4. Optionally make the user a MAAS administrator by checking the box.

  5. Select Save user to register your changes.

How to change a user’s preferences

  1. Select the MAAS username near the bottom of the left-hand navigation panel.

  2. Under Details, change the Username, Full name, or Email address as desired.

  3. Under Details, select Change password… to change the user’s password.

  4. Under API key, edit, delete, or Generate MAAS API keys as desired.

  5. Under SSH keys, delete or Import SSH keys as desired.

  6. Under SSL keys, delete or Add SSL keys as desired.

To add a user:

  1. Go to Settings >> Users.

  2. Select Add user.

  3. Fill in the fields in the displayed form.

  4. Optionally make the user a MAAS administrator by checking the box.

  5. 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:

  1. Select Settings > Users.

  2. Select the pencil icon to the right of the user that needs the additional key.

  3. Select Import SSH key.

  4. Select Upload from the Source dropdown and paste the complete contents of the key file, usually called id_rsa.pub.

  5. 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.

  6. 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:

  1. Select Settings > Users.

  2. Select the pencil icon to the right of the user that needs an API key.

  3. Select API keys.

  4. Select Generate MAAS API key.

  5. Optionally enter a name for the API key.

  6. 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:

  1. Select Settings > Users.

  2. Select the pencil icon to the far right of the username.

  3. Select Details.

  4. Select Change password… at the bottom of the screen. The screen will extend.

  5. Enter the Current password.

  6. Enter the New password.

  7. Enter the New password (again). Note that both new password entries must match.

  8. 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 5 months ago.