Add or Configure a Custom Role for Aternity Users

You can define custom roles in Aternity on-premise, to supplement the native default roles which ship with the system. A role is a set of abilities and actions (known as privileges) which a user can perform in Aternity. You can assign several roles to a user or group of users, to allow them to perform those actions.

For example, you can create a role for those who can only maintain the list of managed applications in the system, but are not allowed to view or edit anything else, which would correspond to this kind of job in your organization.

The system comes with a set of default roles which group together a typical job title with its common abilities in the system.


  1. Step 1 Open a browser and log in to Aternity.
  2. Step 2 Select the Gear Icon > Roles.
    View the current list of custom roles
  3. Step 3 To create a new custom role, select + Add Role.

    Select the privileges allowed for this role.

    Define the privileges allowed by users with this role
    Field Description
    Access Management
    • Manage users enables you to view and edit users or user groups in the Gear Icon > Users window.

    • Manage user roles enables you to view, add or edit user roles in the Gear Icon > Roles window.

    Advanced Settings
    • Agent List enables you to see the Agent information when you select Show all in the Gear Icon > Agents > Agent Admin window.

    • Agent Management enables you to configure an Agent in the the Agent Dashboard window (change the state, log level, or download Agent logs). Go to the Gear Icon > Agent > Agent Admin > Show all > device_name > Agent dashboard.

    • View allows you to see the Basic Settings in the Gear Icon > Settings window.

    • Manage allows you to view and modify the Basic Settings in the Gear Icon > Settings window.

    • View Dashboards allows you to see the dashboards in the Monitors, Troubleshoot, Validate and Inventory categories.

    • Analyze Use Cases enables you to access and configure the Analyze dashboards (except for the Advanced ones).

    • Advanced Analytics enables you to access the Analyze (Advanced) dashboards.

    End Points

    Not used.

    End Points Groups
    • View allows you to see the Settings and the Assignment of device groups when you select the Gear Icon > Groups Settings window.

    • Manage allows you to view, create, edit, or delete the groups in the Groups Settings window.

    Endpoint Attributes
    Hook Configuration

    If you select the Gear Icon > Location Mapping window

    • View allows you to download and view the current location mapping.

    • Manage allows you to download, view, edit and upload the location mapping file.

    Manage EP Agent
    • End Point Agent Administration allows you to view, enable, or disable existing monitors in the Gear Icon > Agents > Show All > device_name > Agent Dashboard > Monitors window.

    • Agent Status enables you to view the Agent Current Status on a device whose host name you select in the Gear Icon > Agents > Show All >device_name > Agent Admin window.

    • Agent Events enables you to view the Gear Icon > Agents > Show All > Agent Admin > device name > Agent Dashboard > Agent Events window, and to download an Excel file with the events.

    Performance Navigator
    • Manage enables you to generate and schedule reports in the Gear Icon > Reports window.

    System Health
  4. Step 4 To edit or configure an existing custom role, select Edit.
  5. Step 5 To remove a custom role, select Delete.