Lernseite · Sicherheit
Sicherheit in TYPO3-Projekten beraten und umsetzen
Sicherheit ist kein Zustand, sondern ein Prozess. Als Beraterin oder Berater härtest du keine Server selbst. Du musst aber wissen, was zu tun ist, wer es tut und wie du einem Kunden eine Sicherheitsmeldung erklärst. Auf dieser Seite entsteht dafür ein Sicherheitskonzept, bis hin zum Ernstfall.
Das Beispiel: Ferienregion Seetal
Unser Kunde ist der Tourismusverband Ferienregion Seetal. Zwölf Redakteurinnen und Redakteure pflegen die Website. Gastgeber haben einen Bereich mit Login, und ein Kartenwidget und ein Buchungspartner binden fremde Dienste ein. Unsere Agentur betreut das Projekt.
Zuerst klären wir, was geschützt werden soll. Dafür gibt es die CIA-Triade mit drei Schutzzielen:
- Vertraulichkeit (Confidentiality): Nur Berechtigte sehen die Daten, etwa die Adressen der Gastgeber.
- Integrität (Integrity): Daten bleiben unverfälscht, etwa die Preise.
- Verfügbarkeit (Availability): Die Website ist erreichbar, gerade in der Buchungssaison.
Eine Lücke, die nur Daten offenlegt, trifft vor allem die Vertraulichkeit. Diese Sicht hilft später beim Lesen von Sicherheitsmeldungen.
Wie Angreifer vorgehen
Die meisten Angriffe folgen wenigen Mustern:
- Cross-Site-Scripting, kurz XSS: Fremder Skriptcode gelangt über eine ungefilterte Eingabe in eine Seite, etwa über ein Kommentarfeld. Er läuft dann im Browser anderer Besucher und liest zum Beispiel Cookies aus.
- SQL-Injection: Eine manipulierte Eingabe verändert die Datenbankabfrage. So liest ein Angreifer fremde Daten oder legt sich einen Administrator an.
- Ausführung beliebigen Codes (Arbitrary oder Remote Code Execution): Der Angreifer führt eigenen Code auf dem Server aus, oft über unsichere Uploads, Code-Injection oder Deserialisierung. Das kann die volle Kontrolle über die Installation bedeuten.
- Cross-Site Request Forgery, kurz CSRF: Ein angemeldeter Benutzer wird auf eine präparierte Seite gelockt. Sein Browser führt dann unbemerkt eine Aktion mit seinen Rechten aus. Dagegen setzt TYPO3 im Backend geheime Tokens in Formulare und Links.
- Informationspreisgabe: Fehlermeldungen oder Debug-Ausgaben verraten Interna.
So beugen Entwickler vor: Gegen XSS maskieren sie jede Ausgabe passend zum Kontext. Für HTML erledigt Fluid das automatisch. Gegen SQL-Injection nutzen sie vorbereitete Abfragen mit Parametern, sogenannte Prepared Statements. Die Doctrine-basierte Datenbank-API von TYPO3 arbeitet so, etwa mit createNamedParameter(). Gegen Codeausführung beschränken sie Uploads. Das fileDenyPattern verhindert zum Beispiel das Hochladen von PHP-Dateien. Eine Firewall kann ergänzen, ersetzt aber keinen sicheren Code.
Mehr lernst du beim OWASP, dem Open Web Application Security Project, und im Kapitel „Security guidelines“ von „TYPO3 Explained“. Es enthält Empfehlungen für Administratoren, Integratoren, Entwickler und Redakteure.
Die Installation härten
Härten heißt, die Angriffsfläche klein zu machen. Für Seetal stehen diese Bausteine im Konzept:
- Updates von TYPO3 und allen Extensions sind die wichtigste Maßnahme. Nach einer Sicherheitsmeldung kann jeder alten und neuen Code vergleichen und so die Lücke finden. Angreifer suchen automatisiert nach Systemen mit bekannten Schwachstellen. Ein Patch-Release wie von 14.3.6 auf 14.3.7 ist meist unkompliziert.
- HTTPS für Frontend und Backend: TLS verschlüsselt die Verbindung. Zugangsdaten und Formulardaten kann niemand mitlesen oder verändern, und das Zertifikat bestätigt die Identität der Website. Die Datenbank verschlüsselt HTTPS aber nicht.
- MFA für Backend-Benutzer, mindestens für Administratoren.
- Wenig Angriffsfläche: Nicht benötigte Extensions werden entfernt.
- Serverzugriff nur über verschlüsselte Protokolle wie SFTP oder SSH.
- Keine Interna nach außen:
displayErrorsbleibt im Produktivsystem restriktiv. DiedevIPmasknennt nur Entwickler-Adressen, denn ein Sternchen würde Debug-Ausgaben allen zeigen.
Das Install Tool lässt sich ohne Backend-Konto aufrufen und ist deshalb doppelt geschützt. Die Datei ENABLE_INSTALL_TOOL muss existieren, und man braucht ein eigenes Install-Tool-Passwort, unabhängig von allen Backend-Passwörtern. Die Datei soll nicht dauerhaft liegen bleiben. TYPO3 entfernt sie nach einer Stunde ohne Nutzung selbst. Nur wenn sie den Text KEEP_FILE enthält, bleibt sie liegen, und der Statusbericht warnt davor.
Die System-Module wie Settings und Maintenance sind besonders mächtig. Im Kontext „Production“ dürfen nur Administratoren hinein, die als System Maintainer eingetragen sind. Vorher geben sie ihr Passwort oder das Install-Tool-Passwort erneut ein, den sogenannten Sudo-Modus. Im Kontext „Development“ dürfen alle Administratoren ohne Zusatzschritt hinein.
TypoScript bleibt Admin-Sache. Aus TypoScript heraus lässt sich PHP-Code aufrufen. Wer Templates bearbeiten darf, könnte also beliebigen Code ausführen und sich ein Admin-Konto anlegen. Deshalb gibt es keine Stufe zwischen Redakteur und Administrator, die TypoScript ändern darf.
Auch TypoScript selbst kann eine SQL-Injection enthalten. Das passiert, wenn das Objekt CONTENT Datensätze abfragt und ein Wert aus der URL direkt in der where-Bedingung landet. Richtig ist ein Marker: TYPO3 setzt den Wert dann maskiert und in Anführungszeichen ein. Grundsatz: Daten aus fremder Quelle nie ungeprüft verwenden.
page.10 = CONTENT
page.10 {
table = tt_content
select {
pidInList = 123
where = uid=###CONTENTID###
markers {
CONTENTID.data = GP:fooid
}
}
}Hinschauen: Statusbericht, Logs und Warnmails
In jede Wartungsroutine gehören zwei Module unter Administration. Reports enthält den Statusbericht. Sein Abschnitt Sicherheit weist etwa auf eine unverschlüsselte Verbindung, das trustedHostsPattern, das fileDenyPattern und ein freigeschaltetes Install Tool hin. Log führt Anmeldungen, Abmeldungen, fehlgeschlagene Logins und Fehler.
Für die Analyse eines Angriffs kommen weitere Quellen dazu. TYPO3 schreibt über seine Logging-API Dateien in das Verzeichnis var/log. Dazu kommen die Zugriffs- und Fehlerlogs des Webservers und Logs von SSH, FTP und Datenbank. Bei einem kompromittierten System können aber auch diese Anzeigen manipuliert sein.
Gesperrte Anmeldung: Im Backend erlaubt TYPO3 standardmäßig fünf Fehlversuche innerhalb von 15 Minuten. Danach meldet es, dass der Login bis zu einem bestimmten Zeitpunkt gesperrt ist. Die Einstellungen heißen loginRateLimit und loginRateLimitInterval. Für das Frontend gilt ein eigenes Limit, ab Werk zehn Fehlversuche in 15 Minuten.
Warnmails: Die Adresse in warning_email_addr erfährt von jedem Anmeldeversuch im Install Tool. Außerdem bekommt sie eine Mail, wenn es innerhalb einer Stunde mehr als drei fehlgeschlagene Backend-Logins gab. Falsche MFA-Codes zählen dabei mit. Seit TYPO3 14 bekommt zusätzlich der Benutzer selbst eine Mail, wenn bei seinem Konto ein MFA-Code falsch war. Mit warning_mode kommt zusätzlich eine Mail bei jedem Login oder bei jedem Admin-Login. Ab Werk ist die Adresse leer.
Passwörter und Mehr-Faktor-Anmeldung
Sichere Passwörter sind lang und mischen Groß- und Kleinbuchstaben, Zahlen und Sonderzeichen. Die TYPO3-Richtlinien nennen mindestens acht Zeichen, ohne persönliche Angaben und ohne Wörter aus dem Wörterbuch. Jedes Konto bekommt ein eigenes Passwort. Wird ein Dienst gehackt, probieren Angreifer die Zugangsdaten nämlich bei anderen Diensten aus. Ein Passwortmanager hilft dabei. TYPO3 erzwingt solche Regeln über Passwortrichtlinien. Die Standardrichtlinie verlangt mindestens acht Zeichen mit Groß- und Kleinbuchstaben, einer Zahl und einem Sonderzeichen.
Multi-Faktor-Authentifizierung, kurz MFA, verlangt nach dem Passwort einen zweiten Nachweis. Der Core bringt zwei Anbieter mit:
- TOTP, das zeitbasierte Einmalpasswort: Eine Authenticator-App erzeugt alle 30 Sekunden einen neuen sechsstelligen Code. Nach drei falschen Codes in Folge sperrt TYPO3 diesen Anbieter.
- Recovery-Codes als Rückfall, falls das Smartphone fehlt. Sie lassen sich nur aktivieren, wenn schon ein anderer Anbieter aktiv ist. Man bewahrt sie getrennt vom Gerät auf.
Weitere Anbieter wie WebAuthn oder FIDO2, YubiKey, HOTP oder E-Mail kommen über Extensions. Einen WebAuthn-Anbieter enthält der Core nicht.
- Der Redakteur öffnet seine User Settings und wählt den Tab „Account security“.
- Für TOTP scannt er den QR-Code mit seiner Authenticator-App oder tippt das geteilte Geheimnis ein.
- Er bestätigt mit dem ersten Code aus der App.
- Dann aktiviert er die Recovery-Codes und legt sie sicher ab.
MFA erzwingen kannst du mit der globalen Einstellung requireMfa. Der Wert 0 heißt keine Pflicht und ist der Standard. 1 verlangt MFA von allen, 2 nur von Benutzern, die keine Administratoren sind, 3 nur von Administratoren und 4 nur von System Maintainern. Wer verpflichtet ist und noch keinen Anbieter hat, landet nach dem Login direkt in der Einrichtung.
Feiner steuerst du MFA im User TSconfig für einzelne Benutzer oder Gruppen. Mit auth.mfa.required verlangst du MFA zusätzlich. Dieser Wert hat Vorrang vor der globalen Einstellung. Mit auth.mfa.disableProviders nimmst du Anbieter aus der Auswahl. Mit auth.mfa.recommendedProvider empfiehlst du einen Anbieter.
auth.mfa.disableProviders := addToList(totp)Smartphone verloren, keine Recovery-Codes: „Passwort vergessen“ hilft hier nicht. Ein Administrator deaktiviert im Benutzerdatensatz, Feld „Multi-factor authentication“, MFA insgesamt oder den gesperrten Anbieter. Das lässt sich nicht rückgängig machen. Danach richtet der Redakteur MFA neu ein.
Zentrale Anmeldung und eigene Backend-Adresse
Single Sign-On, kurz SSO, heißt: Benutzer melden sich einmal zentral an, etwa mit dem Firmenkonto, und sind dann auch in TYPO3 angemeldet. Der Core bringt eine erweiterbare Authentifizierungs-API mit. Die Anbindung an LDAP oder einen SSO-Dienst liefert eine Extension, etwa ig_ldap_sso_auth. Die Vorteile: Konten an einer Stelle, zentrale Richtlinien wie MFA, und wer ausscheidet, wird sofort überall gesperrt. Ein gemeinsames Konto für alle Redakteure widerspricht dagegen allen Sicherheitsempfehlungen.
Die Backend-Adresse ist ab Werk /typo3. Seit TYPO3 13 änderst du sie mit der Einstellung entryPoint, auf einen Pfad wie /redaktion oder eine eigene Domain. Du stellst sie im Modul Settings unter System ein, im Bereich „Configure Installation-Wide Options“, oder in settings.php oder additional.php. Seit TYPO3 14 folgt auch das Install Tool diesem Einstiegspunkt.
$GLOBALS['TYPO3_CONF_VARS']['BE']['entryPoint'] = 'https://redaktion.example.org';
$GLOBALS['TYPO3_CONF_VARS']['SYS']['cookieDomain'] = '.example.org';Die zweite Zeile ist bei einer eigenen Subdomain nötig. Sonst gilt das Backend-Cookie nur für die Redaktions-Domain, und das Frontend erkennt den angemeldeten Redakteur nicht. Vorschau und Admin Panel funktionieren dann nicht.
Zu einer ehrlichen Beratung gehört:
- Eine eigene Adresse ist leicht zu merken und erschwert automatisierte Suchen nach dem Login.
- Sie ist aber Security by Obscurity und ersetzt weder MFA noch Updates.
- Nur das Routing ändert sich. Assets kommen weiter von den bisherigen Pfaden, etwa
_assets. - Eine eigene Webserver-Konfiguration muss man gegebenenfalls anpassen.
Content Security Policy
Eine Content Security Policy, kurz CSP, ist ein HTTP-Header mit Regeln, aus welchen Quellen Skripte, Bilder, Frames und andere Ressourcen kommen dürfen. Alles andere blockiert der Browser und meldet den Verstoß. Das mindert die Folgen von XSS, ersetzt aber sicheres Programmieren nicht.
TYPO3 bringt eine CSP-API für Frontend und Backend mit. Für das Frontend aktivierst du sie über die Feature-Flags zum Erzwingen oder Melden, oder je Site in der csp.yaml der Site-Konfiguration mit der Disposition „enforce“ oder „report“. Im Modus Report-Only sendet die Website den Header Content-Security-Policy-Report-Only. Verstöße werden dann nur gemeldet, nicht blockiert. TYPO3 empfängt die Berichte und zeigt sie im Modul „Content Security Policy“ unter System.
Dateien in fileadmin: Redakteure laden SVG- oder HTML-Dateien hoch, die Skriptcode enthalten können. Diese Dateien liefert der Webserver direkt aus, ohne TYPO3. Die CSP von TYPO3 wirkt dort also nicht. Die Dokumentation empfiehlt deshalb einen strengen Header des Webservers für öffentliche Speicherordner, etwa in einer .htaccess in fileadmin. Für NGINX gibt es ein Beispiel.
Content-Security-Policy: default-src 'self'; script-src 'none'; style-src 'none'; object-src 'none'Das Security Team und der Meldeweg
Das TYPO3 Security Team kümmert sich um Lücken im Core und in Extensions. Eine Lücke meldest du nur vertraulich per E-Mail an security@typo3.org, auch bei eigenen Extensions. Öffentlich gehört sie nirgendwohin, also nicht in Forge, Foren, Slack oder soziale Netzwerke. So bleibt Zeit für einen Fix, bevor Angreifer die Lücke kennen. Das heißt Responsible Disclosure.
Eine gute Meldung beschreibt die Schwachstelle genau und nennt betroffene Versionen, Schritte zum Nachvollziehen und Auswirkungen. Fremde Zugangsdaten gehören nie hinein. Das Team versucht, innerhalb von zwei Werktagen zu antworten. Wer sich übersehen fühlt, schickt nach einigen Tagen eine Erinnerung.
Das Team schreibt den Fix für eine Extension nicht selbst. Die Regeln gelten auch für eigene Extensions.
Zwei Dinge macht das Team bewusst nicht. Es prüft keine einzelnen Extensions oder Projekte auf Anfrage, auch nicht gegen Geld. Für Audits verweist die Dokumentation auf erfahrene Agenturen, etwa TYPO3 Solution Partner, deren Qualifikation man trotzdem prüft. Und Lücken im Core, die nur mit Administratorrechten ausnutzbar sind, etwa über das Install Tool, gelten als normale Fehler. Ihr Fix läuft öffentlich im Core-Review, ohne eigenes Bulletin. Auch deshalb vergibt man Admin-Konten sparsam.
Sicherheitsmeldungen lesen und bewerten
Security Bulletins stehen auf typo3.org im Bereich Security. Angekündigt werden sie über die nur lesbare Mailingliste „TYPO3 Announce“, die jeder TYPO3-Betreuer abonnieren sollte. Jede Meldung hat eine Kennung:
- TYPO3-CORE-SA mit Jahr und laufender Nummer betrifft den Core. TYPO3-CORE-SA-2026-012 ist die zwölfte Core-Meldung aus 2026.
- TYPO3-EXT-SA mit Jahr und Nummer betrifft Extensions.
- TYPO3-PSA ist ein Public Service Announcement, ein Sicherheitshinweis ohne Software-Release. Er betrifft etwa Apache, NGINX, MySQL oder PHP, Fehlkonfigurationen oder die Infrastruktur von typo3.org und nennt Wege zur Abhilfe.
Ein Bulletin nennt betroffene und korrigierte Versionen, die Art der Schwachstelle und eine CVSS-Bewertung. Eine Anleitung zum Ausnutzen enthält es nie. Bei kritischen Lücken kündigt das Team Datum und Uhrzeit eines Bulletins manchmal vorab über „TYPO3 Announce“ an. So können Administratoren das Update einplanen, ohne dass Details vorher bekannt werden.
Drei Abkürzungen solltest du auseinanderhalten:
- CVSS, das Common Vulnerability Scoring System, bewertet den Schweregrad mit Punkten von 0 bis 10 und einem Vektor. Dazu gehört, wie stark Vertraulichkeit, Integrität und Verfügbarkeit betroffen sind. Das Security Team veröffentlicht seit 2010 zu jedem Bulletin eine CVSS-Bewertung. Werte ab 9,0 gelten als kritisch.
- CVE, Common Vulnerabilities and Exposures, kennzeichnet eine konkrete Lücke in einem Produkt.
- CWE, die Common Weakness Enumeration, katalogisiert Arten von Schwachstellen, etwa CWE-79 für XSS und CWE-89 für SQL-Injection.
Der Ernstfall: Die Website ist gehackt
Eines Morgens zeigt die Startseite von Seetal fremde Werbelinks. Typische Anzeichen eines Angriffs sind Inhalte oder Weiterleitungen, die niemand aus der Redaktion angelegt hat. Dazu kommen fremder Code im HTML, unbekannte Dateien, ungewöhnlicher Traffic, Warnungen von Suchmaschinen oder Browsern und Meldungen von Besuchern.
Ein Blick auf die Startseite reicht nicht. Viele Angriffe zeigen manipulierte Inhalte nur bestimmten IP-Adressen, Browsern, Suchmaschinen oder zu bestimmten Zeiten. Deshalb prüft man Dateien, Datenbank, Serverkonfiguration wie die .htaccess und Logs.
- Website oder Server vom Netz nehmen. Solange die Lücke offen ist, richtet der Angreifer weiter Schaden an.
- Server und Logdateien sichern, etwa von Apache, SSH, FTP, MySQL und dem System. Logs werden nie gelöscht.
- Das Einfallstor finden. Ohne Analyse bleibt die Lücke offen, und der Angriff wiederholt sich.
- Bereinigen oder ein Backup aus der Zeit vor dem Angriff einspielen. Dann die Lücke schließen.
- Wieder online gehen und das System unter besondere Beobachtung stellen.
Angreifer hinterlassen oft Hintertüren, etwa unauffällige neue Backend-Benutzer oder versteckte PHP-Dateien. Deshalb prüft man Benutzer und Dateien, ändert alle Passwörter und Zugangsdaten und überwacht das System in den folgenden Monaten eng.
Personenbezogene Daten: Wurden möglicherweise Namen und E-Mail-Adressen aus einem Formular abgegriffen, ist das eine Datenschutzverletzung. Nach Artikel 33 der DSGVO meldet der Verantwortliche sie in der Regel binnen 72 Stunden der Aufsichtsbehörde, außer es besteht voraussichtlich kein Risiko für die Betroffenen. Bei hohem Risiko benachrichtigt er nach Artikel 34 auch die Betroffenen. Das gilt nicht nur für Kreditkartendaten, und das Security Team meldet nichts für den Kunden. Verantwortlich ist hier der Tourismusverband, oft beraten von seinem Datenschutzbeauftragten. Mehr dazu im Kurs „Recht, Datenschutz und KI“.
Das Wichtigste in Kürze
- Die CIA-Triade: Vertraulichkeit, Integrität, Verfügbarkeit.
- Fluid-Escaping hilft gegen XSS, Prepared Statements und TypoScript-Marker gegen SQL-Injection, beschränkte Uploads gegen Codeausführung.
- Updates, HTTPS, MFA, wenige Extensions und SFTP oder SSH sind die Basis jeder Härtung.
- Das Install Tool braucht
ENABLE_INSTALL_TOOLund ein eigenes Passwort. System-Module verlangen im Produktivsystem System Maintainer und Sudo-Modus. - Das Backend sperrt nach fünf Fehlversuchen in 15 Minuten. Die Warnadresse meldet Install-Tool-Logins und mehr als drei Fehlversuche je Stunde.
- Der Core bringt TOTP und Recovery-Codes mit.
requireMfaund das User TSconfig steuern die Pflicht. - Eine eigene Backend-Adresse ist Security by Obscurity. Bei eigener Subdomain braucht es die
cookieDomain. - Eine CSP führst du mit Report-Only ein. Für fileadmin setzt der Webserver einen strengen Header.
- Lücken gehen vertraulich an security@typo3.org, Bulletins kommen über „TYPO3 Announce“.
- Nach einem Hack: offline, sichern, analysieren, bereinigen, überwachen und an die 72 Stunden denken.
Begriffe
- CIA-Triade
- Die Schutzziele Vertraulichkeit, Integrität und Verfügbarkeit.
- XSS
- Eingeschleuster Skriptcode, der im Browser anderer Besucher läuft.
- CSRF
- Untergeschobene Aktion, die ein angemeldeter Benutzer unbemerkt mit seinen Rechten ausführt.
- System Maintainer
- Administrator mit Zugriff auf die System-Module.
- Sudo-Modus
- Erneute Passwortabfrage vor besonders mächtigen Modulen.
- TOTP
- Zeitbasiertes Einmalpasswort aus einer Authenticator-App.
- SSO
- Single Sign-On, einmal zentral anmelden und überall angemeldet sein.
- CSP
- Header mit den erlaubten Quellen für Skripte und andere Ressourcen.
- PSA
- Public Service Announcement, Sicherheitshinweis ohne Software-Release.
- CVSS
- Schweregrad einer Lücke von 0 bis 10.
- CVE
- Kennung einer konkreten Lücke.
- CWE
- Katalog der Arten von Schwachstellen.