Konfigurationsreferenz

Die Konfiguration verteilt sich auf zwei Ebenen: die Serverkonfiguration (Datei appsettings.json bzw. Umgebungsvariablen, nur am Server änderbar) und die System-Einstellungen in der Web-Oberfläche.

Serverkonfiguration

Sicherheitsrelevante Werte werden bewusst nicht über die Web-Oberfläche gepflegt:

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
Velkaris:OpenApi:Exposed	Schaltet die interaktive REST-API-Referenz (/api-docs) frei
Kestrel:Endpoints:Http:Url	Adresse/Port des Webservers (Standard http://0.0.0.0:5050)

Diese Schlüssel sind über die Einstellungs-Seite und die API gesperrt — ein Änderungsversuch meldet „Schlüssel ‘…’ ist nicht über die UI schreibbar.“

System-Einstellungen (Web-Oberfläche)

Installationsweite Schlüssel-Wert-Einstellungen, gruppiert nach Präfix — Pflege über Einstellungen (/system/settings), Details siehe System-Einstellungen:

Präfix	Bereich
Pii.*	PII-Erkennung (z. B. Ratenbegrenzung, Detektor-Vorgaben)
DemoMode.*	Demo-Modus (Limits, Captcha, Wasserzeichen, Aufbewahrung, AllowImpersonation)
UI.*	Oberfläche — z. B. UI.DefaultLanguage als installationsweite Standardsprache
Tracking.*	Optionales Google-Analytics-Tracking der öffentlichen Seiten
Auth.*	Authentifizierung — z. B. Auth.Password.* als systemweite Passwort-Richtlinie
Export.*	Export-Verhalten

Mandanten können einzelne Vorgaben (z. B. die Passwort-Richtlinie) durch eigene Mandanten-Einstellungen übersteuern.

Programmierschnittstellen

• System-REST-API für Betrieb und Automatisierung: System-REST-API
• Interaktive API-Referenz für Mandanten-Integrationen: Schnittstellen