Permissions and roles
On this page
WorkSmartHub has two layers of permissions:
- Application permissions (Jogosultságok), given to a user on the Felhasználók (Users) page or, with an external user store, on the Profilok (Profiles) page. They control the global pages: master data, users, audit, application settings.
- Workspace permissions, given to users and groups in each workspace (Munkaterületek → Jogosultságok). They control tickets, workspace notification channels and workspace file storages.
The server checks every request against these permissions; the menu only hides what a user could not open anyway.
Application permissions#
The permission list in the user dialog shows the English names below. Higher permissions include the lower ones: for example Client admin includes Client reader, and Super admin includes every permission.
| Permission (as shown) | What it allows |
|---|---|
| Public | Signing in. Every user has it. A user who has only this permission is a standard user (see page visibility below). |
| Super admin | Everything, including App Konfiguráció, Admin Token Menedzsment, Ügyfél Email Események, Profilok, editing and deleting users, replacing a valid licence. |
| Workspace admin | Create workspaces, and administrator rights in every workspace. |
| Audit reader | Események (Events) page. |
| Error audit reader | Hiba Események (Error events) page. |
| Log files reader | Naplófájlok (Log files) page, and the log details on the error events page. |
| Notification channel admin | Create, edit and delete application-level notification channels. |
| File storage admin | Create, edit and delete application-level file storages. |
| Local user reader / Local user group admin | See local users; manage local groups and memberships. |
| External user reader / External user group admin | See external users; manage external groups and memberships. |
| Client reader / Client admin | Ügyfelek page; create, edit and delete clients. |
| Manufacturer reader / Manufacturer admin | Gyártók & Típusok page; manage manufacturers, product groups and product types. |
| Acting work reader / Acting work admin | Munkafolyamatok page; manage acting works. |
| Component reader / Component admin | Komponensek page; manage components, images and the Excel import. Component admins receive the low-stock e-mail. |
| Delivery reader / Delivery admin | Szállítások page; manage deliveries. |
| Ticket config admin | Garanciát Viselők, Munkajegy Típusok, Munka Típusok pages. |
| Service user catalog admin | Szolgáltatás felhasználói katalógus page; receives the password expiry warnings. |
With Active Directory, LDAP or Microsoft Entra ID, the users and groups listed as administrators in appsettings.json (AdminUsers, AdminGroups) get Super admin automatically (Authentication).
Pages that standard users can be allowed to see#
Some pages under Alkalmazás are visible to every user who has at least one permission besides Public. Users with only Public see them only when the page is enabled for them in App Konfiguráció → Oldal Láthatóságok (Page visibility):
| Page | Rule |
|---|---|
| Státusz (Status) | Non-standard users; standard users when Státusz is enabled. |
| Licenc (Licence) | Non-standard users; standard users when Licenc is enabled. |
| Személyes Hozzáférési Tokenek (Personal access tokens) | Non-standard users; standard users when Hozzáférési Token is enabled. |
| App Értesítési Csatornák (App notification channels) | Non-standard users; standard users when App Értesítési Csatornák is enabled; and users who have the Értesítési Csatorna Olvasó (notification channel reader) role in a workspace. |
| App Fájltárolók (App file storages) | Non-standard users; standard users when App Fájltárolók is enabled; and users who have the Fájltároló Olvasó (file storage reader) role in a workspace. |
For the last two, a standard user with a workspace reader role reaches the page through the itt (here) link on the workspace page; the menu item itself follows the first two rules. Seeing an application-level list does not allow changing it: that needs the application permission Notification channel admin or File storage admin.
Licence#
While the application has no valid licence (none, expired or corrupted), anyone can upload a licence, signed in or not, so a new installation can be licensed before its first user exists. Replacing a valid licence (also one in its renewal warning period) needs a Super admin. See Licence.
Workspace permissions#
In the permission step of the workspace dialog (Hozzáférés-szabályozás) each user or group gets one or more of these roles:
| Role (Hungarian label) | Meaning (tooltip in the application) |
|---|---|
| Munkaterület Olvasó (Workspace reader) | Sees the workspace, but not its resources, and cannot do anything. |
| Munkaterület Admin (Workspace admin) | Every action in the workspace, including its permissions. |
| Munkajegy Olvasó (Ticket reader) | Reads tickets. |
| Technikus (Technician, ticket employee) | Edits tickets in a limited way (see below). |
| Munkajegy Admin (Ticket admin) | Creates, edits and deletes tickets. |
| Értesítési Csatorna Olvasó / Admin | Reads, or creates/edits/deletes, the workspace's notification channels. |
| Fájltároló Olvasó / Admin | Reads, or creates/edits/deletes, the workspace's file storages. |
Roles include the lower ones: Munkajegy Admin includes Technikus, Munkajegy Olvasó, and reading the workspace's notification channels and file storages; Technikus includes Munkajegy Olvasó and the two reader roles; Munkaterület Admin includes everything. A user with the application permission Workspace admin is administrator in every workspace.
Ticket visibility#
- Ticket admins and workspace admins see every ticket of the workspace.
- Everyone else sees only the tickets assigned to them or to one of their groups. This applies to every ticket operation (read, update, attachment upload, delay e-mail), and on the Számlák (Invoices) page non-admin users see only the invoices of their assigned tickets.
What a technician can change#
A technician (Technikus) must be assigned to the ticket, directly or through a group. On an assigned ticket a technician can change:
- the status,
- the assigned users and groups,
- acting works and components (including price overrides),
- attachments (upload and download, not removal),
- and can send the delay e-mail to the client.
Everything else (name, descriptions, client, product, ticket and work type, guarantor, dates, accessories, file storage, notification channels, delivery) is read-only for a technician, and the server keeps the stored values even if a request tries to change them. Creating and deleting tickets needs Munkajegy Admin.
Using master data on tickets#
To fill in a ticket, users do not need the global master data permissions:
- Manufacturers, ticket types, work types, guarantors, acting works and components can be picked by anyone who is at least a technician in the ticket's workspace.
- Clients and deliveries can be picked by users with Client reader / Delivery reader, and by everyone who is ticket admin in at least one workspace. Without Client reader the client picker shows the clients without their tickets.
The Ügyfelek and Szállítások pages and every change to clients and deliveries still need their own permissions.
Client details changed from a ticket#
When a ticket is saved, the client's details are updated only:
- by a Client admin, or
- for a client that was created from a ticket: by a ticket admin of every workspace that has a ticket for that client, or by the user who created the client.
A client registered on the Ügyfelek page is changed from a ticket only by a Client admin, also after tickets were linked to it. Otherwise the ticket is saved and linked to the client, the client's details stay unchanged, and the application says so.
Notification channels and file storages on a ticket#
A ticket can use an application-level channel or storage, or one of its own workspace that the user can read. Channels already on the ticket stay saveable. Component images always use an application-level file storage.
Examples#
| Person | Application permissions | Workspace roles |
|---|---|---|
| IT administrator | Super admin | (all, automatically) |
| Service team lead | Public, Client admin, Component admin, Acting work admin | Munkaterület Admin in Szerviz |
| Technician | Public | Technikus in Szerviz (through the group Szerviztechnikusok) |
| Sales person | Public, Client admin, Delivery admin | Munkajegy Admin in Értékesítés |
| Warehouse keeper | Public, Component admin, Manufacturer reader | Munkaterület Olvasó |
| Auditor | Public, Audit reader, Error audit reader, Log files reader | Munkajegy Olvasó |