Getting Started

This section helps you quickly understand what the OneIoT Angular UI portals are, who they are for, and how to start working with them.

Who this is for

The portals are used by operators and administrators who work with the OneIoT Web platform through the browser. Two portals are available:

Portal Purpose

Support Portal

End-user support portal for day-to-day operations.

Management Portal

Administrator portal for platform configuration and management.

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.

Accessing the portals

Once the portals container is deployed (see Installation & Deployment), open the portal you need in a browser:

Replace <host> with the address configured for your environment, and use https://<host>:8843/…​; where TLS is published. Opening the path without the trailing slash redirects to it automatically.

Login

To log in:

  1. Open the portal URL in your browser.

  2. Enter your username and password.

  3. Confirm to continue.

If the platform requires a password change, you are taken to the change-password screen before the rest of the portal becomes available. Depending on the installation, single sign-on (SAML or OIDC) may be offered instead of the username/password form, and the "forgot password" link may be hidden.

Next steps