﻿# App configuration

> Alkalmazás → App Konfiguráció (Alkalmazás konfiguráció) holds the settings that administrators change while the application runs. It is available to Super admins only. Settings that are needed at start-up (database, user store, keys, listen address) are in appsettings.json instead (Configuration).

Source: https://workwise-solutions.net/docs/features/app-configuration/ · Language: en · Hungarian version: https://workwise-solutions.net/hu/docs/features/app-configuration/

**Alkalmazás → App Konfiguráció** (*Alkalmazás konfiguráció*) holds the settings that administrators change while the application runs. It is available to **Super admins** only. Settings that are needed at start-up (database, user store, keys, listen address) are in `appsettings.json` instead ([Configuration](https://workwise-solutions.net/docs/installation/configuration/)).

Choose a category on the left (*Válasszon kategóriát*), change the values, and click **Módosítás** (Save); the page reloads. On several servers, the change reaches every server within about 10 seconds. **Alapértelmezett konfiguráció visszaállítása** (Restore default configuration) resets every category to its default and removes a custom logo, after a confirmation. Every save, reset and logo change is recorded in the audit log with the changed fields; secrets are never recorded.

## Megjelenés & Hangulat (Look and feel)

The application bar: **Alkalmazás neve** (name, default *Work Smart HUB*), **Alkalmazás alcíme** (subtitle) and **Alcím link** (the link of the subtitle), an optional logo (**Válasszon képet**, JPEG, PNG or SVG; uploaded after saving), and five colours: primary, text on primary, error, text on error, and the grey tone.

![Look and feel](https://workwise-solutions.net/docs/images/appconfig-look-and-feel.png)

## Oldal Láthatóságok (Page visibility)

Which pages users with only the *Public* permission can see: **Státusz**, **Licenc**, **Hozzáférési Token** (personal access tokens), **App Értesítési Csatornák**, **App Fájltárolók**. Users with any other permission always see them. Details: [Permissions and roles](https://workwise-solutions.net/docs/permissions-and-roles/#pages-that-standard-users-can-be-allowed-to-see).

![Page visibility](https://workwise-solutions.net/docs/images/appconfig-page-visibility.png)

## Biztonsági fejlécek (Security headers)

The HTTP security headers sent with every response, each of which can be turned on or off: Strict Transport Security (HSTS) with max age, subdomains and preload; Content Security Policy and its value; X-Frame-Options; X-Content-Type-Options; Referrer Policy; Permissions Policy; Expect-CT. Change the Content Security Policy only if you know why.

![Security headers](https://workwise-solutions.net/docs/images/appconfig-security-headers.png)

## Principal kereső (Principal search)

How the user and group search fields behave (for example in workspace permissions): the minimum number of characters before searching (0–5, default 3) and how long results are cached (default 60 seconds). Useful with large directories.

![Principal search](https://workwise-solutions.net/docs/images/appconfig-principal-search.png)

## Log Szintek (Log levels)

The switch **Szerver naplózási szintek felülírása** (Override the server's log levels) decides where the minimum log levels come from:

- **Off** (default): from the server configuration, `Serilog:MinimumLevel` in `appsettings.json` or environment variables.
- **On**: the three levels chosen here (*Alapértelmezett naplózó* application, *Web szerver naplózó* web server, *Rendszernaplózó* system) apply on every server.

Each field shows the level in effect on the server that answered. Do not use Debug or Verbose in production except briefly for troubleshooting: they write much more data, which can include personal data.

![Log levels](https://workwise-solutions.net/docs/images/appconfig-log-levels.png)

## Fájltárolók (File storages)

Which [file storage](https://workwise-solutions.net/docs/features/file-storages/) types can be used (*Engedélyezve*): server disk (with its root folder, default `FileStorage`), Azure, Amazon S3, MinIO, Box, SharePoint, Google Cloud Storage. Do not use the server disk with more than one server.

![File storage types](https://workwise-solutions.net/docs/images/appconfig-file-storages.png)

## Háttérfolyamatok (Background jobs)

The scheduled jobs that run inside the application. Each has **Engedélyezve** (enabled), **Első futás** (first run, time of day in the server's time zone; UTC in the Docker image), **Intervallum** (interval), and optional filters: only on given weekdays, days of the month, or months.

![Background jobs](https://workwise-solutions.net/docs/images/appconfig-hosted-jobs.png)

| Job | Default | What it does |
|---|---|---|
| Adatbázis tisztítás (Database housekeeping) | daily 01:00 | Deletes events, error events and action tokens older than their retention (365 days each). 0 keeps everything. |
| Figyelmeztetés a személyes hozzáférési token lejáratára | daily 01:00 | Sends the token expiry warnings set on the tokens. |
| Munkajegy figyelmeztetések (Ticket reminders) | daily 01:00, 5 days | E-mails the assignees and workspace admins about open tickets that have not changed for the given time. |
| Raktárkészlet figyelmeztetések (Stock warnings) | daily 01:00, threshold 15 | E-mails component admins the components at or below the threshold. |
| Szolgáltatás felhasználói katalógus figyelmeztetések | daily 01:00 | E-mails the service user catalog admins about expiring passwords. |
| Számla státusz szinkronizálás (Invoice status sync) | every 30 minutes, 20 invoices, 1000 ms between calls | Syncs invoice statuses with Számlázz.hu; does nothing while invoicing is off. |
| Futtatási zárolások takarítása (Run-once claim cleanup) | daily 04:15, keeps 7 days | Deletes old records that make sure each job runs only once across servers. Safe to leave on. |

On several servers each job runs only once per scheduled time; use intervals of 1 day or less there. Allowed intervals are 1 second to 365 days.

![Background jobs and what they do](https://workwise-solutions.net/docs/images/diagram-background-jobs-en.png)
*The scheduled jobs with their default schedule and their effect.*

## Hozzáférési tokenek (Access tokens)

Settings of [personal access tokens](https://workwise-solutions.net/docs/features/personal-access-tokens/): whether rolling refresh tokens are allowed, the default lifetimes (refresh 90 days, access 8 hours) and the maximum lifetimes (refresh 730 days, access 48 hours). Format `dd.hh:mm:ss`.

![Access tokens](https://workwise-solutions.net/docs/images/appconfig-access-tokens.png)

## Szolgáltatás felhasználói katalógusok (Service user catalogs)

Where the [service user catalog](https://workwise-solutions.net/docs/features/service-user-catalog/) keeps its credentials: the local database or HashiCorp Vault (only one can be active).

## Általános forgalmi adó (VAT)

**Forgalmi adó százalékos értéke** (the default VAT rate, 27 unless changed; 0 is allowed; acting works, components and deliveries can have their own rate, see [VAT rate per item](https://workwise-solutions.net/docs/features/invoices-szamlazz-hu/#vat-rate-per-item)) and **Valuta megjelenítés** (currency label, default *Ft*). At 0 % an exemption code can be chosen for Számlázz.hu invoices: none, *AAM* or *TAM*. The code counts only while the rate is 0; at any other rate it is ignored. While Számlázz.hu invoicing is on, the rate must be 27, 18, 5 or 0 and the currency HUF, EUR or USD ([Invoices](https://workwise-solutions.net/docs/features/invoices-szamlazz-hu/)). A change applies to new prices; existing tickets keep their values.

![VAT](https://workwise-solutions.net/docs/images/appconfig-tax.png)
*At 0 % the Áfa mentességi kód select appears, here with AAM for a subject-exempt business.*

## Cégadatok (Company details)

Company name, headquarters address, additional address, tax number, phone, e-mail, **Azonosító** (identifier: the prefix of ticket names), bank name and bank account number. They appear on printouts and in client e-mails, and Számlázz.hu needs the bank details. Optional fields for invoices in foreign currency, shown only while invoicing is on: *Euro bankszámlaszám*, *USD bankszámlaszám*, *IBAN* and *SWIFT/BIC*; the IBAN checksum and the SWIFT length are checked ([Currency and exchange rate](https://workwise-solutions.net/docs/features/invoices-szamlazz-hu/#currency-and-exchange-rate)).

![Company details](https://workwise-solutions.net/docs/images/appconfig-company-details.png)
*The company details of the example service, with the EUR and USD accounts, IBAN and SWIFT/BIC at the bottom.*

## Számlázz.hu

The invoicing integration; see [Invoices with Számlázz.hu](https://workwise-solutions.net/docs/features/invoices-szamlazz-hu/).

![Számlázz.hu settings](https://workwise-solutions.net/docs/images/appconfig-szamlazz-hu.png)
*The Számlázz.hu category with all six setup steps done and a stored API key.*

## Szolgáltatás felvételi lap (Intake sheet)

**Engedélyezve** turns on the **Felvételi nézet** (intake acknowledgement) on tickets. The main legal text and two optional texts are printed on it. Off by default.

![Intake sheet](https://workwise-solutions.net/docs/images/appconfig-acknowledgement.png)

## Munkajegy (Work ticket)

**Klasszikus név azonosító generálás** (classic name generation): ticket names are generated by the server from the company identifier, a running number and the year, and cannot be edited. See [Work tickets](https://workwise-solutions.net/docs/features/work-tickets/#ticket-names).

![Work ticket options](https://workwise-solutions.net/docs/images/appconfig-work-ticket.png)
