User access management – Knowledge Base

For those who require access to Kio Asset Tracker, they need to be added as users and assigned roles from the Kio Cloud Users app. Kio Cloud utilizes role-based permissions to control user access to Kio apps and their permissions. Each role provides a pre-defined set of permissions that control what the user can and cannot do within an app.

Topics include:

Things to know
Asset Tracker: roles and permissions
Add a user and assign their roles
Edit a user's assigned roles
Remove a user's access to Kio Cloud

Things to know

You must be assigned to the Administrator role within User Management to view, add, and edit users.
If a user is not assigned to a role within an app, the app is not displayed in their Kio Cloud Launchpad.
A user's email address can only be associated with a single Kio Cloud account.
Once a user is added, only the Kontakt.io support team can change their email address. You will need to submit a Kontakt.io support request for an email address change.
If your organization has integrated Kio Cloud with its Single Sign-On (SSO) identity provider (IdP), user management within the Kio Cloud Users app is limited to viewing SSO users and their assigned roles. The first time a user authenticates to Kio Cloud with their SSO credentials, their user profile is automatically created within the Kio Cloud Users app.
The apps available are those activated in your organization's Kio Cloud account. If you don't see an app or want to activate another app, submit a Kontakt.io support request .

Asset Tracker: roles and permissions

Quick reference of role access by menu.

Menu	Administrator	User	Search user
Assets Search	Yes	Yes	Yes
Asset Management	Yes	Yes	No
Map View	Yes	Yes	Yes
Rooms	Yes	Yes	No
Alerts List	Yes	Yes	No
Analysis: Summary Dashboard	Yes	Yes	No
Settings: all sub-menus	Yes	No	No

Role

Permissions

Administrator

This role has full permissions — they can view and manage everything within the app.

What a user assigned to this role can do:

View all data and perform actions within all menus and their sub-menus.
Manage asset inventory (add, edit).
Manage (add, edit, delete) Alert Rules.
View-only access to Room Types and Room Matching; these settings are managed from Company Settings.

Note

Advanced asset management is completed from Company Settings by those assigned to the Company Settings Administrator role. This includes the capabilities to manage the advanced settings for Asset Types (Entity Types) and Assets (Entities), including permissions to delete Asset Types and Assets.

User

This role has permission to the search and locate assets, manage asset inventory, view and respond to alerts, and access to analytics — they can view all data within these menus and perform all actions.

This role does not have permission to the Settings menu.

Role is ideal for: those that need to locate assets, responsible for asset management, tagging assets, and responding to alerts, and viewing analytics.

Search user

This role has permission locate assets - either from the Assets Search or Map view.

This role does not have permission to the Settings menu and cannot view alerts or analysis menus.

Role is ideal for: those that only need to locate assets.

Add a user and assign their roles

From your Kontakt.io Launchpad, select Users.
From the upper-right corner, select Add User.
Enter their details > select Add User. They will receive an email from hello@kontakt.io to set their password.
Next, you'll assign a role to the apps they require access to. From the list of users, search for their name > select their name.
From the section Roles for Apps > select Edit.
For each app they require access to, select a role to assign their permissions > select Save.

Edit a user's assigned roles

A user's assigned role determines their access and permissions within each of the apps. If a user is not assigned to a role within an app, the app is not available from their Kontakt.io Launchpad.

From your Kontakt.io Launchpad, select Users.
From the list of users, locate the user > select their Name.
From the Roles for Apps section, select Edit.
From an app, update their assigned role > select Save.

Remove a user's access to Kio Cloud

From a user profile, the disable and delete options allow you to remove a user's access to your Kio Cloud account. Once removed, all user activity within the Kio apps is retained for historical metrics and reference. Commonly, this action is performed when a user has left your organization or no longer requires access to Kio Cloud.

Disable option: Only applies to users that sign in with SSO.
Delete option: Only applies to users that sign-in with email.