Users are entities with login accounts in the OpenNMS HORIZON system. Ideally each user corresponds to a person. An OpenNMS HORIZON User represents an actor which may be granted permissions in the system by associating Security Roles. OpenNMS HORIZON stores by default User information and credentials in a local embedded file based storage. Credentials and user details, e.g. contact information, descriptions or Security Roles can be managed through the Admin Section in the Web User Interface.

Beside local Users, external LDAP service and SSO can be configured, but are not scope in this section. The following paragraphs describe how to manage the embedded User and Security Roles in OpenNMS HORIZON.

Users

Managing Users is done through the Web User Interface and requires to login as a User with administrative permissions. By default the admin user is used to initially create and modify Users. The User, Password and other detail descriptions are persisted in users.xml file. It is not required to restart OpenNMS HORIZON when User attributes are changed.

In case administrative tasks should be delegated to an User the Security Role named ROLE_ADMIN can be assigned.

Don’t delete the admin and rtc user. The RTC user is used for the communication of the Real-Time Console on the start page to calculate the node and service availability.
Change the default admin password to a secure password.
How to set a new password for any user
  1. Login as a User with administrative permissions

  2. Choose Configure OpenNMS from the user specific main navigation which is named as your login user name

  3. Choose Configure Users, Groups and On-Call roles and select Configure Users

  4. Click the Modify icon next to an existing User and select Reset Password

  5. Set a new Password, Confirm Password and click OK

  6. Click Finish to persist and apply the changes

How users can change their own password
  1. Login with user name and old password

  2. Choose Change Password from the user specific main navigation which is named as your login user name

  3. Select Change Password

  4. Identify yourself with the old password and set the new password and confirm

  5. Click Submit

  6. Logout and login with your new password

How to create or modify user
  1. Login as a User with administrative permissions

  2. Choose Configure OpenNMS from the user specific main navigation which is named as your login user name

  3. Choose Configure Users, Groups and On-Call roles and select Configure Users

  4. Use Add new user and type in a login name as User ID and a Password with confirmation or click Modify next to an existing User

  5. Optional: Fill in detailed User Information to provide more context information around the new user in the system

  6. Optional: Assign Security Roles to give or remove permissions in the system

  7. Optional: Provide Notification Information which are used in Notification targets to send messages to the User

  8. Optional: Set a schedule when a User should receive Notifications

  9. Click Finish to persist and apply the changes

By default a new User has the Security Role similar to ROLE_USER assigned. Acknowledgment and working with Alarms and Notifications is possible. The Configure OpenNMS administration menu is not available.
How to delete existing user
  1. Login as a User with administrative permissions

  2. Choose Configure OpenNMS from the user specific main navigation which is named as your login user name

  3. Choose Configure Users, Groups and On-Call roles and select Configure Users

  4. Use the trash bin icon next to the User to delete

  5. Confirm delete request with OK