Managing users

It is possible for multiple users to have access to KUMA. Users are assigned user roles, which affect the tasks the users can perform. The same user may have different roles with different tenants.

You can create or edit user accounts under Settings → Users in the KUMA web interface. Users are also created automatically in the program if KUMA integration with Active Directory is enabled and the user is logging in to the KUMA web interface for the first time using their domain account.

The table of user accounts is displayed in the Users window of the KUMA web interface. You can use the Search field to look for users. You can sort the table based on the User information column by clicking the column header and selecting Ascending or Descending.

User accounts can be created, edited, or disabled. When editing user accounts (your own or the accounts of others), you can generate an API token for them.

By default, disabled user accounts are not displayed in the users table. However, they can be viewed by clicking the User information column and selecting the Disabled users check box.

To disable a user:

In the KUMA web interface, under Settings → Users, select the check box next to the relevant user and click Disable user.

Creating a user

To create a user account:

1. In the KUMA web interface, open Settings → Users.

   In the right part of the Settings section the Users table will be displayed.

2. Click the Add user button and set the parameters as described below:
   • Name (required)—enter the user name. Must contain from 1 to 128 Unicode characters.
   • Login(required) – enter a unique user name for the user account. Must contain from 3 to 64 characters (only a–z, A–Z, 0–9, . \ - _).
   • Email (required)—enter the unique email address of the user. Must be a valid email address.
   • New password (required)—enter the password to the user account. Password requirements:
     • 8 to 128 characters long.
     • At least one lowercase character.
     • At least one uppercase character.
     • At lease one numeral.
     • At least one of the following special characters: !, @, #, %, ^, &, *.
   • Confirm password (required)—enter the password again for confirmation.
   • Disabled—select this check box if you want to disable a user account. By default, this check box is cleared.
   • In the Tenants for roles settings block, use the Add field buttons to specify which roles the user will perform on which tenants. Although a user can have different roles on different tenants, the user can have only one role on the same tenant.
   • Select the General administrator check box if you want to assign the general administrator role to the user. Users with the general administrator role can change the settings of other user accounts. By default, this check box is cleared.
3. Click Save.

The user account will be created and displayed in the Users table.

Editing user

To edit a user:

1. In the KUMA web interface, open Settings → Users.

   In the right part of the Settings section the Users table will be displayed.

2. Select the relevant user and change the necessary settings in the user details area that opens on the right.
   • Name (required)—edit the user name. Must contain from 1 to 128 Unicode characters.
   • Login(required) – enter a unique user name for the user account. Must contain from 3 to 64 characters (only a–z, A–Z, 0–9, . \ - _).
   • Email (required)—enter the unique email address of the user. Must be a valid email address.
   • Disabled—select this check box if you want to disable a user account. By default, this check box is cleared.
   • In the Tenants for roles settings block, use the Add field buttons to specify which roles the user will perform on which tenants. Although a user can have different roles on different tenants, the user can have only one role on the same tenant.
   • Select the General administrator check box if you want to assign the general administrator role to the user. Users with the general administrator role can change the settings of other user accounts. By default, this check box is cleared.
3. If you need to change the password, click the Change password button and fill in the fields described below in the opened window. When finished, click OK.
   • Current password (required)—enter the current password of your user account.
   • New password (required)—enter the password to the user account. Password requirements:
     • 8 to 128 characters long.
     • At least one lowercase character.
     • At least one uppercase character.
     • At lease one numeral.
     • At least one of the following special characters: !, @, #, %, ^, &, *.
   • Confirm password (required)—enter the password again for confirmation.
4. If necessary, use the Generate token button to generate an API token. Clicking this button displays a window containing the automatically created token.

   When the window is closed, the token is no longer displayed. If you did not copy the token before closing the window, you will have to generate a new token.

5. Click Save.

The user account will be changed.

Editing your user account

To edit your user account:

1. Open the KUMA web interface, click the name of your user account in the bottom-left corner of the window and click the Profile button in the opened menu.

   The User window with your user account parameters opens.

2. Make the necessary changes to the parameters:
   • Name (required)—enter the user name. Must contain from 1 to 128 Unicode characters.
   • Login(required) – enter a unique user name for the user account. Must contain from 3 to 64 characters (only a–z, A–Z, 0–9, . \ - _).

     Email (required)—enter the unique email address of the user. Must be a valid email address.

   • Receive notification by SMTP—select this check box if you want to receive SMTP notifications from KUMA.
3. If you need to change the password, click the Change password button and fill in the fields described below in the opened window. When finished, click OK.
   • Current password (required)—enter the current password of your user account.
   • New password (required)—enter the password to the user account. Password requirements:
     • 8 to 128 characters long.
     • At least one lowercase character.
     • At least one uppercase character.
     • At lease one numeral.
     • At least one of the following special characters: !, @, #, %, ^, &, *.
   • Confirm password (required)—enter the password again for confirmation.
4. If necessary, use the Generate token button to generate an API token. Clicking this button displays a window containing the automatically created token.

   When the window is closed, the token is no longer displayed. If you did not copy the token before closing the window, you will have to generate a new token.

5. Click Save.

Your user account is changed.