How do I manage user accounts?

Introduction

To create a user account

To change a user's password

To change user password as a non-admin user

To specify security settings for a user account (global and individual user settings)

To remove a user

To edit the groups to which a user belongs (and assigning permissions to a user)

RESTful API

Introduction:

A user account is the means by which a user can access Entuity's functionality. You are only required to add users when configured for internal authentication.

To create a user account:

A newly created user account consists of a username, password, and membership of the All Users user group.

1. From the Main Menu, click Administration.
2. Click Account Management.
   
   
   
   
3. In multi-server environments, select the server or server configuration set for which you want to create the account via the dropdown selection box in the top left:
   
   
   
   
4. Under the Users tab, click Add User at the top of the page (or via the Overflow Menu).
   
   
   
   
5. The Add User form will open on the right.
   
   
   
   
6. Enter the desired username and password, and then confirm the password. Usernames must not include any of the following characters:
   
   :;\',<>"/
   
   Email addresses that contain the @ character are valid.
7. Click OK to save the details, and click OK to close the confirmation window.

To change a user's password:

1. Select the server or configuration set on which you want to change the user's password on the Account Management page, and then ensure that you are under the Users tab.
2. Select the user account for which you want to change the password and click Change Password at the top of the page (or via the Overflow Menu or right-click Context Menu).
   
   
   
   
3. The Change Password form will appear on the right of the page. Enter the new password in the Password and Confirm Password fields. You can also choose to force the user to change their password upon their next login.
   
   
   
   
4. Click Done in the top right to save the new password, otherwise click Cancel. If saved, the new password will come into effect the next time the user logs into Entuity.

To change user password as a non-admin user:

For a non-admin user to change their password:

1. Log in and click Main Menu, and then Administration.
2. Click Change Password.
   
   
   
   
3. The Change Password form will open on the right of the screen. Make the desired changes and click Done in the top right to save, otherwise click Cancel.
   
   

To specify security settings for a user account (gobal and individual user settings):

You can specify the security settings of user accounts to meet your requirements. You can specify these on a global level or on an individual user level (whereby individually-specified settings will override global settings).

These settings are as follows:

• Global User settings
• Global Password Complexity Settings
• Individual User Settings

If you have the context of a server, specified global user and password complexity settings are applicable across that server. If you have the context of a server configuration set, specified global settings are applicable across all servers that belong to the specified server configuration set.

Global User Settings:

1. Navigate to the Users tab of the Account Management page. From the Overflow Menu, click Global User Settings.
   
   
   
   
2. The Global User Settings form will open on the right of the page.
   
   
   
   
3. Specify the following settings:
   1. Enable or disable a Timeout by which users will be logged out after a period of inactivity. If enabled, specify the length in minutes of inactivity before the user is logged out.
   2. Enable or disable the Account locking after failed login attempt(s). If enabled, specify the number of failed attempts after which a user will be locked out, and for how long (in minutes) they will be locked out. Note, this is only applicable for internal authentication, not for external authentication (LDAP, RSSO, SAMLv2).
   3. Enable or disable Password expiry after which a new password is required. If enabled, specify the number of days after which a password expires, and for how long (in days) beforehand a password expiration warning should be displayed. Note, this is only applicable for internal authentication, not for external authentication (LDAP, RSSO, SAMLv2).
4. Click Done to save your changes, otherwise click Cancel.

Global Password Complexity Settings:

Note, password complexity settings are only applicable for internal authentication, not for external authentication (LDAP, RSSO, SAMLv2).

1. Navigate to the Users tab of the Account Management page. From the Overflow Menu, click Password Complexity Settings.
   
   
   
   
2. The Password Complexity Settings form will open on the right of the page.
   
   
   
   
3. Specify the following settings:
   
   1. Minimum password length - up to a maximum of 255 characters.
   2. Password history limit (number of old passwords that cannot be reused) - between 1 and 10.
   3. requirements for numeric, lowercase, uppercase and special characters.
   4. Switch on the Enable one-time password on user creation field if you want to enforce a new user to change their automatically-generated password upon their first login. If enabled, the user will be forced to change to a new password upon their first login, and the user will be unable to access the rest of Entuity until they have changed their password. If disabled, they can simply log in with the automatically-generated password without being prompted to change it.
4. Click Done to save your changes, otherwise click Cancel.

Individual user settings:

1. From the Users tab of the Account Management page, select the user account for which you want to change settings, and click User Settings from the Overflow Menu or the right-click Context Menu.
   
   
   
   
2. The User Settings form will open on the right of the page.
   
   
   
   
3. For the Timeout, Account locking and Password Expiry Days fields, you can choose from the following:
   • Use Global - use the global settings as specified above.
   • Override - override the global settings and specify your own.
   • Disabled - disable this option.
4. Expire account on - if desired, specify a date and time at which the user's account will be locked.
5. Force password change on next login - specify whether to force the user to change their password the next time they log in.
6. Unlock a locked account now - specify whether to unlock this user's account now, if the account is locked.
7. Click Done to save your changes, otherwise click Cancel.

To remove a user:

1. Select the server on which you want to remove a user(s) on the Account Management page, and then ensure that you are under the Users tab.
2. Select the user account(s) that you want to remove and click Remove User at the top of the page (or via the Overflow Menu or right-click Context Menu).
   
   
   
   
3. A confirmation dialog will open, asking you to confirm your decision.
   
   

To edit the groups to which a user belongs (and assigning permissions to a user):

For further help and information on user groups and user permissions in Entuity, please see this article.

1. Select the server on which you want to edit the user on the Account Management page, and then ensure that you are under the Users tab.
2. Select the user account for which you want to edit the groups, and click Edit Groups at the top of the page (or via the Overflow Menu or right-click Context Menu).
   
   
   
   
3. The Edit Groups form will open on the right of the page.
   
   
   
   
4. Tick the groups to which you want this user to belong.  Once you have made your changes, click Done in the top right of the form, otherwise click Cancel.

RESTful API:

Please see the following for help and information on managing users via Entuity RESTful API:

• List information about users.
• List detailed user information, modify parameters of a user, and delete a user.
• List global password complexity settings, and modify global password complexity settings.
• List global user settings, modify global user settings, and update all existing users to those global user settings.
• List the groups a specified user is a member of.
• Config sets - list all users in a config set, and add users to a config set.
• Config sets - modify a user's password, or delete a user from a config set.