Service user catalog

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.

Three entries: one expired (red), two active. Passwords are masked.

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 (default worksmarthub/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.

Entries are kept in the local database or in HashiCorp Vault, and a daily job warns the admins before they expire.

The page header shows the active catalog (Kiválasztott katalógus).

App Konfiguráció → Szolgáltatás felhasználói katalógusok: the local catalog is active, Vault is off.
Did not find what you need?

Write to us or book a call. We answer questions about features, installation and licensing.

Contact us