User Creation and Configuration

Only a user with admin privileges can create users and assign security roles to them. We recommend creating a new user with admin privileges instead of using the default admin (see <<user-management/introduction.adoc#ga-admin-user-setup[Admin User Setup]).

Ideally, each user account corresponds to a person, to help track who performs tasks in your Horizon system. Assigning different security roles to each user helps restrict what tasks the user can perform.

In addition to local users, you can configure external authentication services including LDAP/LDAPS, RADIUS, and Single Sign On (SSO). Configuration specifics for these services are outside the scope of this documentation.

Do not delete the default admin and rtc users. The rtc user is used for the communication of the Real-Time Console on the start page to calculate the node and service availability.

Creating a User

  1. Log in as a user with administrative permissions.

  2. Click the gear icon in the top right.

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

  4. Click Add new user and specify a user ID, password, password confirmation and click OK.

Please note that angle brackets (<>), single (') and double quotation marks ("), and the ampersand symbol (&) are not allowed to be used in the user ID.

  1. Optional: add user information in the appropriate fields.

  2. Optional: assign user permissions.

    By default a new user has the following permissions: Acknowledge and work with alarms and notifications. Cannot access the configure OpenNMS administration menu. Add the ROLE_ADMIN role to create a new admin.

  3. Optional: specify where to send messages to the user in the notification information area.

  4. Optional: set a schedule for when a user should receive notifications.

  5. Click Finish to save changes.

Create User Duty Schedule

A duty schedule specifies the days and times a user (or group) receives notifications, on a per-week basis. This feature lets you customize a schedule based on your team’s hours of operation. Schedules are additive: a user could have a regular work schedule, and a second schedule for days or weeks when they are on call.

If Horizon needs to notify an individual user, but that user is not on duty at the time, it will never send the notification to that user.

Notifications sent to users in groups are different:

  • group on duty at time of notification – all users also on duty receive notification

  • group on duty, no member users on duty – notification is queued and sent to the next user who comes on duty

  • off-duty group – notification never sent

To add a duty schedule for a user (or group), follow these steps:

  1. Log in as a user with administrative permissions.

  2. Click the gear icon in the top-right.

  3. Choose Configure OpenNMS → Configure Users, Groups and On-Call roles and select Configure Users (Configure Groups).

  4. Choose the user (or group) you want to modify.

  5. In the Duty Schedule area, choose the number of schedules you want to add from the list and click Add Schedule.

  6. Specify the days and times during which you want the user (or group) to receive notifications.

  7. Click Finish.