﻿# Permissions and roles

> WorkSmartHub has two layers of permissions:

Source: https://workwise-solutions.net/docs/permissions-and-roles/ · Language: en · Hungarian version: https://workwise-solutions.net/hu/docs/permissions-and-roles/

WorkSmartHub has two layers of permissions:

1. **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.
2. **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.

![Permissions on three levels](https://workwise-solutions.net/docs/images/diagram-permissions-en.png)
*Application permissions, workspace roles and the ticket-level rules for technicians.*

## 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](https://workwise-solutions.net/docs/installation/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](https://workwise-solutions.net/docs/features/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ó |

![Local users with their application permissions](https://workwise-solutions.net/docs/images/users-local.png)
*The Felhasználók (Users) page shows the application permissions of each user.*

![Workspace permissions dialog](https://workwise-solutions.net/docs/images/workspaces-permissions.png)
*The Hozzáférés-szabályozás (Access control) step of the workspace dialog.*
