User Guide
This guide is for operators and administrators who work with the OneIoT Angular UI portals — the Support Portal and the Management Portal — through the browser.
It focuses on practical use, how the portals are organised, and what to expect — without requiring backend, build, or deployment knowledge.
Who should read this guide
Use this guide if you:
-
use the Support Portal or the Management Portal day to day,
-
need to understand how to navigate and operate the portals,
-
support other users working in the portals.
If you are a developer or maintainer looking for architecture, build, or deployment details, use the Technical Documentation instead.
What the portals are
The OneIoT Angular UI bundles two single-page applications served by Nginx:
-
Support Portal — the end-user support portal, opened at
/support-portal/. -
Management Portal — the administrator portal, opened at
/management-portal/.
Both portals talk only to the UI Backend REST API. Everything else (database, caches, device management) is reached through the backend, never directly by the browser.
Recommended reading order
If you are new to the portals, follow this order:
-
Getting Started — sign in and orient yourself.
-
Navigation Model — how the UI is laid out.
-
Support Portal or Management Portal — the portal you use.
Portal guides
Use these pages for the portal you work with:
-
Support Portal — the end-user support portal.
-
Management Portal — the administrator portal.
Roles & permissions
Access in the OneIoT portals is governed by user groups and portal permissions. Permissions are
defined per portal (client type sc = Support Portal, mc = Management Portal) and uploaded to the
UI Backend by the portals container on startup (see
Installation & Deployment).
The applications enforce the same rules in the UI: route and tab guards hide what a user group is not allowed to open, and the navigation menu is filtered to the permitted entries. The backend re-checks every permission, so hiding an action in the UI is a convenience, not the security boundary.
- Operator
-
Day-to-day portal user. Can view data and perform the operations enabled for their user group.
- Administrator
-
Operator capabilities plus user and permission management.
| What you can see and do is determined by your user group and the portal permissions applied by the backend. If an action is not available to you, contact an administrator to review your access. |
| If you do not see an action described in this guide, your user group may not allow it. Contact an administrator to review your access. |
Help and troubleshooting
If something does not work as expected:
-
Check Troubleshooting.
-
Review any validation messages and errors shown in the UI.
-
Contact an administrator if access or permissions are missing.
Glossary
If a term is unfamiliar, see Glossary.
| This guide is written so you can jump directly to the portal or task you need. You do not have to read it from start to finish. |