Lernseite · Sichere Entwicklung
Sicher entwickeln mit TYPO3: Eingaben, Angriffe und Zugriff
Sicherheit entsteht nicht durch ein Werkzeug, sondern durch Gewohnheiten beim Programmieren. Auf dieser Seite klärst du drei Fragen: Wie gehst du mit Daten von außen um? Welche Angriffe gibt es, und was hilft? Und wer darf was?
Jede Eingabe ist verdächtig
Unser Beispiel ist die Extension my_extension für Konferenzen. Sie hat ein Anmeldeformular, eine Vortragssuche, Sprecherprofile mit eigener Biografie, einen Download der Folien und einen Import aus einer fremden REST-API.
Überall dort kommen Daten von außen herein. Dafür gilt: Jede Eingabe ist verdächtig.
- GET-Parameter und POST-Daten wählt der Besucher frei.
- Versteckte Formularfelder ändert er in den Entwicklerwerkzeugen des Browsers.
- Cookies und HTTP-Header wie User-Agent oder Referer lassen sich fälschen.
- Antworten fremder Schnittstellen behandelst du genauso, denn auch ein fremdes System kann gehackt sein.
Nur Konstanten im eigenen PHP-Code sind keine Eingabe. HTTPS ändert daran nichts, es schützt nur die Übertragung.
Eingaben abrufen: In TYPO3 liest du Daten über das PSR-7-Request-Objekt, nicht über Superglobals. Das macht den Code auch testbar. In Extbase kommen die Werte als Parameter der Action an.
$term = $request->getQueryParams()['term'] ?? '';
$data = $request->getParsedBody();Prüfen im Browser reicht nicht. Das HTML-Attribut required und JavaScript sind nur Komfort. Ein Angreifer schickt die Anfrage einfach mit curl direkt an den Server. Verbindlich prüfst du immer auf dem Server.
Validieren und Bereinigen
- Validierung prüft, ob eine Eingabe dem erwarteten Format und den Regeln entspricht. Wenn nicht, weist sie die Eingabe zurück.
- Bereinigung, englisch Sanitizing, verändert die Eingabe, bis sie für einen Zweck harmlos ist.
Allowlist statt Denylist: Darf ein Sortierparameter nur title oder date sein, vergleichst du ihn mit genau dieser Liste. Eine Liste verbotener Zeichen übersieht immer einen Trick.
Zahlen: Ein Cast mit int liest die führenden Ziffern. Aus „5 OR 1=1“ wird die Zahl 5, der SQL-Teil fällt weg. Ein Text ohne Ziffer am Anfang ergibt 0, einen TypeError gibt es nicht. Soll eine Zahl in einem Bereich liegen, validierst du lieber.
$count = filter_var($params['count'] ?? null, FILTER_VALIDATE_INT,
['options' => ['min_range' => 1, 'max_range' => 100]]);
if ($count === false) {
return new JsonResponse(['error' => 'invalid count'], 400);
}Die Funktion is_numeric() wäre zu großzügig, sie lässt auch 1e5 oder 2,5 durch.
Validierung in TYPO3: In Extbase setzt du Validatoren mit dem Attribut Validate an Properties und Argumente. Das Form Framework bringt Validatoren wie EmailAddress oder StringLength mit. Im Backend prüft das TCA, etwa mit dem Typ email oder mit eval. GET-Werte validiert der Core nicht von selbst.
XSS und SQL-Injection
Bei Cross-Site-Scripting, kurz XSS, gelangt Code ungefiltert in die Ausgabe und läuft im Browser anderer Besucher. Ein Sprecher schreibt ein Skript in seine Biografie, und jeder Besucher seines Profils führt es aus.
Das Gegenmittel ist Maskieren bei der Ausgabe, englisch Escaping. Die Funktion htmlspecialchars() wandelt spitze Klammern, das kaufmännische Und und Anführungszeichen in HTML-Entities um. Dann erscheint ein Skript-Tag als Text. Fluid maskiert jede Variable automatisch so. Der ViewHelper f:format.raw schaltet das ab, für Benutzereingaben nie.
Bei SQL-Injection wird eine Eingabe als Teil eines SQL-Befehls ausgeführt. Das Gegenmittel sind Prepared Statements: Abfrage und Werte bleiben getrennt. Im QueryBuilder übergibst du jeden Wert mit createNamedParameter(), auch Zahlen.
Jede Lücke hat ihr eigenes Gegenmittel:
- Gegen SQL-Injection helfen Named Parameter.
- Gegen XSS hilft Maskieren passend zum Ausgabekontext.
- Gegen Cross-Site Request Forgery helfen Tokens, die an die Sitzung gebunden sind.
- Gegen Codeausführung oder Path Traversal hilft weder Maskieren noch eine Content Security Policy.
Mehr lernst du bei OWASP. Die OWASP Top 10 fassen die häufigsten Risiken zusammen. Dazu kommen die OWASP Cheat Sheets, die Security Guidelines in TYPO3 Explained und die Security Advisories auf typo3.org.
Angriffe auf den Server
Bei der Ausführung beliebigen Codes, englisch Arbitrary Code Execution, bringt ein Angreifer eigenen Code auf dem Server zum Laufen. Dann kann er alles, was der Webserver darf. Gefährlich sind diese Stellen, wenn Eingaben sie erreichen:
- Die Funktion
eval()führt Text als PHP aus. - Ein include oder require mit einem Pfad aus der Anfrage lädt beliebige Dateien.
- Die Funktion
unserialize()kann Objekte mit Magic Methods erzeugen.json_decode()liefert dagegen nur Arrays und einfache Werte. - Hochgeladene PHP-Dateien führt der Webserver womöglich aus.
Gegen solche Uploads hat TYPO3 das fileDenyPattern, einen regulären Ausdruck. Passt ein Dateiname darauf, verweigert TYPO3 Upload und Umbenennen. Der Standard sperrt PHP-Endungen, auch mit einer weiteren Endung dahinter wie bei bild.php.jpg. Gesperrt ist auch die Datei .htaccess. PDF und SVG sind erlaubt.
Path Traversal: Der Folien-Download nimmt einen Dateinamen aus der URL. Ein Angreifer verlässt mit zwei Punkten und einem Schrägstrich den Ordner.
?file=../../config/system/settings.phpSo schützt du dich:
- Übergib statt eines Pfads die UID einer FAL-Datei und prüfe ihre Freigabe.
- Prüfe Dateinamen gegen eine Allowlist oder kürze sie mit
basename()auf den Namen. - Löse Pfade mit
realpath()auf und prüfe, ob sie im erlaubten Ordner liegen.
Wer die Zeichenfolge nur einmal mit str_replace() entfernt, wird mit vier Punkten und zwei Schrägstrichen ausgetrickst. URL-kodierte Varianten umgehen einfache Filter auch. Die Lücke betrifft jedes Betriebssystem, nicht nur Windows.
Preisgabe von Informationen, englisch Information Disclosure, erleichtert gezielte Angriffe. Beispiele sind Stack-Traces mit Pfaden im Live-Betrieb, ein erreichbares Verzeichnis .git, Backups im Webroot und eine Seite mit phpinfo().
- Setze im Live-System die Einstellung
displayErrorsim Bereich SYS auf 0. - Lass
devIPmaskleer. Sie nennt die IP-Adressen, die Debug-Ausgaben sehen. Ein Stern zeigt sie jedem. - Mach in einer Composer-Installation nur den Ordner
publiczum Document Root. Dann bleiben config, var und vendor mit Zugangsdaten, Logs und Bibliotheken unerreichbar.
Geheimnisse wie einen API-Schlüssel legst du in eine Umgebungsvariable oder eine Datei außerhalb des Git-Repositorys. Was im Repository stand, bleibt in der Historie. Im Frontend-JavaScript liest ihn jeder Besucher.
Logs sind oft schlechter geschützt als die Datenbank. Eingegebene Passwörter gehören nie hinein, auch nicht teilweise. Session-IDs und Tokens gehören nicht im Klartext hinein. Benutzername, Uhrzeit und Grund dürfen hinein.
Fremde Anfragen und manipulierte Links
Bei Cross-Site Request Forgery, kurz CSRF, bringt eine fremde Seite den Browser eines angemeldeten Benutzers dazu, ungewollt eine Aktion auszuführen. Der Browser schickt das Session-Cookie automatisch mit. Anders als bei XSS braucht der Angreifer kein Skript auf deiner Seite.
POST allein hilft nicht, denn auch eine fremde Seite sendet Formulare per POST. Den Referer kann man unterdrücken, und die UID des Benutzers ist kein Geheimnis. Was hilft, ist ein Token, der an die Sitzung gebunden ist. Im Backend erzeugt ihn die FormProtection.
$formProtection = $this->formProtectionFactory->createFromRequest($request);
$token = $formProtection->generateToken('myext', 'delete');
$valid = $formProtection->validateToken($submittedToken, 'myext', 'delete');Im Frontend schützt TYPO3 Formulare wie den Login mit einem Request-Token. Die RequestTokenMiddleware prüft ihn zusammen mit einem Nonce-Cookie. Solche Tokens gelten für POST, PUT und PATCH, nicht für GET.
Extbase-Formulare enthalten das versteckte Feld __trustedProperties. Es nennt die erlaubten Felder und ist mit einem HMAC signiert. So kann niemand zusätzliche Properties einschleusen. Gegen CSRF hilft es nicht. Laut Doku schützt es auch nicht davor, dass jemand die Identität auf einen fremden Datensatz ändert. Ob der Datensatz dem Benutzer gehört, prüfst du selbst.
Signierte Parameter: Ein Download-Link enthält Werte, die Besucher nicht ändern dürfen. Der HashService signiert sie mit dem geheimen Schlüssel der Installation: appendHmac() hängt die Signatur an, validateAndStripHmac() prüft sie. Base64 sichert dagegen nichts.
Zufällige Tokens, etwa für einen Bestätigungslink, erzeugst du mit Random::generateRandomHexString() oder random_bytes(). Beide nutzen einen kryptografisch sicheren Zufall. uniqid() beruht auf der Uhrzeit, rand() ist nicht sicher.
Offene Weiterleitung: Leitet eine Action nach dem Login auf eine Adresse aus der URL weiter, schicken Angreifer Opfer so auf fremde Seiten. GeneralUtility::sanitizeLocalUrl() lässt nur relative Adressen und Adressen der eigenen Installation durch. Bei fremden Hosts liefert es einen leeren Text. Seit TYPO3 14 übergibst du den Request als zweites Argument. Die Prüfung FILTER_VALIDATE_URL hilft nicht, sie prüft nur die Form.
Wer bist du, was darfst du?
- Authentifizierung prüft, wer jemand ist, etwa per Passwort. Multi-Faktor-Authentifizierung stärkt sie. Fehlt eine gültige Anmeldung, passt der HTTP-Status 401.
- Autorisierung prüft, was jemand darf, über Rollen, Gruppen und Rechte. Ist jemand angemeldet, darf aber nicht, passt der Status 403.
Die Autorisierung kommt immer nach der Authentifizierung. Ein Redakteur ist angemeldet, darf eine Seite aber nicht bearbeiten: Das entscheidet die Autorisierung. Ein Passwort-Hash gehört dagegen zur Authentifizierung.
Bewährte Praxis: Jeder bekommt nur die Module, Seiten und Tabellen, die er wirklich braucht. Das ist das Prinzip der minimalen Rechte. Die Rechte legst du in Backend-Benutzergruppen fest, nicht je Benutzer. Ein gemeinsames Konto ist schlecht, denn dann sieht man im Log nicht mehr, wer etwas geändert hat.
Rechte im eigenen Code: Ein angemeldeter Benutzer ist nicht automatisch berechtigt.
$GLOBALS['BE_USER']->check('tables_modify', 'tx_myext_item');
$context->getPropertyFromAspect('frontend.user', 'isLoggedIn');Der DataHandler prüft Tabellenrechte von selbst, direkter Code muss das tun. Ein Cookie oder Argument zur Anmeldung kann der Besucher selbst setzen, der Context nicht. Seit TYPO3 14 gibt es für Extbase-Actions das Attribut Authorize. Es verlangt etwa eine Anmeldung oder bestimmte Gruppen und antwortet sonst mit Status 403.
Das Install Tool kann das ganze System umbauen und braucht keinen Backend-Login. Deshalb ist es doppelt gesichert. Erstens muss die Datei ENABLE_INSTALL_TOOL auf dem Server liegen, TYPO3 löscht sie nach 60 Minuten. Zweitens braucht man ein eigenes Install-Tool-Passwort.
Anmeldung in TYPO3
TYPO3 prüft Anmeldungen über eine Kette von Authentifizierungs-Services.
Vorher ruft TYPO3 initAuth() jedes Services auf. Die Services laufen nach absteigender Priorität und Qualität. Ein Service muss nicht alle Subtypen umsetzen. Ein eigener LDAP-Service gibt bei unbekannten Benutzern 100 zurück, dann übernimmt die normale Anmeldung. Auch externe Benutzer brauchen einen Datensatz in fe_users oder be_users. Die registrierten Services zeigt das Modul Configuration im Bereich System.
Sitzungen: Solange eine Session gültig ist, prüft TYPO3 die Anmeldung nicht neu. Nach dem Login vergibt TYPO3 eine neue Session-ID. Eine vorher untergeschobene ID wird so wertlos, das verhindert Session Fixation. Das Session-Cookie hat drei Schutzattribute:
- HttpOnly: JavaScript kann das Cookie nicht lesen.
- Secure: TYPO3 setzt es automatisch, wenn der Request über HTTPS kommt.
- SameSite: Im Frontend steht es auf lax, im Backend auf strict. Der Wert None verlangt Secure, also HTTPS.
Passwörter speichert TYPO3 nur als Hash, standardmäßig mit Argon2id. Das Verfahren ist absichtlich langsam, und der Hash lässt sich nicht zurückrechnen. Verschlüsseln wäre falsch, denn mit dem Schlüssel wäre bei einem Datenleck alles verloren. MD5 oder SHA-256 sind viel zu schnell, und ein HMAC ist für Signaturen gedacht. Eigene Passwörter hasht deine Extension wie der Core.
$hashInstance = $passwordHashFactory->getDefaultHashInstance('FE');
$hash = $hashInstance->getHashedPassword($password);
$ok = $hashInstance->checkPassword($password, $hash);Passwortrichtlinie: Die Richtlinie default verlangt mindestens 8 Zeichen, je einen Groß- und Kleinbuchstaben, eine Ziffer und ein Sonderzeichen. Ein neues Passwort darf nicht dem aktuellen entsprechen. Eine Prüfung gegen Datenlecks bringt der Core nicht mit.
Fehlversuche: Nach 5 fehlgeschlagenen Backend-Logins in 15 Minuten sperrt TYPO3 weitere Versuche von dieser IP-Adresse vorübergehend. Im Frontend liegt die Grenze bei 10. Das Konto selbst sperrt TYPO3 nicht, sonst könnten Angreifer echte Benutzer aussperren.
Multi-Faktor-Authentifizierung: Der Core bringt zwei Verfahren mit. TOTP erzeugt in einer Authenticator-App alle 30 Sekunden einen Code. Recovery Codes sind Ersatzcodes für ein verlorenes Smartphone und nur zusätzlich nutzbar. SMS- oder E-Mail-Codes gibt es nur über Extensions. Zur Pflicht machst du MFA mit requireMfa im Bereich BE:
- 0 schaltet die Pflicht aus, 1 gilt für alle Benutzer.
- 2 gilt nur für Benutzer ohne Administratorrechte, 3 nur für Administratoren.
- 4 gilt nur für System-Maintainer.
Die Option auth.mfa.required im User TSconfig legt es für einzelne Benutzer oder Gruppen abweichend fest und hat Vorrang.
Content Security Policy
Eine Content Security Policy, kurz CSP, ist ein HTTP-Header. Er sagt dem Browser, aus welchen Quellen er Skripte, Styles und Bilder laden darf. So schützt sie gegen eingeschleuste Skripte. Das Maskieren ersetzt sie nicht.
Aktivieren: Im Backend setzt TYPO3 die CSP immer durch. Im Frontend ist sie standardmäßig aus. Du schaltest sie mit einem der beiden Feature-Schalter ein, zum Durchsetzen oder nur zum Melden.
security.frontend.enforceContentSecurityPolicy
security.frontend.reportContentSecurityPolicyAlternativ setzt die Datei csp.yaml einer Site die Disposition enforce oder report.
Regeln einer Extension stehen in der Datei ContentSecurityPolicies.php im Ordner Configuration. Sie gibt eine Map zurück, die einem Scope eine MutationCollection zuordnet. Der Scope, frontend oder backend, ist Pflicht.
return Map::fromEntries([
Scope::frontend(),
new MutationCollection(
new Mutation(MutationMode::Extend, Directive::FrameSrc, new UriValue('https://maps.example.com')),
),
]);Die Modi heißen set, append, extend, reduce und remove. Dazu kommen inherit-once und inherit-again, die Quellen von default-src übernehmen.
Inline-Skripte blockiert der Browser. Gezielt erlaubst du eines mit einer Nonce, einem Zufallswert je Request.
<script nonce="{f:security.nonce(directive: 'script-src')}">…</script>Der Wert unsafe-inline würde jedes Inline-Skript erlauben und den Schutz aushebeln.
Neu in TYPO3 14: Eine Nonce macht jede Antwort einzigartig, die Seite lässt sich dann nicht cachen. Seit Version 14.2 kann TYPO3 stattdessen Hashes der Skripte und Styles sammeln. Ein Hash bleibt gleich. Das ist ein Opt-in je Site in der Datei csp.yaml.
behavior:
useHash: true
useNonce: falseCVE und Updates
Eine CVE ist eine eindeutige Kennung für eine öffentlich bekannte Sicherheitslücke, im Format CVE, Jahr, Nummer. Den Schweregrad beschreibt CVSS von 0 bis 10. Ab 9,0 gilt eine Lücke als kritisch. Das TYPO3 Security Team veröffentlicht Security Advisories wie TYPO3-CORE-SA mit Jahr und Nummer. Sie verweisen auf die CVE.
So bleibst du informiert:
- Du verfolgst die Advisories auf typo3.org per Mailingliste oder Feed.
- Du prüfst Pakete mit composer audit auf bekannte Lücken.
- Du schaust im Backend auf der Status-Seite nach Sicherheitsupdates.
Das Wichtigste in Kürze
- Jede Eingabe ist verdächtig, auch Cookies, Header und fremde Schnittstellen.
- Validierung weist zurück, Bereinigung verändert. Prüfe auf dem Server mit einer Allowlist.
- Maskiere passend zum Ziel: Named Parameter für SQL, Escaping für HTML.
- Gegen CSRF hilft ein Token, der an die Sitzung gebunden ist.
- Authentifizierung klärt, wer jemand ist, Autorisierung, was er darf.
- Passwörter sind Argon2id-Hashes, MFA bringt TOTP und Recovery Codes.
- Die CSP ist im Frontend ein Opt-in, Extensions liefern Regeln je Scope.
- Eine CVE benennt eine Lücke, CVSS bewertet sie. Patch-Updates spielst du sofort ein.
Begriffe
- Allowlist
- Liste der erlaubten Werte, alles andere wird abgelehnt.
- CSRF
- Untergeschobene Anfrage im Namen eines angemeldeten Benutzers.
- CVE
- Kennung einer öffentlich bekannten Sicherheitslücke.
- CVSS
- Bewertung des Schweregrads einer Lücke von 0 bis 10.
- HMAC
- Signatur mit geheimem Schlüssel, die jede Änderung verrät.
- Nonce
- Zufallswert, der für jeden Request neu entsteht.
- Path Traversal
- Zugriff auf Dateien außerhalb des erlaubten Ordners.
- XSS
- Eingeschleustes Skript, das im Browser anderer Besucher läuft.