﻿# Éles üzemeltetés

> Ezek a tudnivalók minden telepítési módra és minden adatbázisra vonatkoznak.

Source: https://workwise-solutions.net/hu/docs/installation/operations/ · Language: hu · English version: https://workwise-solutions.net/docs/installation/operations/

Ezek a tudnivalók minden telepítési módra és minden adatbázisra vonatkoznak.

## Állapotellenőrzés

A `GET /health` bejelentkezés nélkül `200 {"status":"Healthy"}` választ ad, amint az alkalmazás kiszolgálja a kéréseket (az induláskori migrációk után). Mást nem érint. Terheléselosztókhoz, monitorozáshoz és Kubernetes-próbákhoz használja; a liveness próbának adjon bőséges kezdeti késleltetést, mert az első induláskor lefutnak a migrációk.

## Munkamenetek

A bejelentkezési sütiket védő kulcsok az adatbázisban vannak. Ezért a munkamenetek túlélik az újraindítást, a konténer újralétrehozását és a frissítést, és minden szerveren érvényesek. Aki hozzáfér az adatbázis egy másolatához, érvényes bejelentkezési sütit tud készíteni, ezért védje a mentéseket.

## Több szerver

Több alkalmazásszerver is használhat egy közös adatbázist:

- **Adatbázis**: SQL Server, PostgreSQL vagy MySQL. Az SQLite csak egy szervert támogat.
- **Cache**: `Redis` vagy adatbázis-cache. Az alapértelmezett `InMemory` cache esetén a jogosultságok, a licenc állapota, a törzsadatlisták és az OAuth bejelentkezési állapot szerverenként eltérhetne; az alkalmazás induláskor figyelmeztet erre.
- **Fájltároló**: felhős tároló, nem a szerver lemeze.
- **Mindenhol ugyanazok a beállítások**: azonos `appsettings.json`, az aláíró kulcsokkal és a `PublicBaseUrl` értékkel együtt.
- **A migrációk** induláskor csomópontok közötti zárolással futnak: az egyik szerver migrál, a többi megvárja.
- **Az ütemezett háttérfolyamatok alkalmanként csak egyszer futnak le az összes szerver között**: futás előtt a szerver lefoglalja az adott alkalmat az adatbázisban, így egyetlen e-mail, Slack/Teams üzenet vagy Számlázz.hu hívás sem duplázódik. A szerverek órája legyen szinkronban és azonos időzónában, és 1 napos vagy rövidebb időközöket használjon. A *Futtatási zárolások takarítása* háttérfolyamat törli a régi foglalásokat (naponta 04:15-kor, 7 napig őrzi meg őket).
- Az App Konfiguráció módosításai kb. 10 másodpercen belül eljutnak a többi szerverre.

![WorkSmartHub több szerveren](https://workwise-solutions.net/docs/images/diagram-multi-node-hu.png)
*Több szerver közös adatbázist, cache-t és felhős fájltárolót használ; az ütemezett háttérfolyamatok alkalmanként egyszer futnak.*

## Leállítás

Leállításkor az alkalmazás 45 másodpercet ad a háttérfolyamatainak, majd lezárja az adatbázist. Hagyjon neki legalább 60 másodpercet: Dockerben `--stop-timeout 60`, systemd alatt `TimeoutStopSec=75`, IIS alatt `shutdownTimeLimit="60"`.

## Naplózási szintek

A minimális naplózási szintek az `appsettings.json`-ból (`Serilog:MinimumLevel`) vagy környezeti változókból jönnek, hacsak az **App Konfiguráció → Log Szintek** nem írja felül őket az összes szerveren. Ott minden módosítást a rendszergazda nevével rögzít az alkalmazás. Éles környezetben ne használjon Debug vagy Verbose szintet, legfeljebb rövid ideig: ezek sokkal több adatot írnak, köztük személyes adatokat is, és megtöltik a lemezt. A kérésnaplók soha nem tartalmazzák a hitelesítő adatokat hordozó lekérdezési paramétereket.

## Tárolt titkok

A felületen megadott titkok (az értesítési csatornák és fájltárolók hitelesítő adatai, a Számlázz.hu kulcsai, a HashiCorp Vault token) csak írhatók: soha többé nem jelennek meg, és ha a mezőt üresen hagyja, a tárolt érték megmarad. Ha a titok célja megváltozik (SMTP-szerver vagy port, MinIO szerver, S3 régió, Azure tárfiók, SharePoint tenant, Vault URL, a típus, vagy kikapcsolja az SSL-t), a titkot újra meg kell adni. Titok cseréjekor hozzon létre újat a szolgáltatónál, adja meg, és csak utána vonja vissza a régit.

## Biztonsági ellenőrzőlista

- Saját aláíró kulcsok, HTTPS, `SecureCookie: true`, beállított `PublicBaseUrl` ([Konfiguráció](https://workwise-solutions.net/hu/docs/installation/configuration/)).
- A fordított proxynak **felül kell írnia** az `X-Forwarded-Host` és `X-Forwarded-Proto` fejlécet, mert az alkalmazás megbízik bennük.
- Az `appsettings.json` és a mentések csak a rendszergazdák számára legyenek elérhetők.
- Nézze át az **Admin Token Menedzsment** oldalt, és érvénytelenítse a nem használt tokeneket.
- Ha nincs szüksége az API-dokumentációra, kapcsolja ki a `Swagger.Enabled` beállítást.
- Hagyja bekapcsolva a biztonsági fejléceket (**App Konfiguráció → Biztonsági fejlécek**).

## Parancssor

Az alkalmazás parancssori műveleteket (verb) is elfogad. A `dotnet WorkSmartHub.dll --help` kilistázza őket; a jelenlegi kiadásban:

| Művelet | Szerepe |
|---|---|
| `run` | A webalkalmazás futtatása (ez az alapértelmezés, ha nincs megadva művelet) |
| `database` | Műveletek a belső adatbázison: mentés, visszaállítás, ürítés, migrálás. A migrálás ugyanazt a csomópontok közötti zárolást használja, mint az indulás. |
| `user-store` | A beállított felhasználói tár lekérdezése (címtárkapcsolat kipróbálására hasznos) |
| `help`, `version` | Súgó és verzióinformáció |

A műveleteket az alkalmazás mappájában, ugyanazzal az `appsettings.json` fájllal futtassa, visszaállítás előtt pedig állítsa le az alkalmazást.
