Betrieb und Sicherheit
This content is not available in your language yet.
Wichtige Serverkonfiguration
Abschnitt betitelt „Wichtige Serverkonfiguration“Einige sicherheitsrelevante Werte werden bewusst nicht über die Web-Oberfläche gepflegt, sondern in der Serverkonfiguration (appsettings.json bzw. Umgebungsvariablen):
| Schlüssel | Bedeutung |
|---|---|
Velkaris:DataPath |
Datenverzeichnis der Installation (Systemdatenbank system.db + ein Unterordner je Mandant mit velkaris.db). |
Velkaris:Jwt:Secret |
Signaturschlüssel der API-Tokens — in Produktion zwingend auf einen eigenen, zufälligen Wert setzen. |
Velkaris:Encryption:Enabled / :MasterKey |
Verschlüsselung der Dokumentablage; Masterkey (≥ 32 Byte, Base64) alternativ über die Umgebungsvariable VELKARIS_ENCRYPTION_KEY. |
Kestrel:Endpoints:Http:Url |
Adresse/Port des Webservers (Standard http://0.0.0.0:5050). |
Empfehlungen
Abschnitt betitelt „Empfehlungen“- Datensicherung: Sichern Sie regelmäßig das gesamte Datenverzeichnis — es enthält die Systemdatenbank, alle Mandanten-Datenbanken und die Dokumentablage.
- Erstkonfiguration: Standardpasswort sofort ändern (wird erzwungen),
Velkaris:Jwt:Secretsetzen, Verschlüsselung mit Masterkey aktivieren, HTTPS über einen vorgelagerten Reverse-Proxy bereitstellen. - API-Schlüssel-Hygiene: Ein Schlüssel je Automatisierung, Ablaufdaten nutzen, Nutzungsstatistik regelmäßig prüfen.
- Audit-Log in Prüfprozesse einbeziehen — jede System-Admin-Aktion ist dort nachvollziehbar.
Problembehandlung
Abschnitt betitelt „Problembehandlung“| Symptom | Ursache / Lösung |
|---|---|
| Benutzer eines Mandanten sehen „Keine gültige Lizenz“ | Lizenz fehlt/abgelaufen/falsche Hardware-ID → Kapitel „Mandanten-Lizenzen“; Status-Badge prüfen. |
| Dashboard: Worker Inaktiv | Hintergrunddienst prüfen/neu starten; danach zeigt „Letzter Tick“ wieder wenige Sekunden. |
/demo liefert 404 |
Demo-Modus ist deaktiviert → Schalter „Demo-Modus aktiv“ einschalten. |
| Anmeldung: „Zu viele Versuche…“ | Ratenbegrenzung — etwa eine Minute warten, dann erneut versuchen. |
| Wörterlisten-Upload: „Die Datei ist nicht UTF-8-kodiert…“ | Datei mit VS Code/Notepad++ als UTF-8 speichern und erneut hochladen. |
| Mandanten-Admin ausgesperrt | Mandanten → Benutzer → „Zurücksetzen“ beim betroffenen Konto. |
| Proxy-Test scheitert mit 407 | Proxy-Zugangsdaten prüfen; ggf. „Anmeldedaten des Dienstkontos verwenden“ aktivieren. |