Skip to content

ExoSense User Management

Users in ExoSense are managed by their unique email address. Each user has a Role assigned to them that defines their permissions in the application. Users are also invited to one or more groups, which contain assets, group-level dashboards, devices, and sub-groups. A user will have access to each group and all sub-groups.

Inviting Users

The Users page allows inviting new users and checking the roles / group permissions of existing users.

To invite a user, click the button on the Users page, add their email address, choose their permisison role and the group(s) they will have access to in the hierarchy.

Inviting Multiple Users

Multiple users can be invited at one time if they have the same role and group access. Add each of their email addresses to the email form box seperating them with a comma (e.g. user1@example.com,user2@example.com).

User Roles

Users with the Setup - Roles permssion in their role (including Host Administrators) can create, edit, and remove user roles. Roles define functionality rights to a user. The default role for initial users is 'Host Administrator' which provides all functional permissions below. As an example, administrators (those with the Setup-Roles function enabled) can create a new role such as "Installer".

Permissions and Group Relationship

All permissions adhere to a strict control access policy tied to the group node at which the User with the role (permissions) has.
Examples:

  • A user with a Role with the View Asset Data permission will only see assets and groups that they have access to in group hierarchy.
  • A user with a Role with the Asset Management permission will only be able to add and edit assets that they have access to in group hierarchy.
  • A user with a Role with the User Management permisions can only invite and edit users within the groups they have access to.

Permissions and Feature Availability

Some permssions are tied to the feature available to the solution. Some features are enabled/disabled at the Tier level. Features are also controled with the administrative Feature Controls.

Role Permissions

Permission General Type Description
View Asset Data Viewer Allows viewing assets in lists and their data in dashboards, event logs, and reports.
View Asset Viewer Allows viewing assets in lists (including statuses and last reported times.) This is the most restrictive viewing permission.
Dashboard Management Viewer Allows a user to publish/unpublish dashboards. Legacy Permission: No longer supported with new Side Navigation UI.
Asset Management Asset Management Allows a user to manage assets, including adding, editing, and removing of assets, configuration, and dashboard creation.
Asset Template Management Asset Management Allows a user to manage asset templates.
File Management Asset Management Allows a user to maintain (upload) asset content files and setup Content Viewer dashboard panels.
View Unpublished Files Asset Management Allows a user to see an asset's content files that have been uploaded, i.e. see the Asset Content tab. Can not upload new files.
Asset/Device Control Asset Management Allows the user ability to interact with device control dashboard panels.
Bulk Change Asset management Allows users to easily make bulk updates to large numbers of signals or assets.
User Management Manager Allows for inviting, editng (user's role/groups) and removing users.
Group Management Manager User can access the Browse screen and add, edit, and remove groups, as well as change an asset’s group assignment.
Device Management Device Management Users can look at connected IoT device data and configure their channels.
Device Software Package Management Device Management Allows a user to see and apply available software packages for devices.
Device Software Package Administration Device Management Allows a user to manage software packages available to devices.
User Activity Logs Administrator - Group Allows for viewing user activity logs. User must be on the root node for permission to be enabled.
Manage Custom Insights Administrator - Group Allows users to create custom transforms and rules in the UI using MathJS or JSON-e.
Api Tokens Administrator - Group Allows a user to create and delete API Tokens.
Setup - Roles Administrator - Group Allows a user to create, edit, and delete user roles from the larger set of user permissions.
Legal Administrator - Solution Allows user to edit the standard terms and conditions, and add a custom URL for the privacy policy.
Setup - Theme Administrator - Solution Allows a user to control the theme and logos, application name, default language,
Setup - Data Sources Administrator - Solution Allows an administrative user to view which IoT connectors are available for this ExoSense instance.
Setup - Feature Control Administrator - Solution Allows an administrative user to control which features are enabled on a solution.

Creating / Editing User Roles

User Role Management Area

In this example, a new user role called "Installer Midwest Region" can be created with permissions to view asset data and manage Asset configuration. This new role can optionally be assigned to only be accessible at a sub group node.

Setup a new user role


Last update: February 7, 2022