APP_SECRET in Contao: Was es schützt – und wie du es wechselst
Was ist eigentlich das APP_SECRET? Und darf ich es einfach so ändern?
Vermutlich ist es dir schon als zufällige Zeichenkette in der .env.local begegnet. Bei der Installation gesetzt, danach vergessen. Nur: Mit dieser Zeichenkette signiert Contao alles, was von außen niemand verändern darf.
Die kurze Antwort: Mit dem APP_SECRET signiert Contao Links, Cookies und Prüfwerte. Wer es kennt, kann diese Signaturen fälschen – im schlimmsten Fall so weit, dass Fremde Code auf deinem Server ausführen.
Deshalb gehört das Secret an genau eine Stelle: auf den Server. Nicht ins Git-Repository, nicht in ein Ticket, nicht in eine E-Mail. Und ist es doch dort gelandet: wechseln. Das darfst du jederzeit – es dauert ein paar Minuten und sperrt niemanden aus.
Das gilt für Contao 5 und Contao 6.
Was das APP_SECRET macht
Manche Daten schickt Contao an den Browser und bekommt sie später zurück: einen Link, ein Cookie, die Lösung einer Spamschutz-Aufgabe. Contao muss sicher sein, dass niemand sie unterwegs verändert hat.
Deshalb hängt Contao eine Prüfsumme an. Die berechnet es aus den Daten und dem APP_SECRET. Kommt die Anfrage zurück, rechnet Contao nach. Passt die Prüfsumme nicht, lehnt es ab.
Das Verfahren ist öffentlich. Das Secret nicht. Darauf beruht der ganze Schutz.
Wo Contao das Secret einsetzt
- Vorschau-Links: Damit zeigst du anderen eine Seite vor der Veröffentlichung. Jeder Link ist signiert.
- Downloads aus geschützten Ordnern: Liegt eine Datei in einem nicht öffentlichen Ordner, erzeugen die Elemente Download und Downloads einen signierten Link.
- Zwei-Faktor-Authentifizierung: Wer bei der Anmeldung angibt, dem Gerät zu vertrauen, bekommt ein signiertes Cookie. Solange es gilt, fragt Contao keinen zweiten Faktor ab.
- Spamschutz: Die Sicherheitsfrage im Formular und ALTCHA (seit Contao 5.4) prüfen die Antworten über eine Prüfsumme mit dem Secret.
- Bilder: Die Dateinamen in
assets/imagesundassets/previewsenthalten eine Prüfsumme aus dem Secret. - Weiterleitung nach dem Login: Wohin Contao nach der Anmeldung weiterleitet, steht in einem signierten Link.
- Interne Anfragen unter
/_fragment: Hier ruft Symfony – das Framework, auf dem Contao aufbaut – einzelne Teile einer Seite getrennt ab, etwa für den Seiten-Cache. Es nimmt dort nur signierte Anfragen an.
Woher das Secret kommt
Bei der Installation erzeugt Contao das Secret selbst. Das Skript contao-setup schreibt einen Zufallswert mit 64 Zeichen in die .env.local – sofern noch keiner gesetzt ist.
Ältere Installationen haben es als secret in der parameters.yml. Diesen Wert nimmt Contao nur, wenn APP_SECRET nicht gesetzt ist.
Ist das Secret leer oder steht noch der Symfony-Standardwert ThisTokenIsNotSoSecretChangeIt drin, verweigert Contao den Dienst. Ausnahme: der eigene Rechner (localhost).
4 Folgen, wenn das Secret öffentlich wird
Wer das Secret kennt, berechnet gültige Prüfsummen selbst. Gefälschte Anfragen sehen für Contao dann aus wie echte.
1. Fremde führen Code auf deinem Server aus
Die gefährlichste Stelle ist /_fragment. In einer signierten Anfrage an diese Adresse steht, welche Funktion Symfony aufrufen soll – und mit welchen Werten.
Bis Symfony 6.4 ist das jede beliebige PHP-Funktion. Wer das Secret kennt, führt damit Befehle auf dem Server aus: Dateien lesen, die Datenbank auslesen, Schadcode ablegen. Ein Login braucht es dafür nicht. Eine einzige Anfrage reicht.
Betroffen sind Contao 4.13 und 5.3. Bei Contao 5.4 bis 5.6 hängt es davon ab, ob Symfony 6.4 oder 7 installiert ist. Welche Version läuft, zeigt composer show symfony/http-kernel.
Ab Symfony 7 – also in Contao 5.7 und 6 – lässt Symfony an dieser Stelle nur noch Controller zu, keine beliebigen Funktionen. Das macht einen Angriff deutlich schwerer. Harmlos wird ein bekanntes Secret dadurch nicht.
2. Die Zwei-Faktor-Authentifizierung fragt nicht mehr nach
Das Cookie für vertrauenswürdige Geräte enthält im Kern die ID des Kontos – und eine Signatur. Wer das Secret kennt, baut sich dieses Cookie selbst.
Wer dazu noch ein Passwort kennt, etwa aus einem Datenleck, meldet sich ohne zweiten Faktor an. Das betrifft das Backend genauso wie Mitglieder im Frontend.
3. Unveröffentlichte Inhalte werden sichtbar
Vorschau-Links haben fortlaufende Nummern. Die Signatur verhindert, dass jemand einfach die nächste Nummer ausprobiert. Mit dem Secret geht genau das.
Jeder aktive Vorschau-Link lässt sich dann öffnen – samt unveröffentlichter Inhalte, wenn Unveröffentlichtes anzeigen gesetzt ist.
4. Der Spamschutz wirkt nicht mehr
Sicherheitsfrage und ALTCHA prüfen die Antwort über eine Prüfsumme. Mit dem Secret berechnen Bots gültige Antworten selbst, ohne die Aufgabe zu lösen. Der Spamschutz hält dann keinen Bot mehr auf.
3 Wege, wie das Secret öffentlich wird
1. Es steht im Git-Repository
Die .env gehört ins Repository, die .env.local nicht. Landet das Secret trotzdem in der .env – oder die .env.local im Repository –, kennt es jede Person mit Zugriff. Bei einem öffentlichen Repository: alle.
Löschen hilft nicht. Die Git-Historie behält den alten Stand.
2. Es wird kopiert
Ein ZIP-Archiv für die neue Agentur. Ein Backup in der Cloud. Ein Ausschnitt aus der .env.local im Support-Forum. Jede Kopie ist eine Stelle mehr, an der das Secret liegt – und an der du nicht mehr kontrollierst, wer es liest.
3. Es ist überall dasselbe
Ein Starterkit mit festem Secret in der .env. Die .env.local vom Live-System, kopiert auf die Stage und den eigenen Rechner. Dann reicht ein einziges Leck – und alle Installationen mit diesem Secret sind betroffen.
Jede Installation braucht ihr eigenes Secret. Jede Umgebung auch.
Wann du das Secret wechseln solltest
- Es stand irgendwo, wo es nicht hingehört: Repository, Ticket, Chat, E-Mail, Forum.
- Jemand mit Zugriff ist raus: Du wechselst den Dienstleister. Ihr übernehmt ein Projekt von einer anderen Agentur. Jemand aus dem Team hat das Unternehmen verlassen.
- Die Website wurde gehackt: Dann gehören alle Zugangsdaten neu – das Secret auch.
- Mehrere Installationen teilen sich ein Secret.
- Es ist kürzer als 32 Zeichen: Symfony empfiehlt mindestens 32. Bei kürzeren Werten scheitert in Contao unter anderem das Speichern vertrauenswürdiger Geräte.
Symfony empfiehlt außerdem, das Secret „von Zeit zu Zeit“ zu wechseln (Symfony-Dokumentation). Wir wechseln es nur, wenn einer der Anlässe oben eintritt.
So wechselst du das APP_SECRET
Ist das Secret öffentlich geworden, wechselst du sofort. Sonst wähl eine ruhige Zeit: Nach dem Wechsel erzeugt Contao alle Bilder neu (siehe Schritt 4).
1. Neues Secret erzeugen
php -r 'echo bin2hex(random_bytes(32)), PHP_EOL;'
Heraus kommen 64 Zeichen aus 0–9 und a–f – genau das Format, das Contao bei der Installation selbst erzeugt. Sonderzeichen sind keine dabei, du musst also nichts URL-kodieren. Alternativ: openssl rand -hex 32.
Nimm keinen Online-Generator. Das Secret soll an genau einer Stelle existieren: auf deinem Server.
2. Das alte Secret finden – überall
Contao liest das Secret aus mehreren Quellen. Die erste mit einem Wert gewinnt:
- Umgebungsvariablen des Servers, etwa im Hosting-Panel gesetzt
.env.local.php– gibt es diese Datei, liest Contao die übrigen.env-Dateien gar nicht.env.local.envsecretin derparameters.yml– nur, wennAPP_SECRETnirgends gesetzt ist
Trag das neue Secret in die .env.local ein:
APP_SECRET=dein-neues-secret
Steht das alte Secret noch in der .env oder in der parameters.yml, lösch es dort. Ist es als Umgebungsvariable des Servers gesetzt, änderst du es dort. Gibt es eine .env.local.php, erzeugst du sie danach neu:
vendor/bin/contao-console dotenv:dump
Deployt ihr automatisiert, etwa mit Deployer, liegt die .env.local auf dem Server meist im Ordner shared – nicht im Projekt.
3. Cache leeren
vendor/bin/contao-console cache:clear
Das leert auch den Seiten-Cache. Wichtig: Darin stecken Seiten mit Links, die noch mit dem alten Secret signiert sind. Liegt ein CDN oder Varnish vor der Website, leer den Cache dort ebenfalls.
Ohne Kommandozeile geht das im Contao Manager: unter Wartung im Bereich Anwendungs-Cache mit Prod.-Cache erneuern.
4. Bildercache leeren (optional)
Nach dem Wechsel bekommt jedes Bild einen neuen Dateinamen. Contao erzeugt es beim ersten Aufruf neu. Die alten Dateien bleiben in assets/images liegen und belegen Speicherplatz.
Im Backend leerst du beides unter Systemwartung → Daten bereinigen mit Bildercache leeren und Vorschau-Cache leeren. Auf der Kommandozeile:
vendor/bin/contao-console contao:automator purgeImageCache
Bei Websites mit vielen Bildern kostet das Neuerzeugen Rechenzeit – bei den ersten Aufrufen sind Seiten langsamer.
5. Testen
- Eine Seite mit Bildern aufrufen.
- Ein Formular mit Spamschutz abschicken.
- Eine Datei aus einem geschützten Ordner herunterladen.
- Mit Zwei-Faktor-Authentifizierung anmelden.
Was sich nach dem Wechsel ändert – und was nicht
Alles, was mit dem alten Secret signiert wurde, ist ungültig. Konkret:
- Vorschau-Links: Verschickte Links funktionieren nicht mehr. In der Liste der Vorschau-Links kopierst du über URL teilen den neuen Link und schickst ihn noch einmal raus.
- Vertrauenswürdige Geräte: Alle mit Zwei-Faktor-Authentifizierung geben den Code einmal neu ein.
- Bilder: bekommen neue Dateinamen (siehe oben).
- Downloads aus geschützten Ordnern: Gespeicherte oder weitergegebene Links führen zu einer Fehlermeldung.
- Offene Formulare mit Spamschutz: Wer ein Formular vor dem Wechsel lädt und danach abschickt, bekommt einmal eine Fehlermeldung. Die Eingaben bleiben stehen. Beim zweiten Versuch beantwortet man die Sicherheitsfrage von Hand oder löst ALTCHA neu – dann geht das Formular raus. Steht bei ALTCHA die Automatische Überprüfung auf „onsubmit“, tritt der Fehler gar nicht auf.
Was bleibt:
- Passwörter. Contao speichert sie als Hash – ohne Secret.
- Die Datenbank. Das Secret verschlüsselt nichts darin.
- Anmeldungen. Wer angemeldet ist, bleibt angemeldet – auch mit Angemeldet bleiben. Die Symfony-Dokumentation sagt zwar etwas anderes. Contao speichert diese Anmeldungen aber in der Datenbank, nicht über das Secret. Getestet haben wir das mit Contao 5.7.
- Die CSRF-Tokens der Formulare. Contao erzeugt sie zufällig, nicht aus dem Secret. Ein Formular, das vor dem Wechsel geladen wurde, lässt sich danach noch abschicken.
Ein Wechsel sperrt also niemanden aus. Er macht nur ungültig, was Contao ohnehin neu erzeugen kann.
Die Checkliste
- Jede Installation hat ihr eigenes APP_SECRET – jede Umgebung auch.
- Es ist zufällig erzeugt und mindestens 32 Zeichen lang.
- Es steht in der
.env.localoder als Umgebungsvariable des Servers – nicht in der.env, nicht im Git-Repository. - In der
parameters.ymlsteht kein altessecretmehr. - Nach einem Wechsel: Cache geleert, Vorschau-Links neu verschickt, Login mit Zwei-Faktor getestet.
Und jetzt? Öffne die .env.local deiner Website. Und prüf, wo das Secret sonst noch steht.
Du willst das nicht selbst prüfen – für deine Website oder die deiner Kund:innen? Schreib uns.