Service user catalog
On this page
Integrations and business processes often use service users: technical accounts, passwords or API tokens of other systems. Kept in personal notes or spreadsheets, they become a security risk, and an expired password breaks a process without warning. The service user catalog (Szolgáltatás felhasználói katalógus) keeps these credentials in one secure place and warns before they expire.
Menu: Szolgáltatás felhasználói katalógus. It needs the application permission Service user catalog admin.
Entries#
Felhasználó hozzáadása (Add user) opens the dialog:
- Szolgáltatás felhasználó neve (Name of the service user);
- Szolgáltatás felhasználó jelszava/tokene (Password or token), stored securely;
- Szolgáltatás felhasználó jelszavának lejárata (UTC) (Expiry of the password);
- Lejárati Figyelmeztetések (Expiry warnings): Hozzáadás adds a warning a given number of days before expiry. Add several, for example 30 and 7 days.
The list shows the status (Aktív, Hamarosan lejár expiring soon, Lejárt expired), the expiry date and the masked password. The eye icon (Jelszó megjelenítése) shows the password.
Warnings#
The background job Szolgáltatás felhasználói katalógus figyelmeztetések runs daily (01:00 by default). When a warning is due, it e-mails every user with the Service user catalog admin permission. The e-mail goes through the SMTP server of appsettings.json, not through a notification channel.
Where the credentials are stored#
Only one catalog can be active at a time. Choose it in App Konfiguráció → Szolgáltatás felhasználói katalógusok (Super Admin):
- Lokális (Local, default): encrypted in the application's internal database.
- Hashicorp Vault: in a KV v2 secret engine of HashiCorp Vault. Settings: Vault URL, Vault token (write-only), mount point (default
secret), base path (defaultworksmarthub/service-users), retry count and delay, connection timeout, and the limit of concurrent operations.
With Vault, WorkSmartHub keeps a mapping from the entries' IDs to their names in Vault. If it gets out of step, an administrator can rebuild it with the API call POST /api/service-users/mapping-rebuild; there is no button for it.
The page header shows the active catalog (Kiválasztott katalógus).