JaxView Roles

About JaxView Roles

Roles are primarily used to control permissions within the JaxView portal. Each JaxView user account must be assigned to a role. A user account may only have a single role assigned to it. Users logging into JaxView will be limited to the actions defined by the role assigned to their user account. This may include limits on which Web service definitions and data they may view. Roles may also be associated with Web service definitions that had been added to the Services object tree under the Service tab.

Default JaxView Roles

JaxView is shipped with 2 default roles. These roles are predefined and the user is not allowed to delete these roles. The following describes the default roles.

Role Name

Description

Admin Role

A user with the Admin role has unconditional access to the whole application. Users in this role will be able to view all Web services and their messages and reports.

Guest Role

A user with the Guest role will have read-only access to the application. That means they are not allowed to add, edit or save any objects. Users in this role will be able to view all web services and their messages and reports.



Working with JaxView Roles

You access role definitions using the Admin tab in the JaxView Main view. Role definitions are objects that are displayed as child nodes under the Roles object node in the Admin object tree. Selecting the Roles object node displays a list of currently defined roles in JaxView. As with other object tree menus, you use the right mouse click to display the action menu for the object node. Clicking to add or edit a role displays the Edit role form in the right side panel. The following figure shows an example Role Edit form.


The Edit form has eight expandable sub panels that you use to select action permissions for the role. There is also a Web services selection menu tree at the bottom of the form to select which services the role should have be able to access. By default a role has total access to the application. See the section on Role Properties below for more information about the settings.

The following sections describe the steps you use to add new roles, associate a user account with a role, and associate a Web service definition with a role.

To add a new role definition

  1. Select the Admin tab from the Main View navigation menu

  2. Click on the Roles node in the left side object tree menu

  3. Right-click the mouse to display the action menu for the node and select Add Role. The Add Role page is displayed in the right panel

  4. Complete the Add Role form as indicated, using the check boxes to select the actions and permissions that should be granted to this role. Use the
    tree menu near the bottom of the form to select which Web services should be available to this role. Click the Save button near the bottom of the form

  5. After a short refresh cycle, the new role definition is added to the Roles object node

To assign a role to a user

  1. Select the Admin tab from the Main View navigation menu

  2. Click on the Users node in the left side object tree menu

  3. Select the User account node you want to modify in the Users node subtree.

  4. Right-click the mouse to display the action menu for the node and select Edit. The Edit User page is displayed in the right panel

  5. Near the bottom of the Edit User form, find the User Role selection item. Use the selection box to select that role that should be assigned from the list of existing roles. If necessary, create a new role using the steps in this section.

  6. Click the Save button near the bottom of the form to save the role assignment.


To associate a Web service to as existing role

By default, each role has access to all Web services defined in JaxView. You can edit an existing role and limit access to one or more Web services using the steps described above or you can edit a Web service object in the Services tab to change role assignments. The following are the the steps you use to edit a Web service role assignment in the Service object tree.

  1. Select the Services tab from the Main View navigation menu

  2. Click to expand the group node containing the Web service you want to edit in the left side object tree menu

  3. Select the Web service object node you want to modify.

  4. Right-click the mouse to display the action menu for the node and select Edit. The Edit Service page is displayed in the right panel

  5. Near the bottom of the Edit Service form, find the Roles sub panel. Click the arrow icon on the left end of the sub panel bar to expand the sub panel.

  6. Use the Roles selection box to select the role(s) that should be assigned from the list of existing roles.

  7. Click the Save button near the bottom of the form to save the role assignment.



Role Properties

The following lists the properties for each product section used to define a role in JaxView. The properties are relatively self-explanatory. For example, clearing the check box for the View Admin Tab permission under the Tabs sub panel will prevent users assigned to that role from having access to the Admin tab when they are logged in. Clearing all of the Delete object items in all sub panels will prevent users with that role assignment from deleting any configuration data in JaxView.

Tabs

Services

Groups

Monitors

Alerts

Rules

Reports

Transactions