Sicherheitsmaßnahmen für das WebGIS Portal¶
Dieses Kapitel richtet sich an Administratoren und Betreiber. Es beschreibt, welche Schutzmechanismen
WebGIS eingebaut hat, über welche Schlüssel in api.config, portal.config und settings.config (CMS) sie
angepasst werden und welche Einstellungen für eine Installation im Internet bzw. im Intranet empfohlen sind.
Eine Anleitung zu den ersten Schritten nach der Installation (Standardpasswörter ändern, Selbstregistrierung und
Anmeldung abschalten) steht unter Sicherheitsmaßnahmen (Hardening).
Am Ende des Kapitels gibt die Tabelle Übersicht aller sicherheitsrelevanten Schlüssel einen Überblick über alle sicherheitsrelevanten Schlüssel mit Risikostufe und Empfehlung.
Grundprinzipien¶
Starke, individuelle Passwörter. Standardpasswörter wie
admin123oderwebgisauthorsind besonders anfällig für Brute-Force-Angriffe, bei denen Programme automatisiert Millionen von Passwörtern ausprobieren. Ein Passwort wieadmin123ist in Sekunden geknackt, ein Passwort mit mindestens 12 Zeichen (besser 16+) aus Groß- und Kleinbuchstaben, Zahlen und Sonderzeichen ohne Bezug zu Namen oder Wörterbuchbegriffen benötigt Jahre. Jedes Konto sollte ein eigenes Passwort haben, ein Passwortmanager hilft beim Erzeugen und Speichern. Wo möglich sollte die Zwei-Faktor-Authentifizierung verwendet werden (siehe Zwei-Faktor-Authentifizierung (2FA/TOTP)). Mehr dazu: OWASP Authentication Cheat SheetHTTPS auch im Intranet. Ein Intranet ist nicht automatisch sicher: Mitarbeitergeräte können infiziert sein, Passwörter und Sitzungsinformationen können im Netzwerk mitgelesen oder manipuliert werden und moderne Browser blockieren zunehmend unverschlüsselte Verbindungen. Das WebGIS Portal sollte daher immer über HTTPS betrieben werden. Mehr dazu: Transport Layer Security Cheat Sheet
Administration einschränken. Der Zugriff auf die Administrationsoberflächen (CMS, Subscriber-Anmeldung der API) sollte auf einen bestimmten Personenkreis oder auf das interne Netzwerk beschränkt werden. In öffentlichen Instanzen sollte die Anmeldung ganz abgeschaltet werden (siehe Subscriber-Anmeldung und Subscriber-Datenbank).
Browser-Schutzmechanismen nutzen. Security-Header wie
Strict-Transport-Security (HSTS)undContent-Security-Policy (CSP)werden am Webserver bzw. Reverse Proxy aktiviert.Regelmäßig aktualisieren. Sowohl WebGIS als auch Server, Datenbanken und Drittanbieter-Komponenten.
Anmeldungen überwachen. Wer sich wann angemeldet hat, wird protokolliert. Häufige Fehlanmeldungen oder ungewöhnliche Zugriffe auf die Administration können auf einen Angriff hinweisen.
Angriffsszenarien kennen. Auch Intranet-Anwendungen sind von Man-in-the-Middle-Angriffen, Session Hijacking oder Cross-Site Scripting (XSS) betroffen. Mehr dazu: OWASP Top 10 Security Risks
Bemerkung
Die folgenden Abschnitte beschreiben das Verhalten bei Standardwerten. Die meisten Schutzmechanismen sind standardmäßig aktiv. Einstellungen, die einen Schutz abschwächen, sind in der Tabelle Übersicht aller sicherheitsrelevanten Schlüssel als Kompatibilitäts-Opt-out gekennzeichnet.
Subscriber-Anmeldung und Subscriber-Datenbank¶
Kartenautoren und Administratoren (Subscriber) melden sich über /Subscribers/Login der WebGIS API an.
Subscriber werden in einer Subscriber-Datenbank (SQL-Datenbank oder Dateisystem) gespeichert, die in api.config
und portal.config mit demselben Wert subscriber-db-connectionstring
(api.config, portal.config) angegeben wird.
Der Zugriff auf die Datenbank bzw. das Verzeichnis sollte auf das notwendige Maß beschränkt werden (eigener
Datenbankbenutzer mit minimalen Rechten, Dateisystemrechte nur für den Anwendungsbenutzer).
Passwörter werden mit PBKDF2-SHA256 gehasht; ältere Hashes werden bei der nächsten erfolgreichen Anmeldung automatisch umgestellt. Fehlermeldungen der Anmeldung sind allgemein gehalten und gegen das Erraten von Benutzernamen abgesichert, Anmeldungen werden protokolliert.
Ob die Subscriber-Anmeldung überhaupt zur Verfügung steht, steuern zwei Schlüssel (beide ohne Eintrag: false):
allow-subscriber-login(api.config, portal.config): Ist der Wertfalse, ist keine Anmeldung möglich. In Internet-Instanzen sollte er in beiden Dateienfalsesein, damit auch bei übernommener Konfiguration keine Konfiguration von außen möglich ist. Die Konfiguration erfolgt dann in einer internen Instanz, die sich den Storage teilt.allow-register-new-subscribers(api.config): Erlaubt die Selbstregistrierung neuer Subscriber. Darf nur während der Installation auftruestehen, um den ersten Administrator anzulegen, und nie im Internet. Weitere Konten werden anschließend vom Administrator angelegt.
Für Installationen im Internet ist, wenn eine Anmeldung notwendig ist, die Anmeldung über einen Identity Provider (OpenID Connect) die empfohlene Variante.
Passwortregeln¶
Beim Anlegen oder Ändern eines Passworts gelten (Details):
Mindestlänge
password-min-length(Standard12).Das Passwort darf nicht in einer eingebauten Liste häufiger Passwörter stehen. Optional kann diese Liste mit
password-blocklist-fileerweitert werden (z. B. um Listen kompromittierter Passwörter).Benutzername, Vorname, Nachname und E-Mail-Adresse dürfen nicht enthalten sein; triviale Muster (
aaaaaaaaaaaa,123456789012) werden abgelehnt.Optional kann mit
password-required-character-classes(0-4) eine Anzahl an Zeichenklassen gefordert werden. Standard ist0: eine ausreichende Länge in Kombination mit der Sperrliste ist wirksamer als Kompositionsregeln.Das Standardpasswort
webgisauthorder Erstinstallation kann nicht mehr gesetzt werden; wer sich damit anmeldet, muss es sofort ändern.
Die Regeln gelten nur für neue oder geänderte Passwörter, bestehende Passwörter bleiben gültig. Jeder Subscriber kann sein Passwort auf der Seite Konto selbst ändern.
Zwei-Faktor-Authentifizierung (2FA/TOTP)¶
Subscriber können auf der Seite Konto eine Zwei-Faktor-Authentifizierung mit einer Authenticator-App (TOTP) und
Wiederherstellungscodes einrichten. Der Schlüssel mfa-required (Details) legt fest,
wer sie verwenden muss: none (Standard, optional), admins oder all. Betroffene Subscriber werden bei der nächsten
Anmeldung durch die Einrichtung geführt. mfa-issuer bestimmt den Namen in der Authenticator-App.
Internet: mindestens
admins, besserall.Intranet:
adminsempfohlen.Bei einer SQL-Datenbank muss nach dem Update einmal die Setup-Seite der API ausgeführt werden (Tabelle
webgis_api_subscriber_mfa). Solange die Tabelle fehlt, funktioniert die Anmeldung ohne zweiten Faktor (auch beimfa-required), es wird eine Warnung protokolliert.Basic Authentication und DataLinq verwenden weiterhin nur Benutzername und Passwort.
Die MFA-Schlüssel sind mit dem Crypto-Key der API verschlüsselt. Wird dieser geändert, muss die Zwei-Faktor-Authentifizierung der Subscriber zurückgesetzt werden (Administratoren können das).
Captcha, Sperre und IP-Drosselung¶
Die Anmeldung ist gegen Brute-Force-Angriffe geschützt (Details):
Captcha: Nach
login-captcha-after-failed-attemptsFehlversuchen (Standard3, pro Benutzername oder Client-IP) muss ein Captcha gelöst werden. Jedes Captcha ist einmal verwendbar und nurcaptcha-lifetime-minutes(Standard5) gültig.Sperre pro Benutzername: Nach
login-lockout-after-failed-attemptsFehlversuchen (Standard10,0= keine Sperre) wird der Benutzername vorübergehend gesperrt. Die Dauer steigt gemäßlogin-lockout-minutes(Standard1,5,15, der letzte Wert wird wiederholt). Der Zähler wird nachlogin-failed-attempts-reset-minutes(Standard60) ohne weitere Fehlversuche zurückgesetzt.Drosselung pro Client-IP: Ab
login-ip-max-failed-attemptsFehlversuchen (Standard30,0= aus) innerhalb vonlogin-ip-window-minutes(Standard15) erfordert jede Anmeldung von dieser IP ein Captcha und wird verzögert. Eine harte Sperre einer IP erfolgt bewusst nicht (gemeinsame Adressen, z. B. hinter NAT).Mehrere Instanzen: Die Zähler liegen standardmäßig im Speicher der jeweiligen Instanz. Bei Load Balancing können sie über Redis geteilt werden:
login-throttle-redis-connectionstring.Passwort-Cache: Erfolgreiche Passwortprüfungen bei Basic Authentication und DataLinq werden
password-verification-cache-seconds(Standard300) im Speicher gehalten, weil das Hashen bewusst aufwendig ist.0deaktiviert den Cache.
Wichtig
Die IP-Drosselung setzt voraus, dass die API die echte Client-IP sieht. Hinter einem Reverse Proxy müssen daher die X-Forwarded-Header korrekt konfiguriert sein (siehe Reverse Proxy und Client-IP).
Weiterleitungen nach der Anmeldung¶
Das Weiterleitungsziel der Subscriber-Anmeldung wird geprüft, bevor ein Zugangs-Token angehängt wird (Schutz vor
Open Redirect). Immer erlaubt ist der Host von portal-url; alle anderen Ziele werden mit 400 Bad Request abgelehnt.
Ist das Portal unter einem anderen Hostnamen erreichbar, können diese Hosts mit
subscriber-login-allowed-redirect-hosts (Details) freigegeben werden. Es sollten
nur eigene Hosts eingetragen werden.
Portal-CORS¶
Der hmac-Endpunkt des Portals liefert Zugangsdaten für die API an den angemeldeten Benutzer. Er darf nur von
freigegebenen Seiten per Browser aufgerufen werden, sonst könnte eine Schadseite im Hintergrund Keys für ihre Besucher
abfragen. Alle anderen Seiten des Portals sind standardmäßig nur von Portal und API selbst mit Anmeldung (Cookies) aufrufbar
(Details, ausführlich: CORS und der HMAC-Endpunkt):
add-cors-origins-for-hmac: Drittseiten, die denhmac-Endpunkt aufrufen dürfen (Wert~= alle Seiten, nur zum Testen).add-cors-origins-for-default: zusätzliche Origins, die die übrigen Portal-Seiten mit Anmeldung aufrufen dürfen. Normalerweise ist kein Eintrag notwendig. Wert~= alle Seiten (nur zum Testen, Warnung im Logfile).cors-default-allow-any-origin-without-credentials: Standardfalse. Beitruedürfen fremde Origins öffentliche Portal-Seiten ohne Anmeldung lesen.
Die Wildcard ~ darf in produktiven Umgebungen nicht verwendet werden.
Dynamischer Inhalt (SSRF-Schutz)¶
Der DynamicContentProxy lädt Inhalte (GeoRSS, GeoJSON, API-Abfragen) im Auftrag des Viewers. Damit er nicht für Angriffe
auf interne Systeme missbraucht werden kann (Server-Side Request Forgery), gilt
(Details):
Nur
httpundhttpsohne Benutzerinformation sind erlaubt. Ziele, die auf Loopback, private, Link-Local (z. B. Cloud-Metadaten) oder andere nicht öffentliche Adressen zeigen, werden abgelehnt. Das gilt auch für jeden Redirect. Zertifikate werden geprüft.Der Proxy lädt nur signierte URLs. Die API signiert die URLs beim Laden einer Karte.
allow-hosts: Hostnamen oder Muster, die auch auf interne Adressen zeigen dürfen. Standard leer. Nur konkrete interne Quellen eintragen, keine breiten Muster.allow-unsigned: Standardfalse.truelässt auch nicht signierte URLs zu (nur für Karten, die nicht über die API geladen werden, z. B. MapBuilder-HTML odercustom.js).timeout-seconds(Standard20),max-response-bytes(Standard 50 MB) undmax-redirects(Standard5) begrenzen den Abruf.
Auch die Suchbegriffe der Auswahllisten (VisFilter-Lookups) werden geprüft: term-whitelist in der Section lookup
(Details) legt fest, welche Zeichen erlaubt sind.
Ausgehende TLS-Verbindungen¶
Serverzertifikate bei ausgehenden HTTPS-Verbindungen (Kartendienste, ArcGIS, WMS usw.) werden geprüft. Interne Dienste mit selbstsignierten Zertifikaten oder Zertifikaten einer internen CA sollten über die Installation der CA im Zertifikatsspeicher des Servers angebunden werden. Nur wenn das nicht möglich ist, kann die Prüfung abgeschaltet werden (Man-in-the-Middle-Risiko). Der Schlüssel heißt:
allow-untrusted-server-certificatesin Sectionsecurityderapi.config(Details) und derportal.config(Details),allow_untrusted_server_certificatesin dersettings.configdes CMS (Details).
Standard ist jeweils false. In der Praxis sollte true nur für Legacy-Dienste in vertrauenswürdigen Netzen verwendet werden.
Für das Portal gilt zusätzlich: use-local-url-scheme (portal.config, Details) darf nur
in lokalen oder Offline-Umgebungen true sein, weil der Schlüsselaustausch dann unverschlüsselt über HTTP erfolgt.
Schutz vor CSRF¶
Die Formulare der Subscriber-Verwaltung der API (Anmeldung, Registrierung, Konto, Zwei-Faktor-Authentifizierung) und weitere
schreibende Endpunkte sind durch Anti-Forgery-Token gegen Cross-Site Request Forgery geschützt. Der Schlüssel disable-anti-forgery (Section security der api.config, Details)
schaltet diese Prüfung ab (Standard false). Das ist nur in Sonderfällen sinnvoll, z. B. wenn die API ausschließlich als
Backend für eine andere Anwendung dient oder ein Reverse Proxy die Prüfung verhindert. Im Internet nicht verwenden.
Gesicherte Endpunkte¶
Wartungsendpunkte wie cache/clear sind standardmäßig ohne Anmeldung erreichbar, damit die Wartung (z. B. nach einem
CMS-Deployment) funktioniert. Sobald in Section security der api.config bzw. der portal.config Zugangsdaten
hinterlegt sind, ist der Endpunkt nur noch mit gültigen Credentials erreichbar
(api.config, portal.config):
secure-endpoint-url-password: Passwort, das als Query-Parameterpwdübergeben wird.secure-endpoint-basicauth-usernameundsecure-endpoint-basicauth-password: Zugangsdaten für HTTP Basic Authentication.
In öffentlich zugänglichen Instanzen müssen diese Schlüssel gesetzt werden; im Intranet wird es empfohlen.
Reverse Proxy und Client-IP¶
Läuft die API hinter einem Reverse Proxy, sieht sie standardmäßig die IP-Adresse des Proxies statt jener des Clients. Das beeinträchtigt u. a. die IP-Drosselung der Anmeldung (Details):
use-x-forwarded-headers(Sectionmiddleware): übernimmt die X-Forwarded-Header (Standardfalse). Nur hinter einem Reverse Proxy aktivieren.x-forwarded-known-proxiesundx-forwarded-known-networks: Die Header werden nur von diesen vertrauenswürdigen Proxies (IP-Adressen bzw. Netzwerke in CIDR-Schreibweise) übernommen, standardmäßig nur vonlocalhost. Nur die tatsächlich verwendeten Proxies eintragen, keine breiten Netze.use-x-forwarded-headers-logging: protokolliert die Header (nur zur Fehlersuche).
Security-Bericht¶
Die API enthält eine Seite, die die sicherheitsrelevanten Schlüssel der api.config bewertet: /SecurityReport
(im Subscriber-Admin als Kachel Security-Bericht). Die Seite zeigt je Schlüssel den aktuellen Wert (Geheimnisse und Connection-Strings
nur als gesetzt / nicht gesetzt), den Standardwert, Kategorie und Risiko sowie eine Bewertung für Internet- und
Intranet-Installationen nebeneinander. Die Bewertung entspricht der Tabelle Übersicht aller sicherheitsrelevanten Schlüssel. Unterhalb der Tabelle
werden alle Subscriber mit ihrem 2FA-Status aufgelistet (nur Benutzernamen); Administratoren ohne 2FA sind rot markiert.
Die Seite ist unabhängig vom Subscriber-Login, damit sie auch bei deaktivierter Anmeldung (allow-subscriber-login) verfügbar ist.
Der Zugriff erfolgt wie bei den gesicherten Endpunkten mit den Zugangsdaten
(secure-endpoint-url-password als Parameter pwd, Basic Authentication oder Bearer-Token). Sind keine Zugangsdaten
konfiguriert, ist die Seite nur direkt am Server (localhost, ohne Proxy) erreichbar. Beim Start der API werden die
Abweichungen mit hohem und mittlerem Risiko zusätzlich in das Log (Kategorie WebGIS.Security.Audit) geschrieben.
Übersicht aller sicherheitsrelevanten Schlüssel¶
Kategorien
Kompatibilitäts-Opt-out: Ein Schutz ist standardmäßig aktiv und kann aus Gründen der Abwärtskompatibilität abgeschaltet oder aufgeweicht werden. Die Aktivierung der Ausnahme schwächt die Sicherheit und sollte nur bei Bedarf und mit Kenntnis des Risikos erfolgen.
Feature-Freischaltung: Eine Funktion ist erst nach Aktivierung verfügbar. Die Aktivierung vergrößert die Angriffsfläche.
Feinjustierung: Werte, mit denen ein Schutzmechanismus angepasst wird (Zeiten, Grenzwerte, Zugangsdaten, Listen).
Risikostufen (Auswirkung eines unsicheren Wertes bzw. der Aktivierung der Ausnahme; Standardwerte sind sicher gewählt)
Hoch: Ein Angriff ist direkt möglich oder ein Schutzmechanismus wird vollständig ausgehebelt (z. B. Übernahme von Konten, Zugriff auf interne Systeme, Abhören oder Manipulation des Datenverkehrs).
Mittel: Der Schutz wird spürbar geschwächt; ein Angriff benötigt zusätzliche Voraussetzungen.
Niedrig: Geringe Auswirkung; Defense in Depth.
Info: Keine direkte Auswirkung auf die Sicherheit; Betriebs- oder Hinweisschlüssel.
Die Schlüssel sind als section:key angegeben, wenn sie in einer Section der Konfigurationsdatei stehen (z. B.
security:cookie-secure); der Link führt zur Beschreibung in der jeweiligen Konfigurationsdokumentation. Die
Empfehlungen gelten für Standardinstallationen. Dort, wo nicht anders angegeben, entspricht die Empfehlung dem Standardwert.
Schlüssel |
Datei |
Kategorie |
Risiko |
Empfehlung Internet |
Empfehlung Intranet |
|---|---|---|---|---|---|
api.config |
Feature-Freischaltung |
Hoch |
|
|
|
portal.config |
Feature-Freischaltung |
Hoch |
|
|
|
api.config |
Feature-Freischaltung |
Hoch |
|
Nur während der Installation |
|
api.config |
Feinjustierung |
Info |
Zugriff auf Datenbank bzw. Verzeichnis einschränken; Wert in api.config und portal.config identisch |
Wie Internet |
|
portal.config |
Feinjustierung |
Info |
Wie in api.config |
Wie in api.config |
|
api.config |
Feinjustierung |
Mittel |
Leer lassen oder nur eigene Hosts eintragen |
Wie Internet |
|
api.config |
Feinjustierung |
Mittel |
|
|
|
api.config |
Feinjustierung |
Mittel |
|
|
|
api.config |
Feinjustierung |
Niedrig |
|
Optional |
|
api.config |
Feinjustierung |
Mittel |
|
|
|
api.config |
Feinjustierung |
Niedrig |
|
|
|
api.config |
Feinjustierung |
Niedrig |
Empfohlen: Liste kompromittierter Passwörter |
Optional |
|
api.config |
Feinjustierung |
Mittel |
|
|
|
api.config |
Feinjustierung |
Mittel |
|
|
|
api.config |
Feinjustierung |
Niedrig |
|
|
|
api.config |
Feinjustierung |
Niedrig |
|
|
|
api.config |
Feinjustierung |
Niedrig |
|
|
|
api.config |
Feinjustierung |
Niedrig |
|
|
|
api.config |
Feinjustierung |
Niedrig |
Bei mehreren Instanzen (Load Balancing) setzen |
Nur bei mehreren Instanzen |
|
api.config |
Feinjustierung |
Niedrig |
|
|
|
api.config |
Feinjustierung |
Niedrig |
|
|
|
api.config |
Feinjustierung |
Mittel |
|
|
|
api.config |
Feinjustierung |
Info |
Name in der Authenticator-App |
Name in der Authenticator-App |
|
api.config |
Kompatibilitäts-Opt-out |
Hoch |
|
|
|
portal.config |
Kompatibilitäts-Opt-out |
Hoch |
|
|
|
settings.config (CMS) |
Kompatibilitäts-Opt-out |
Hoch |
|
|
|
api.config |
Kompatibilitäts-Opt-out |
Hoch |
|
|
|
api.config |
Feinjustierung |
Mittel |
Setzen (starkes Passwort) |
Setzen empfohlen |
|
api.config |
Feinjustierung |
Mittel |
Setzen (gemeinsam mit dem Passwort) |
Setzen empfohlen |
|
api.config |
Feinjustierung |
Mittel |
Setzen (starkes Passwort) |
Setzen empfohlen |
|
portal.config |
Feinjustierung |
Mittel |
Setzen (starkes Passwort) |
Setzen empfohlen |
|
portal.config |
Feinjustierung |
Mittel |
Setzen (gemeinsam mit dem Passwort) |
Setzen empfohlen |
|
portal.config |
Feinjustierung |
Mittel |
Setzen (starkes Passwort) |
Setzen empfohlen |
|
portal.config |
Kompatibilitäts-Opt-out |
Hoch |
|
|
|
api.config |
Kompatibilitäts-Opt-out |
Hoch |
Leer (nur öffentliche Ziele) |
Nur konkrete interne Hostnamen, keine breiten Muster |
|
api.config |
Kompatibilitäts-Opt-out |
Hoch |
|
|
|
api.config |
Feinjustierung |
Niedrig |
|
|
|
api.config |
Feinjustierung |
Niedrig |
|
|
|
api.config |
Feinjustierung |
Niedrig |
|
|
|
api.config |
Feinjustierung |
Mittel |
Standard; nur um tatsächlich benötigte Zeichen erweitern |
Standard |
|
portal.config |
Feinjustierung |
Hoch |
Nur benötigte Drittseiten; nie |
Nur benötigte Drittseiten; nie |
|
portal.config |
Feinjustierung |
Hoch |
Leer; nie |
Leer; nie |
|
portal.config |
Kompatibilitäts-Opt-out |
Niedrig |
|
|
|
api.config |
Feinjustierung |
Mittel |
|
|
|
api.config |
Feinjustierung |
Mittel |
Nur die tatsächlich verwendeten Proxies |
Nur die tatsächlich verwendeten Proxies |
|
api.config |
Feinjustierung |
Mittel |
Nur die Netze der verwendeten Proxies (CIDR), keine breiten Netze |
Nur die Netze der verwendeten Proxies (CIDR), keine breiten Netze |
|
api.config |
Feinjustierung |
Info |
|
|