EMS User

The EMS User object is a child of the EMS Users object.

Each EMS User object defines a user that is able to access information on the EMS Server using an EMS Client. Users can have different levels of access, determined by the User Type of the user.


Note that you can view users only if you have an EMS User Type with Change or Read-only access to Access Permissions - EMS user administration. You can configure new users only if you have Change access to Access Permissions - EMS user administration. Users with an EMS User Type with that permission can give any permissions they wish to a new EMS User Type, including ones they do not have access to themselves. In this way, an EMS User whose User Type has Change access to Access Permissions - EMS user administration can create a new EMS User Type object with access to all areas of configuration, and then create a new EMS User configured to use that EMS User Type. For this reason, you must be careful as to which EMS User Types are granted this permission and which users are given those EMS User Types. If you are logged in as a user with a User type of Super user (an EMS User Type that is always created by the system), you can create additional users of this type. Other users cannot create users with this EMS User Type.


If the EMS User object's User name is emsadmin, the EMS User cannot be deleted.

To configure and enable a new EMS User, you need to do the following:


Parameter

Access

Description
User name Create Name for the EMS User. Specify a name of up to 8 characters.
User type Change The type of EMS User, which determines the level of access that the user is granted. Click on the ellipsis symbol at the end of the field to select from a list of EMS User Type objects. If User name is emsadmin, this field is read only; this user is always a superuser and you cannot change it.
New password Change The password that this user should use to logon to an EMS Client. Enter a password of 6 - 8 characters. Note the screen will display a * character for each character that is entered as the password is entered. After the user has been created, the content of this field will not be displayed for security purposes; the password has been configured. Passwords must:
  • be at least six characters long
  • contain at least two upper or lower case letters in the first six characters
  • contain at least one number or special character in the first six characters.
Confirm new password Change The password that this user should use to logon to an EMS Client. If the value specified is not identical to that specified in the previous field, the request to enable the user will fail with an appropriate error message.
User description Change Textual information about the user. This field is optional. Specify a string of up to 64 characters.
Password expiry period Change Specifies the number of days before the password must be changed for this user. This is not the current amount of time left before expiry, but the time between password changes. (Passwords expire at midnight, so this time is counted from midnight at the end of the day on which the password is set.) If the password is not changed within this time, the EMS User will be prompted to change it next time they log in. Choose Use default or specify a value (in days). A value of 0 (zero) means that the password for this user will never expire.
Days until password expiry Read only The number of days left before the current password for this user expires.
Login failures before lockout Change Specifies the number of login failures this user may make between good logins before they are locked out. Choose Use default or specify a value. A value of 0 (zero) means that the user will never be locked out because of login failures.
Number of login failures since last successful login Read only The number of login failures this user has made since their last successful login.
Account locked Change Specifies whether this user account has been locked or not. Values:
  • True
  • False (default)
This field becomes Read only if it is set to False. If the user exceeds the maximum number of login failures specified in Login failures before lockout, the account is locked and this field is set to True. To remove the lockout and allow the subscriber to log in again, set the field to False.
Requested status Read only Specifies whether an administrator has attempted to enable the EMS User. Values:
  • Enabled
    The object has been enabled.
  • Disabled
    The object has not been enabled or has been disabled.
Actual status Read only Specifies the current status of the EMS User. Values:
  • Enabled
    The object is enabled.
  • Disabled
    The object has not been enabled or has been disabled.