security-txt.de

RatgeberStand Lesezeit 9 Min.

security.txt abgelaufen: Was das Expires-Datum bedeutet und wie Sie es im Griff behalten

Jede security.txt trägt ein Ablaufdatum. Ist es überschritten, gilt die Datei als veraltet, und Prüfdienste melden einen Fehler, obwohl sich an Ihren Kontakten nichts geändert hat. Diese Seite erklärt, warum es das Feld gibt, welches Format gilt, wie weit Sie das Datum in die Zukunft legen dürfen und wie Sie verhindern, dass es wieder still abläuft.

Warum die security.txt ein Ablaufdatum hat

Eine security.txt sagt Fremden, wohin sie eine Schwachstelle in Ihren Systemen oder Produkten melden sollen. Stimmt die Adresse nicht mehr, weil das Postfach gelöscht wurde, das Team gewechselt hat oder die Meldeseite nach einem Relaunch fehlt, geht die Meldung ins Leere oder an die falsche Stelle. RFC 9116 nimmt diese Gefahr ernst: In Abschnitt 5.3 heißt es sinngemäß, dass gar keine security.txt besser sein kann als eine mit veralteten Angaben.

Deshalb ist das Feld Expires neben Contact das einzige Pflichtfeld der Datei. Es muss genau einmal vorkommen (RFC 9116 Abschnitt 2.5.5) und nennt den Zeitpunkt, nach dem die Angaben als veraltet gelten und nicht mehr benutzt werden sollen. Das Datum ist also kein Formalismus, sondern ein Versprechen: Bis zu diesem Tag stehen Sie dafür ein, dass die Kontakte stimmen.

Wie oft das schiefgeht, zeigt eine Auswertung der eine Million meistbesuchten Domains durch uriports vom 24. Januar 2025: Bei 45 Prozent der gefundenen Dateien fehlte Expires ganz, bei 13 Prozent war es bereits abgelaufen, bei 20 Prozent lag es zu weit in der Zukunft.

Was nach dem Ablauf passiert

Am Tag nach dem Ablaufdatum ändert sich an Ihrem Server nichts. Die Datei liegt weiter unter /.well-known/security.txt und wird ausgeliefert. Was sich ändert, ist die Bewertung durch alle, die sie lesen:

  • Meldende sollen die Angaben nicht mehr verwenden. So steht es in RFC 9116. Wer sich daran hält, sucht einen anderen Weg, schreibt an eine allgemeine Adresse oder lässt es bleiben.
  • Prüfdienste und Scanner werten die Datei als fehlerhaft. Unser Check meldet eine abgelaufene Datei als Fehler, ebenso andere Prüfwerkzeuge. In Sicherheitsbewertungen, Pentest-Berichten oder Lieferantenfragebögen steht dann ein Befund, den jemand erklären muss.
  • Die Datei wirkt verwaist. Ein abgelaufenes Datum ist für Außenstehende das deutlichste Zeichen, dass sich niemand um die Meldewege kümmert. Für Hersteller, die nach außen Bereitschaft für Schwachstellenmeldungen zeigen wollen, ist das das falsche Signal.

Ein abgelaufenes Datum macht die Kontakte nicht technisch ungültig. Mails an Ihre Adresse kommen weiter an. Sie verlieren aber die Meldungen der Sorgfältigen, und gerade die sind meist die wertvollen.

Das richtige Format

RFC 9116 übernimmt das Datumsformat date-time aus RFC 3339, Abschnitt 5.6. Ein gültiger Wert besteht immer aus Datum, dem Trenner T, einer Uhrzeit mit Sekunden und einer Zeitzonenangabe. Bruchteile von Sekunden sind erlaubt. Am einfachsten und am wenigsten fehleranfällig ist koordinierte Weltzeit mit Z:

Expires: 2027-09-30T22:00:00.000Z

Gleichwertig, aber mit Versatz zur Weltzeit, wäre der Wert 2027-10-01T00:00:00+02:00. Beide meinen denselben Augenblick: Mitternacht deutscher Sommerzeit am 1. Oktober 2027.

Die Technische Richtlinie BSI TR-03183-3 ist strenger als das RFC: Der Trenner T und das Zeitzonenzeichen Z müssen großgeschrieben werden, andere Trenner sind verboten (4.2.9 a). RFC 3339 erlaubt dagegen ausdrücklich auch kleines t und z, und das Beispiel in RFC 9116 selbst endet auf ein kleines z. Wer großschreibt, ist auf beiden Maßstäben auf der sicheren Seite.

WertRFC 9116BSI TR-03183-3Warum
2027-09-30T22:00:00.000ZgültiggültigDatum, T, Uhrzeit, Z: so soll es aussehen
2027-10-01T00:00:00+02:00gültiggültigVersatz zur Weltzeit statt Z ist erlaubt
2027-09-30t22:00:00zgültigFehlerkleines t und z, nach TR 4.2.9 a unzulässig
2027-10-01FehlerFehlerUhrzeit und Zeitzone fehlen
2027-10-01T00:00:00FehlerFehlerZeitzone fehlt, der Zeitpunkt ist nicht eindeutig
2027-10-01 00:00:00ZFehlerFehlerLeerzeichen statt T, die Grammatik verlangt T
01.10.2027FehlerFehlerdeutsches Datumsformat, nicht RFC 3339
2027-02-30T00:00:00ZFehlerFehlerden 30. Februar gibt es nicht
zwei Zeilen ExpiresFehlerFehlerdas Feld darf nur einmal vorkommen
Datum mehr als ein Jahr vorausWarnungWarnungRFC empfiehlt weniger als ein Jahr, TR höchstens ein Jahr

Zwei Feinheiten, die oft übersehen werden: Der Feldname ist unabhängig von Groß- und Kleinschreibung, expires: wird also erkannt. Und das Datum zählt nur außerhalb von Kommentaren. Eine Zeile wie # Expires: 2030-01-01T00:00:00Z ist kein Ablaufdatum, sondern ein Kommentar; fehlt die echte Zeile, fehlt das Pflichtfeld.

Wie weit in die Zukunft?

RFC 9116 empfiehlt einen Wert, der weniger als ein Jahr in der Zukunft liegt (Abschnitt 2.5.5). Die TR formuliert es als Soll: höchstens ein Jahr (4.2.9 b). Ein Datum fünf Jahre voraus ist also kein Formatfehler, wird aber von Prüfdiensten bemängelt, weil es das Ablaufdatum aushebelt. Wer die Meldung "expires too far in the future" sieht, hat genau das.

Die bessere Frage ist, wie kurz Sie das Datum wählen. Je kürzer der Abstand, desto öfter müssen Sie verlängern, desto öfter sieht aber auch jemand nach, ob die Angaben noch stimmen. Drei Varianten haben sich bewährt:

VarianteExpiresPasst für
Jährlichknapp ein Jahr voraus, etwa 360 TageUnternehmensseiten ohne eigene Produkte, die nach RFC 9116 arbeiten
Mit der Quartalsprüfungbei jeder Prüfung neu auf rund ein Jahr vorausHersteller nach der TR, die ohnehin vierteljährlich prüfen müssen
Kurz und automatischwenige Monate, per Skript neu gesetzt und signiertgroße Umgebungen mit vielen Domains und eingespielter Automatisierung

Die TR verlangt unabhängig vom Ablaufdatum, die Angaben mindestens jedes Quartal zu prüfen und zu korrigieren (4.2.9 c). Daraus ergibt sich die zweite Variante fast von selbst: Wenn Sie ohnehin alle drei Monate nachsehen, setzen Sie das Datum dabei gleich neu. Dann liegt es nie weniger als neun Monate voraus, und ein Ablauf kann praktisch nicht passieren.

Legen Sie das Datum außerdem nicht auf einen Tag, an dem niemand da ist. Der 31. Dezember, ein Brückentag oder die Mitte der Sommerferien sind schlechte Termine, weil die Erinnerung genau dann niemanden erreicht.

Verlängern in vier Schritten

Das Datum einfach zu überschreiben, reicht nicht, wenn die Datei signiert ist. Nach RFC 9116 empfohlen und nach der TR Pflicht, sorgt die Signatur dafür, dass jede Änderung auffällt. Ein neues Datum ohne neue Signatur macht die Signatur ungültig. So gehen Sie vor:

  1. Inhalt prüfen, nicht nur das Datum. Gibt es jede Adresse aus Contact noch, und liest sie jemand? Funktionieren die Verweise auf Richtlinie, Schlüssel und Meldeseite? Stimmt Canonical nach einem Umzug der Webseite noch? Schicken Sie eine Testmail an jede Adresse.
  2. Neues Datum setzen. Höchstens ein Jahr voraus, mit großem T und Z. Den passenden Wert schlägt der Generator vor: Er setzt ein Jahr minus einen Tag.
  3. Neu signieren. Die alte Signatur entfernen und die Datei mit Ihrem Signaturschlüssel neu signieren. Die Befehle und die typischen Fehlermeldungen stehen unter Signieren und Signatur prüfen. Prüfen Sie vorher, ob der Schlüssel selbst noch lange genug gilt (siehe nächster Abschnitt).
  4. Hochladen und prüfen. Die Datei unverändert, also binär, hochladen, damit kein Programm Zeichensatz oder Zeilen umschreibt. Danach mit dem Check prüfen: Er zeigt das neue Datum, die Restlaufzeit und ob die Signatur passt.

Ein Cache vor der Webseite, etwa ein CDN, kann noch eine Weile die alte Datei ausliefern. Wenn der Check das alte Datum zeigt, leeren Sie den Cache für die Adresse /.well-known/security.txt.

Datei-Ablauf und Schlüssel-Ablauf sind zwei Termine

In einer signierten security.txt stecken mindestens zwei Ablaufdaten, die nichts miteinander zu tun haben: das Expires der Datei und die Gültigkeit der OpenPGP-Schlüssel, mit denen Sie signieren und die im Feld Encryption zum Verschlüsseln angeboten werden. Die TR erlaubt für Schlüssel höchstens fünf Jahre (4.2.10 e), gängig sind zwei.

Expires der DateiAblauf des Schlüssels
Wo steht es?als Zeile in der security.txtim Schlüssel selbst, anzeigen mit gpg --list-keys
Wie lang?höchstens ein Jahrmeist zwei Jahre, nach TR höchstens fünf
Folge des AblaufsDatei gilt als veraltetSignatur oder Verschlüsselung mit dem Schlüssel wird beanstandet
Verlängernneues Datum, neu signieren, hochladenGültigkeit verlängern, .asc neu exportieren und hochladen, Fingerabdruck bleibt gleich

Der häufigste Fehler: Die Datei wird pünktlich verlängert und mit einem Schlüssel signiert, der zwei Wochen später abläuft. Prüfen Sie deshalb bei jeder Verlängerung auch die Schlüssel. Läuft einer vor dem neuen Expires ab, verlängern Sie ihn zuerst. Unser Check warnt, sobald ein Schlüssel aus der Datei in weniger als 60 Tagen abläuft, und wertet einen abgelaufenen Schlüssel nach der TR als Fehler. Wie Sie Schlüssel verlängern und was bei Verlust zu tun ist, steht unter Wenn der Schlüssel abläuft.

Wer sich darum kümmert

Ein Ablaufdatum läuft fast nie ab, weil jemand es falsch gemacht hat, sondern weil niemand zuständig war. Die Datei wurde einmal angelegt, die Person hat die Firma verlassen, und das nächste Mal fällt es einem Scanner auf. Drei Dinge verhindern das:

  • Eine benannte Rolle statt einer Person. Zuständig ist das Team, das auch das Security-Postfach betreut, bei Herstellern das PSIRT, sonst die IT-Leitung. Die Zuständigkeit gehört in die interne Dokumentation, nicht nur in einen Kopf.
  • Ein Termin mit Vorlauf. Ein Kalendereintrag für ein Funktionspostfach oder eine Gruppe, 30 Tage vor dem Ablauf, mit Link auf diese Seite. Besser noch ein wiederkehrendes Ticket im System, mit dem Ihr Team ohnehin arbeitet; ein Ticket bleibt offen, bis es jemand erledigt, ein Termin verschwindet.
  • Ein Nachweis. Wer der TR folgt, muss vierteljährlich prüfen. Notieren Sie Datum, Person und Ergebnis jeder Prüfung. Das hilft auch, wenn ein Kunde oder Auditor nachfragt, wie Ihre Meldewege gepflegt werden.

Automatisch prüfen lassen

Wer ohnehin Skripte oder eine Pipeline für die Webseite betreibt, kann die Restlaufzeit maschinell überwachen. Dieses kleine Skript liest das Ablaufdatum aus der veröffentlichten Datei und endet mit einem Fehler, wenn weniger als 45 Tage übrig sind. Es läuft mit GNU date unter Linux, etwa als täglicher Cronjob oder als Schritt in einer CI-Pipeline:

#!/bin/sh
# Warnt, wenn die security.txt in weniger als 45 Tagen abläuft
url="https://www.beispiel.de/.well-known/security.txt"
exp=$(curl -fsS "$url" | sed -n 's/^[Ee][Xx][Pp][Ii][Rr][Ee][Ss]: *//p' | tr -d '\r')
tage=$(( ( $(date -d "$exp" +%s) - $(date +%s) ) / 86400 ))
echo "$url läuft in $tage Tagen ab ($exp)"
[ "$tage" -ge 45 ] || exit 1

Das Skript prüft nur das Datum. Ob die Signatur passt, die Verweise erreichbar sind und ein Schlüssel bald abläuft, sieht es nicht. Fehlt die Datei oder ist das Datum kaputt, bricht es mit einer Fehlermeldung ab, was für eine Überwachung das gewünschte Verhalten ist.

Wer die Datei aus einer Pipeline erzeugt, kann noch einen Schritt weiter gehen: Das Datum wird bei jedem Build neu gesetzt und die Datei automatisch signiert. Dafür muss der Signaturschlüssel auf dem Build-System liegen. Ob Sie das wollen, ist eine Abwägung: Wer den Build kontrolliert, kann dann auch eine gültig signierte Datei mit falschen Kontakten veröffentlichen. Eine Alternative ist, das Datum automatisch zu prüfen und nur das Signieren von Hand zu erledigen.

Viele Domains und Subdomains

Die security.txt gilt nur für die Domain, unter der sie abgerufen wird, nicht für Subdomains oder die übergeordnete Domain (RFC 9116 Abschnitt 3.1). Wer unter firma.de, www.firma.de, shop.firma.de und drei Länderdomains erreichbar ist, hat also schnell ein Dutzend Dateien und ein Dutzend Ablaufdaten.

Einfacher wird es mit einer einzigen Datei für alle: RFC 9116 erlaubt das Feld Canonical mehrfach (Abschnitt 2.5.2). Sie führen darin jede Adresse auf, unter der die Datei liegt, signieren einmal und spielen dieselbe Datei auf alle Domains aus. Dann gibt es nur noch ein Expires und eine Verlängerung:

Contact: mailto:security@firma.de
Expires: 2027-09-30T22:00:00.000Z
Canonical: https://firma.de/.well-known/security.txt
Canonical: https://www.firma.de/.well-known/security.txt
Canonical: https://shop.firma.de/.well-known/security.txt

Wichtig ist, dass jede Domain die Datei selbst ausliefert. Die TR verlangt, dass die kanonische Adresse ohne Weiterleitung erreichbar ist (4.2.2 c). Eine Weiterleitung von shop.firma.de auf die Hauptdomain ersetzt die eigene Datei also nicht. Und prüfen Sie nach jeder Verlängerung alle Domains, nicht nur die erste: Gerade auf selten gepflegten Subdomains bleibt gern die alte Fassung liegen.

Nicht mehr an das Datum denken müssen. Die Überwachung prüft Ihre security.txt jeden Tag mit denselben Regeln wie der Check und erinnert 30, 14, 7 und 1 Tag vor dem Ablaufdatum, außerdem bevor ein Schlüssel aus der Datei abläuft. Fehlt die Datei oder passt die Signatur nicht, kommt sofort eine Nachricht. Bis zu 10 Domains je Abo, 60 Euro netto im Jahr je Domain. Zur Überwachung

Häufige Fragen

Meine security.txt ist abgelaufen. Was muss ich tun?

Prüfen Sie zuerst, ob alle Kontakte noch stimmen. Dann setzen Sie ein neues Expires höchstens ein Jahr voraus, signieren die Datei neu, falls sie signiert ist, laden sie hoch und prüfen das Ergebnis mit dem Check. Das dauert meist weniger als eine halbe Stunde.

Welches Datumsformat braucht Expires?

Das Format date-time aus RFC 3339: Datum, großes T, Uhrzeit mit Sekunden und Zeitzone, zum Beispiel 2027-09-30T22:00:00.000Z. Ein Datum ohne Uhrzeit oder ohne Zeitzone ist ungültig. Nach der BSI TR-03183-3 müssen T und Z großgeschrieben sein.

Wie weit darf Expires in der Zukunft liegen?

RFC 9116 empfiehlt weniger als ein Jahr, die BSI TR-03183-3 höchstens ein Jahr. Ein späteres Datum ist kein Formatfehler, wird aber von Prüfdiensten als Warnung gemeldet.

Was bedeutet "expires too far in the future"?

Das Ablaufdatum liegt mehr als ein Jahr voraus. Prüfdienste weisen darauf hin, weil ein Datum viele Jahre voraus den Zweck des Feldes aushebelt. Setzen Sie es auf höchstens ein Jahr und signieren Sie neu.

Funktioniert meine Kontaktadresse nach dem Ablauf noch?

Technisch ja, Mails kommen weiter an. Nach RFC 9116 sollen Meldende die Angaben einer abgelaufenen Datei aber nicht mehr verwenden. Sorgfältige Meldende suchen dann einen anderen Weg oder melden gar nicht.

Muss ich nach dem Ändern von Expires neu signieren?

Ja, wenn die Datei signiert ist. Die Signatur deckt den ganzen Inhalt ab, schon ein geändertes Zeichen macht sie ungültig. Signieren Sie die Datei nach jeder Änderung neu.

Ist das Ablaufdatum der Datei dasselbe wie das des Schlüssels?

Nein. Expires gilt für die Datei, höchstens ein Jahr. Der OpenPGP-Schlüssel hat eine eigene Gültigkeit, meist zwei Jahre, nach der TR höchstens fünf. Beide brauchen einen eigenen Termin.

Brauche ich für jede Subdomain ein eigenes Ablaufdatum?

Jede Domain braucht ihre eigene Datei, aber nicht unbedingt eine eigene Fassung. Mit mehreren Canonical-Zeilen kann dieselbe signierte Datei auf allen Domains liegen; dann gibt es nur ein Expires zu pflegen.

Quellen