﻿# Service user catalog

> 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…

Source: https://workwise-solutions.net/docs/features/service-user-catalog/ · Language: en · Hungarian version: https://workwise-solutions.net/hu/docs/features/service-user-catalog/

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

![Service user catalog](https://workwise-solutions.net/docs/images/serviceusers-catalog.png)
*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.

![New service user](https://workwise-solutions.net/docs/images/serviceusers-create.png)

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.

![Service user catalog](https://workwise-solutions.net/docs/images/diagram-service-user-catalog-en.png)
*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*).

![Service user catalog settings](https://workwise-solutions.net/docs/images/appconfig-service-user-catalogs.png)
*App Konfiguráció → Szolgáltatás felhasználói katalógusok: the local catalog is active, Vault is off.*
