Anmelde-Drosselung und Reverse Proxy

<< Klicken Sie, um das Inhaltsverzeichnis anzuzeigen >>

Navigation:  Technisches >

Anmelde-Drosselung und Reverse Proxy

Der EMIL-Server bremst wiederholte fehlgeschlagene Anmeldeversuche aus, damit sich Kennwörter, PINs und Schnittstellen-Zugangsdaten nicht durch Ausprobieren (Brute-Force) erraten lassen. Die Drosselung arbeitet vollständig auf dem Server und greift einheitlich an allen drei Anmeldewegen:

•Client-Login (Benutzer/Kennwort),

•RITA-PIN-Login am Tablet,

•FHIR-Token-Endpunkt (client_credentials der Schnittstellen-Clients).

Alle drei teilen sich Zähler und Konfiguration. Gezählt wird je echter Absender-IP-Adresse. Ein erfolgreicher Login setzt den Zähler dieser Adresse sofort zurück; nach einer einstellbaren Ruhephase ohne weitere Fehlversuche verfällt er ebenfalls.

So verhält sich die Drosselung

Nach jedem Fehlversuch antwortet der Server verzögert. Die Wartezeit wächst mit jedem weiteren Fehlversuch exponentiell (ab dem zweiten Versuch spürbar) bis zu einem Höchstwert. Ab einer harten Schwelle antwortet der Server sofort mit HTTP 429 (Too Many Requests) und einem Retry-After-Hinweis, ohne die Anmeldedaten noch zu prüfen; das schont zusätzlich die Arbeits-Threads des Servers.

Einstellungen in der config.ini

Die Drosselung stellen Sie in der config.ini des Servers im Abschnitt [SECURITY] ein. Alle Werte sind optional; fehlt der Abschnitt, gelten diese Voreinstellungen:

[SECURITY]
THROTTLEENABLED=1
THROTTLEBASEMS=500
THROTTLEMAXMS=10000
THROTTLERESETSEC=900
THROTTLEHARDLIMIT=5
TRUSTEDPROXIES=127.0.0.1;::1

Schlüssel

Bedeutung

Vorgabe

THROTTLEENABLED

Drosselung ein (1) oder aus (0).

1

THROTTLEBASEMS

Grundwartezeit in Millisekunden nach dem ersten Fehlversuch; sie verdoppelt sich mit jedem weiteren (500, 1000, 2000, 4000 …).

500

THROTTLEMAXMS

Obergrenze der Wartezeit in Millisekunden.

10000 (10 s)

THROTTLERESETSEC

Ruhephase in Sekunden: Bleiben so lange weitere Fehlversuche einer Adresse aus, wird ihr Zähler vergessen.

900 (15 min)

THROTTLEHARDLIMIT

Harte Schwelle: Ab so vielen Fehlversuchen wird die Adresse sofort mit HTTP 429 abgewiesen. 0 schaltet das ab; dann wird nur verzögert, und die Drosselung ist von außen kaum sichtbar.

5

TRUSTEDPROXIES

Vertrauenswürdige Reverse-Proxy-Adressen, mehrere durch Semikolon oder Komma getrennt (siehe unten).

127.0.0.1;::1

Nach jeder Änderung starten Sie den Applikationsserver über den Dienst ITC Server Guard neu. Alle config.ini-Schlüssel im Überblick: config.ini-Referenz.

Betrieb hinter einem Reverse Proxy (z. B. Caddy)

Damit die Drosselung je Absender greift, muss der Server die echte Adresse des Geräts kennen. Hinter einem Reverse Proxy sieht der Server zunächst nur den Proxy als Absender; alle Anfragen kämen unter einer Adresse an, und eine einzelne Adresse könnte sämtliche Nutzer aussperren.

Deshalb wertet der Server die Kopfzeile X-Forwarded-For (ersatzweise X-Real-IP) aus, aber nur, wenn die Anfrage von einer in TRUSTEDPROXIES eingetragenen Adresse kommt. Ein Gerät, das direkt mit dem Server spricht, kann seinen Zähler also nicht durch eine gefälschte Kopfzeile umgehen.

•Proxy auf demselben Rechner wie der Server: Er meldet sich als 127.0.0.1 bzw. ::1, das ist voreingestellt. Der Proxy muss nur X-Forwarded-For setzen (Caddys reverse_proxy tut das von sich aus).

•Proxy auf einem anderen Rechner (oder in einem Container): Ergänzen Sie dessen IP-Adresse in TRUSTEDPROXIES, sonst wird X-Forwarded-For ignoriert und alle Clients teilen sich einen Zähler.

Ein minimales Caddyfile (Weiterleitung auf den HTTPS-Port des Servers, Voreinstellung 8443, siehe HTTPSPORT in der config.ini):

emil.example.org {
    reverse_proxy 127.0.0.1:8443
}

Nur der FHIR-Server ist nach außen freigegeben

Läuft EMIL im lokalen Netz und ist nur die FHIR-Schnittstelle über einen Reverse Proxy aus dem Internet erreichbar, werden beide Wege korrekt gedrosselt: Lokale Clients und RITA-Tablets werden über ihre LAN-Adresse gezählt, externe FHIR-Clients über X-Forwarded-For. Voraussetzung ist, dass die Proxy-Adresse in TRUSTEDPROXIES steht (bei lokalem Proxy durch die Voreinstellung abgedeckt) und der Proxy X-Forwarded-For weiterreicht.

Hinweis: Mehrere externe Schnittstellen-Clients hinter derselben öffentlichen Adresse zählen gemeinsam. Das ist in der Praxis unkritisch, da ein erfolgreicher Token-Abruf den Zähler sofort zurücksetzt.

JWT-Signaturschlüssel (JWTSALT)

Der Signaturschlüssel für die Sitzungs-Token (JWT) steht in der config.ini im Abschnitt [CONFIG] unter JWTSALT und wird vom Server selbst verwaltet: Beim Serverstart erzeugt er einen neuen Zufallswert (48 Zeichen), wenn der vorhandene zu kurz ist oder am Vortag erzeugt wurde, und vermerkt das Datum unter LASTSALTRENEWAL. Der Wert muss nicht von Hand gesetzt werden und darf nicht weitergegeben werden. Der FHIR-Token-Endpunkt nutzt einen eigenen, in der Datenbank verwalteten Schlüssel.