User Management: Apps

Giving users the ability to access your Ubidots powered App(s) is one feature that sets Ubidots apart from our fellow IoT Application platforms, giving you the competitive advantage to develop and deploy Ubidots powered Apps to end-users who can see and interact with the Admin built App.

For example, in a Brewery, the shop floor supervisor might want his/her operators to have access to specific dashboards for daily machine uptime, but not the building's HVAC system as this is data for best serving the Maintenance team. With Ubidots' User Management, you can organize your account's data into separate groups called "Organizations", giving end-users access based on their roles within the company or project.

Ubidots powered App(s) can also be branded with your company logo and domain.

Step-by-Step

Create an Organization
– Customize/Edit the Organization's Settings
Create Roles
– Edit & Delete Roles
– Ubidots Default Roles
Create Users and assign a Role
– Edit Users
Assign Users to an Organizations
– From the Organization
– From the User
Assign Devices to an Organization
– From the Organization
– From the Device
– Bulk assign a Device Group
Assign Dashboards to an Organization
– From the Organization
– From the Dashboard
Export Organizational Data

To begin, let's discuss some Ubidots platform logic:

All Ubidots accounts begin with a single App that can be made available to users by way of a private App login portal. Each App, includes and follows the below hierarchical structure.

Admin – person who creates and manages the Ubidots Account, its App(s), and its Organizations. 1 Admin possible per Ubidots Account.
App(s) – single IoT solution containing dashboards, alerts, analytics, and organizations containing users with access permission in the form of a role.
Organizations – different tranches of Users who have access to the data provided by the App, and controlled by the Admin.
Roles – different authentication groups with designated permissions or restrictions to the tools, features, and data within an Ubidots App.
Users – person(s) able to view an App's data and engage with Ubidots based on the particular Role that the users has been given.

Different Apps allow Ubidots Administrators to brand or white-label two, or more, applications to be accessed by different end-users. All Ubidots accounts begin with a single App. To add a second App to your account, please request one in the Apps section of your Ubidots Admin Account.

1. Create an Organization

An Organization is a sub-division of any Ubidots App into different Users, Dashboards, Devices, Events and API Tokens. An Organization can be different customers, different departments of a business, or any other grouping of users, dashboards, and devices.

Creating an Organization in your App

Select "Organizations" from the "Users" tab in the main navbar.
Using the on-screen interface, add a Name and Description to your new Organization.
Register the Organization to the App by assigning it using the "App" icon located in the options to the right.

Customize/Edit the Organization's Settings

With any Organization, you can effortlessly assign devices, events, dashboards, organizational tokens and users using the left-hand Organizational Management panel.

2. Create Roles

Roles in Ubidots User Management are the different authentication groups with designated permissions or restrictions to the tools, features, and data within an Ubidots App.

Creating a new Role

First, select the "Roles" from the Users tab in the navbar.
Click the "+" icon located in the top-right corner of the interface to add a new Role group.

When editing permissions, you will see the "✓" next to any enabled permission. When an "X" is visible, the permission will not be available to the users assigned to this Role.

– Ubidots Default Roles

Explorers: can create, edit, view, and delete dashboards and events. They can view the devices, variables, and values, but can't edit or delete these.
Viewers: can view dashboards, devices, variables and their values, but can't create, edit, or delete them.
Dashboard viewers: can only see data dashboards of their organization.
Managers: can do everything an admin can do, except creating, editing, or deleting end-users.
Create your own: using Groups, you can custom create end-user access permissions as you see fit.

– Edit & Delete Roles

To edit & delete a Role, simply select the one the needed buttons from the chosen Role.

3. Create Users and Assign a Role

Users are individuals able to view an App's data and engage with Ubidots based on the particular Role that the users has been given.

To create a user, select "Users" from the "Users" tab in the main navbar then...

Assign a Username, User email, and Password
**Optional** Assign the user to Organization(s)
Assign the Role (permissions group) for the user.

– Edit Users

In the case you may need to edit a user, their Role, or see their activity, simply select the desired function from the below list of options:

4. Assign Users to Organizations

When you create a new User, he/she can easily be added to an Organization from the Organization menu or from the User's setting options.

Select the "Organizations" from the navbar
Select "Users" from the left-management pane
Click the "+" icon located in the top-right corner of the display
Assign the User to the Organization

2) From the User's Settings

Select the "Users" rom the navbar
Select "Organizations and Roles" from user options
Assign the User to 1 or multiple Organizations

After selecting an Organization for your User, you will be asked to specify its Role within the Organization.

5. Assign Devices to an Organization

IMPORTANT NOTE: For billing purposes, a Device can be assigned to ONLY ONE Organization.

Select "Organizations" form the main Users tab in the navibar
Step 1: Select the "Devices" from the left-management pane
Step 2: Click the "+" icon located in the top-right corner of the display
Add any available device to the Organization. If the device does not appear in the available list of devices, the device has already been assigned to an different Organization.

2) From the Device List

Step 1: Select "Devices" form the main Devices tab in the nav-bar
Step 2: Select the "Devices" from the left-management pane
Add any available device to the Organization. If the device does not appear in the available list of devices, the device has already been assigned to an different Organization.

3. Bulk assign a Device Group

Step 1: Select "Groups" from the Devices tab in the Nav-bar
Step 2: Assign a pre-existing Device Group to the Organization of your choice.

6. Assign Dashboards to an Organization

IMPORTANT NOTE: A Dashboard can now be assigned to MORE THAN ONE Organization. Fore more information on this, please have a look at this article.

Select "Dashboards" from the main Data tab in the navibar
Select the "Organizational Tree" from the Dashboard selector.

7. Export Monthly App Usage Reports

Knowing a particular or all of your Organizations usage is essential for scaling, budgeting and billing for any integrator or Ubidots service provider. Export the monthly usage of your Ubidots powered App(s) simply from Organization Management section of your App.

Select Organizations from the "Users" tab in the main navbar.

2. Request the "Export Organization data" button in the main control bar.

Other users also found helpful....