Éles üzemeltetés
Ezen az oldalon
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:
Redisvagy adatbázis-cache. Az alapértelmezettInMemorycache 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 aPublicBaseUrlé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.
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ítottPublicBaseUrl(Konfiguráció). - A fordított proxynak felül kell írnia az
X-Forwarded-HostésX-Forwarded-Protofejlé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.Enabledbeá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.