Note: The Client Management feature is currently in its beta stage, with several additional components planned in the product roadmap. The client portal functionality aims to offer a high level of customization, enabling MSPs to deliver tailored services to their clients.
The Client Management module in Zoho IoT enables Managed Service Providers (MSPs) to manage the IoT resources of multiple clients within a single application. Each client can securely access their assigned devices, assets, locations, and related data through the Client Portal without visibility into other clients or the MSP’s internal resources through its multi-tenancy capabilities.
Example Scenario : In this document, lets assume "Zylker Energy" as the MSP that is providing energy monitoring services to buildings and individuals located in various locations across Chennai.
Core Concepts / Terminologies
1. Client
A Client (also called as tenants or customers) refers to any business, organization, facility owner, or individual who utilizes the services offered by the MSP. In other words, a Client is the end recipient of the MSP's IoT services, whose devices, assets, and locations are monitored and managed through the MSP's IoT setup.
If Zylker Energy is the MSP providing energy monitoring across multiple buildings in Chennai, then:
- Each building owner, facility manager, or business occupying a building is considered a Client of Zylker Energy.
- These clients rely on Zylker to monitor remotely, analyze, and manage their energy usage using the Zoho IoT platform.
Refer to the Adding a Client section of the document for more details.
2. Client Module
The Client module in the Zoho IoT application helps to manage the clients of the MSP. The following client related operations can be performed within the client module:
- Create or Edit a Client
- Enable/Disable the Client Portal for the Client
- Mark any Client as Inactive
- Manage Uses for the Client
- Attach files to the Client
Refer to the Working with Client Management section of the document for more details on the operations.
3. Client Portal
Though the MSP manages and maintains the solution, the data collected is pertaining to a client. So the MSP can provide the client with access to their data over a dedicated portal.
The portal functionality can be enabled for a specific client, and the users can be invited to access the associated client data via the portal.
Note: The MSP user can completely rebrand the portal and sell/provide it as their own application to their clients.
Refer to the Configuring Client Management section for more details.
The portal's user interface can be customized as required. Refer to the Editing the Client Portal Settings section for more details.
4. Portal Users
Client portal users are linked to a specific portal-enabled client and can only access their data.
- Client Portal users can be added using the "Manage Users" option, which will be displayed only when the Client Portal is enabled. (Refer to the Client Portal User section for more details)
- A user with the same email ID cannot be duplicated across Clients.
Note: A MSP can create a client without any portal users and manage their assets.
5. Profiles and Rules
Profiles and rules are key access-control mechanisms that define what a client portal user can view and perform. It helps to control data visibility, ensuring secure, role-based, and context-specific access in the client portal.
In Zoho IoT's client portal management, Profiles and rules are key access-control mechanisms that define what a client portal user does. It helps to control data visibility, ensuring secure, role-based, and context-specific access in the client portal. There are two types of associations for profiles and rules in Zoho IoT: the Client and Common.
- Client: Created specifically for individual clients, and can be applied only to users associated with that particular client.
- Common: These are shared configurations that can be applied uniformly to all client portal users, regardless of their client association.
Note: The Portal Admin profile is the only system defined common profile available in the application that can be cloned for creating other client profiles. Clients cannot create common profiles and rules.
Refer to the User Profiles and Data Slicing Rules for more details.
Ownership
1. Ownership Types
Ownership determines the level of association and accessibility of resources within the MSP and client setup. The ownership types available in Zoho IoT are Organization, Client, and Common.
- Organization - Entities managed by MSP for internal usage and are not accessible to clients.
- Client - Entities dedicated to a selected client.
- Common - Shared entities managed by the MSP that are currently not accessible for clients.
Note: All the managed entities such as gateways, sensors, etc., that were created before client portal config will be associated to the organization.
2. Ownership Scenarios
# Scenario 1– OEMS - MSP managing multiple clients
MSP Name: SmartTrack Solutions
Clients: Client A – Alpha Manufacturing, Client B – Beta Industries
Ownership Type | Example Scenario |
|
Organization | A set of IoT gateways and sensors installed in the MSP’s own test lab. These are used for testing new alarm rules and firmware updates before rolling them out to clients.
| Internal testing ensures system stability and prevents downtime at client sites. Clients don’t see these resources. |
Client | An energy meter and vibration sensor installed at Alpha Manufacturing’s production line. | These devices belong solely to Alpha Manufacturing, and Alpha can fully manage and view their data in the Client Portal. |
Common (supported for locations only) | A shared logistics hub location that stores spare parts for both Alpha Manufacturing and Beta Industries | The location appears in both clients’ dashboards as a reference point for device deployment, but neither client can directly manage it.
|
In this Manufacturing scenario:
- Organization → covers MSP’s own tools.
- Client → covers client-owned resources.
- Common → covers shared, reference-only locations.
Note: All the managed entities such as gateways and sensors stated in the above scenario, that were created before client portal config will be associated to the organization.
# Scenario 2 – Facility Management - MSP managing multiple tenant
MSP Name: GreenSense Automation
Clients: Client A – Sunrise Towers, Client B – Metro Mall
Ownership Type | Example Scenario |
|
Organization | A demo building floor in the MSP’s own office, equipped with HVAC controllers, lighting sensors, and access control devices. Used by the MSP to test new BMS automation scripts before deploying them to clients. | Internal testing ensures new automation rules work as expected without affecting client buildings. Clients don’t see these devices. |
Client | Smart thermostats, occupancy sensors, and energy meters installed in Sunrise Towers’ HVAC system. | These belong entirely to Sunrise Towers, and they have full visibility and control in their BMS portal. |
Common (supported for locations only) | A shared underground parking facility that both Sunrise Towers and Metro Mall use, equipped with environmental sensors (CO₂, temperature) and lighting control.
| The location appears in both clients’ dashboards for monitoring, but neither can directly manage it—it’s maintained by the MSP as a shared space. |
In this BMS scenario:
- Organization → MSP’s own testing or shared operations area.
- Client → Devices and systems fully owned and managed by one client.
- Common → Shared spaces or facilities used by multiple clients but controlled by the MSP.
Note: All the managed entities such as HVAC controllers, lighting sensors, and access control devices stated in the above scenario, what were created before client portal configuration will be associated to the organization.
3. Ownership Types Across Modules
The following table lists the ownership types to which a module can be associated.
Module | Supported Ownership Type |
Devices | Client, Organization |
Asset | Client, Organization |
Location | Client, Organization, Common |
Certificate | Client, Organization |
Policy | Client, Organization |
Products | Client, Common |
Manufacturer | Client, Common |
Vendor | Client, Common |
Custom Modules having client lookup fields. | Client, Organization |