Alle Felder der security.txt erklärt
Eine security.txt besteht aus wenigen Zeilen, aber jede Zeile hat Regeln: welche Werte erlaubt sind, ob sie mehrfach stehen darf, was RFC 9116 verlangt und was die BSI TR-03183-3 zusätzlich fordert. Diese Seite ist das Nachschlagewerk dazu, Feld für Feld, mit Beispielen und den Fehlern, die Prüfprogramme am häufigsten melden.
Aufbau der Datei
Die security.txt ist eine reine Textdatei in UTF-8 (RFC 9116 Abschnitt 4). Jede Zeile ist entweder ein Feld, ein Kommentar oder leer. Ein Feld besteht immer aus Name und Wert, getrennt durch einen Doppelpunkt und ein Leerzeichen:
Contact: mailto:security@beispiel.de
Für den Aufbau gelten wenige, aber feste Regeln aus Abschnitt 2 und der Grammatik in Abschnitt 4 des RFC:
- Ein Feld je Zeile. Mehrere Werte dürfen nicht in einem Feld verkettet werden, außer die Felddefinition erlaubt es ausdrücklich. Das tut nur Preferred-Languages.
- Feldnamen sind unabhängig von Groß- und Kleinschreibung.
contact:gilt wieContact:. Üblich und am besten lesbar ist die Schreibweise aus dem RFC. - Nach dem Doppelpunkt steht ein Leerzeichen. Die Grammatik verlangt es (
fs SP).Contact:mailto:...ohne Leerzeichen ist streng genommen ungültig. - Kommentare beginnen mit
#am Zeilenanfang. Sie dürfen Umlaute und andere Unicode-Zeichen enthalten (Abschnitt 2.1). - Zeilenenden sind CRLF oder LF (Abschnitt 2.2). Leere Zeilen sind erlaubt.
- Mehrfachnennung: Jedes Feld darf mehrfach vorkommen, außer Expires, Preferred-Languages und Bug-Bounty, die höchstens einmal stehen.
- Reihenfolge: Die Reihenfolge der Felder spielt keine Rolle, mit einer Ausnahme: Mehrere Contact-Felder stehen in der Reihenfolge Ihrer Vorliebe.
- Unbekannte Felder sind erlaubt. Leser müssen Felder ignorieren, die sie nicht kennen (Abschnitt 2.4). Ein falsch geschriebener Feldname ist deshalb kein Syntaxfehler, er wird einfach übergangen.
Die BSI TR-03183-3 verschärft zwei Punkte. Außerhalb von Kommentaren dürfen nur die ASCII-Zeichen 0x20 bis 0x7E stehen (4.2.1 c), also keine Umlaute in Werten; eine Domain wie müller.de gehört als xn--mller-kva.de in die Datei. Und vor jeden Feldblock gehört ein fester Kommentar wie # Our security addresses; die Wortlaute nennt diese Seite beim jeweiligen Feld.
Der Signaturblock
Eine signierte Datei ist eine OpenPGP-Klartext-Signatur. RFC 9116 empfiehlt sie (Abschnitt 2.3), die TR verlangt sie (4.2.10). Der lesbare Inhalt steht zwischen zwei Rahmen:
-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA512
Contact: mailto:security@beispiel.de
Expires: 2027-10-01T00:00:00.000Z
-----BEGIN PGP SIGNATURE-----
iHUEARYKAB0WIQ...
-----END PGP SIGNATURE-----
Eine Eigenheit der Klartext-Signatur: Zeilen, die mit einem Bindestrich beginnen, setzt GnuPG beim Signieren ein - voran (Dash-Escaping, im RFC als line-dash beschrieben). Eine Kommentar-Trennlinie wie #----- ist unproblematisch, eine Zeile, die direkt mit ----- beginnt, sieht nach dem Signieren anders aus. Wie Sie Schlüssel anlegen und signieren, steht in der Anleitung zu GnuPG.
Alle Felder auf einen Blick
Das Register der IANA für security.txt-Felder führt mit Stand 7. März 2026 zehn Felder. Acht stammen aus RFC 9116, CSAF kam 2023 dazu, Bug-Bounty im März 2026. Pflicht nach dem RFC sind nur Contact und Expires.
| Feld | RFC 9116 | BSI TR-03183-3 | Mehrfach |
|---|---|---|---|
| Contact | Pflicht | Pflicht, feste Reihenfolge (4.2.3) | ja |
| Expires | Pflicht | Pflicht, T und Z groß (4.2.9) | nein |
| Encryption | optional | Pflicht für jede Mailadresse (4.2.4) | ja |
| Canonical | optional | Pflicht (4.2.2) | ja |
| Preferred-Languages | optional | Pflicht, mit en (4.2.6) | nein |
| Policy | optional | Pflicht (4.2.7) | ja |
| Acknowledgments | optional | Soll (4.2.5) | ja |
| CSAF | IANA-Register | Soll (4.2.8) | ja |
| Hiring | optional | nicht geregelt | ja |
| Bug-Bounty | IANA-Register | nicht geregelt | nein |
Welcher der beiden Maßstäbe für Sie passt, erklärt die Anleitung. Kurz: RFC 9116 reicht für eine normale Unternehmensseite, die TR ist der Maßstab für Hersteller von Produkten mit digitalen Elementen.
Contact
Zweck: Contact sagt, wohin eine Schwachstelle gemeldet werden soll. Es ist das einzige Feld, für das die Datei überhaupt existiert.
Pflicht: Nach RFC 9116 muss mindestens ein Contact-Feld vorhanden sein (Abschnitt 2.5.3). Die TR legt die Reihenfolge fest: zuerst die Adresse des PSIRT-Funktionspostfachs, dann die des CSIRT-Postfachs, dann die Webadresse der Meldeseite (4.2.3 b bis d), eingeleitet mit dem Kommentar # Our security addresses.
Format: Der Wert ist immer eine URI. Mailadressen schreiben Sie mit mailto:, Telefonnummern mit tel:, Webseiten mit https://. Ein http://-Link ist nicht zulässig. Steht ein Pluszeichen oder ein anderes Sonderzeichen in der Adresse, wird es prozentkodiert, aus + wird %2B.
# Our security addresses
Contact: mailto:psirt@beispiel.de
Contact: mailto:csirt@beispiel.de
Contact: https://www.beispiel.de/security-contact/
Typischer Fehler: Die Adresse ohne mailto:, also Contact: security@beispiel.de. Menschen verstehen das, Prüfprogramme werten es als ungültige URI. Ebenso häufig: info@ als einziger Kontakt, wo die Meldung zwischen Anfragen und Rechnungen untergeht.
Praxistipp: RFC 9116 verweist für die Adresse auf RFC 2142, der security@ als Postfach für Sicherheitsfragen vorsieht. Wer der TR folgt, nimmt psirt@ und csirt@ (4.3.1 g und i). Eine Telefonnummer ist erlaubt, wird aber selten genutzt; wenn Sie eine nennen, muss dort auch jemand rangehen, der weiß, worum es geht. Was hinter der Adresse organisatorisch nötig ist, beschreibt die Seite Security-Kontakt einrichten.
Expires
Zweck: Expires nennt den Zeitpunkt, nach dem der Inhalt der Datei als veraltet gilt und nicht mehr benutzt werden soll (RFC 9116 Abschnitt 2.5.5). Der RFC begründet das deutlich: Veraltete Angaben können dazu führen, dass Meldungen falsch ankommen, und keine Datei kann besser sein als eine mit veralteten Daten (Abschnitt 5.3).
Pflicht: Nach RFC und TR muss das Feld genau einmal vorkommen. Der RFC empfiehlt, dass das Datum weniger als ein Jahr in der Zukunft liegt; nach der TR soll es höchstens ein Jahr sein (4.2.9 b).
Format: Datum und Uhrzeit nach RFC 3339, mit Zeitzone. Gültig sind etwa 2027-10-01T00:00:00.000Z oder 2027-10-01T00:00:00+02:00. Die TR verlangt zusätzlich ein großes T als Trenner und ein großes Z für UTC; andere Trenner sind nicht erlaubt (4.2.9 a). Das Beispiel im RFC selbst, 2021-12-31T18:37:07z mit kleinem z, wäre nach der TR also falsch.
Expires: 2027-10-01T00:00:00.000Z
Typische Fehler: Ein abgelaufenes Datum, ein Datum ohne Uhrzeit (2027-10-01), eine deutsche Schreibweise (01.10.2027) oder ein Datum mehrere Jahre voraus, damit man sich nicht kümmern muss. Prüfdienste melden alle vier. Was bei einem abgelaufenen Datum zu tun ist, steht unter security.txt abgelaufen.
Praxistipp: Setzen Sie ein Datum knapp unter einem Jahr und einen Kalendereintrag einige Wochen davor. Die TR verlangt ohnehin, die Angaben mindestens vierteljährlich zu prüfen (4.2.9 c); das ist der natürliche Termin, um auch Expires nachzuziehen. Nach jeder Änderung neu signieren.
Wer das nicht im Kalender haben will: Die Überwachung prüft die Datei jeden Tag und erinnert vor dem Ablauf, für 60 Euro netto im Jahr je Domain.
Encryption
Zweck: Encryption zeigt auf einen Schlüssel, mit dem Meldende vertraulich schreiben können (Abschnitt 2.5.4). Das ist wichtig, weil eine gute Meldung oft genau beschreibt, wie man in ein System kommt.
Pflicht: Nach RFC optional; empfohlen, sobald eine Mailadresse in Contact steht. Nach der TR Pflicht für jede Mailadresse aus Contact (4.2.4), mit dem Kommentar # Our OpenPGP keys.
Format: Der Schlüssel selbst darf nicht in der Datei stehen, nur eine URI, unter der er abrufbar ist. RFC 9116 erlaubt drei Formen: eine Webadresse mit https://, einen DNS-Eintrag vom Typ OPENPGPKEY (dns:...?type=OPENPGPKEY) oder einen Fingerabdruck (openpgp4fpr:...). Die TR ist strenger: Die Adresse muss direkt auf die Schlüsseldatei im ASCII-Armor-Format als .asc zeigen, nicht auf eine Seite mit Download-Knopf (4.3.2 a und d). Die Fingerabdrücke gehören zusätzlich auf Ihre Webseite (4.3.2 b).
# Our OpenPGP keys
Encryption: https://www.beispiel.de/.well-known/psirt.asc
Encryption: https://www.beispiel.de/.well-known/csirt.asc
Typischer Fehler: Encryption zeigt auf eine HTML-Seite, auf einen Schlüsselserver oder auf einen längst abgelaufenen Schlüssel. Ebenfalls häufig: Der Schlüssel gehört zu einer anderen Adresse als der in Contact.
Praxistipp: Der Schlüssel in Encryption ist nicht der Signaturschlüssel. Der RFC weist ausdrücklich darauf hin, dass Meldende nicht annehmen dürfen, dass beide identisch sind, und die TR empfiehlt einen eigenen Schlüssel nur zum Signieren (4.2.10 b). Je Funktionspostfach ein eigener Schlüssel (4.3.1 j). Wie Sie ihn erzeugen und als .asc exportieren, zeigt die GnuPG-Anleitung.
Canonical
Zweck: Canonical nennt die Adresse, unter der die Datei offiziell liegt (Abschnitt 2.5.2). Zusammen mit der Signatur belegt das, dass eine abgerufene Datei wirklich für diese Adresse gedacht ist und nicht von einer fremden Seite kopiert wurde.
Pflicht: Nach RFC optional, aber empfohlen, wenn die Datei signiert ist (Abschnitt 2.3). Nach der TR Pflicht (4.2.2), als Webadresse, die den echten Ort der Datei wiedergibt und ohne Weiterleitung erreichbar ist, eingeleitet mit # Our canonical URI.
Format: Eine Webadresse mit https://. Das Feld darf mehrfach stehen, wenn dieselbe Datei unter mehreren Adressen liegt.
# Our canonical URI
Canonical: https://www.beispiel.de/.well-known/security.txt
Canonical: https://beispiel.de/.well-known/security.txt
Typischer Fehler: Die Datei liegt unter www.beispiel.de, Canonical nennt aber nur beispiel.de. Der RFC sagt dazu klar: Steht die Adresse, unter der die Datei abgerufen wurde, in keinem Canonical-Feld, soll dem Inhalt nicht vertraut werden. Prüfdienste melden das als Fehler.
Praxistipp: Eine Datei gilt immer nur für die Domain, unter der sie abgerufen wird (Abschnitt 3.1). Liefern Sie dieselbe Datei unter mehreren Hostnamen aus, nennen Sie alle in Canonical. Nach der TR darf die kanonische Adresse nicht weiterleiten; wenn beispiel.de auf www.beispiel.de umleitet, ist nur die www-Adresse eine gültige kanonische Adresse.
Preferred-Languages
Zweck: Preferred-Languages nennt die Sprachen, in denen Sie Meldungen lesen können (Abschnitt 2.5.8). Fehlt das Feld, dürfen Meldende Englisch annehmen.
Pflicht: Nach RFC optional und höchstens einmal. Nach der TR Pflicht, mindestens mit en (4.2.6), eingeleitet mit # Our preferred languages.
Format: Sprachkürzel nach RFC 5646, mit Komma getrennt, zum Beispiel de, en oder de-AT. Es ist das einzige Feld, das mehrere Werte in einer Zeile erlaubt. Die Reihenfolge ist keine Rangfolge; alle genannten Sprachen gelten gleichrangig.
# Our preferred languages
Preferred-Languages: de, en
Typischer Fehler: Zwei Zeilen Preferred-Languages statt einer, ausgeschriebene Namen wie Deutsch, Englisch oder Ländercodes wie DE, UK. uk wäre als Sprachkürzel übrigens Ukrainisch.
Praxistipp: Nennen Sie nur Sprachen, in denen wirklich jemand eine technische Meldung lesen und beantworten kann. Englisch gehört fast immer dazu, weil viele Meldende international arbeiten.
Policy
Zweck: Policy verweist auf Ihre Richtlinie zur koordinierten Offenlegung, im Englischen Vulnerability Disclosure Policy (Abschnitt 2.5.7). Dort steht, was Sie als Schwachstelle werten, wie Sie mit Meldungen umgehen, welche Fristen Sie sich setzen und was Meldende zusagen bekommen. Der RFC empfiehlt, auch den Geltungsbereich der Datei dort zu beschreiben (Abschnitt 3.1).
Pflicht: Nach RFC optional, nach der TR Pflicht (4.2.7), eingeleitet mit # Our security policy.
Format: Eine Webadresse mit https://.
# Our security policy
Policy: https://www.beispiel.de/security-policy/
Typischer Fehler: Policy zeigt auf die Datenschutzerklärung oder auf allgemeine Nutzungsbedingungen. Beides ist keine Offenlegungsrichtlinie.
Praxistipp: Die Richtlinie ist auch Ihr bestes Mittel gegen Beg-Bounty-Mails: Ein klarer Satz, dass es kein Belohnungsprogramm gibt, und eine Definition dessen, was als gültige Schwachstelle gilt (TR 4.4.5), sparen viele Antworten. Einen Entwurf mit allen Pflichtinhalten der TR erzeugt die CVD-Vorlage.
Acknowledgments
Zweck: Acknowledgments verweist auf eine Seite, auf der Sie Meldenden danken, oft Hall of Fame genannt (Abschnitt 2.5.1). Der RFC rät, dort nur so viel über die Schwachstelle preiszugeben, dass niemand daraus einen Angriff ableiten kann.
Pflicht: Nach RFC optional, nach der TR ein Soll (4.2.5), eingeleitet mit # Our security acknowledgements page. Die TR verbindet das mit einer Zusage: Wer eine gültige Schwachstelle meldet, soll auf Wunsch mit Namen oder Alias auf dieser Seite erscheinen (4.4.4 f).
Format: Eine Webadresse mit https://.
# Our security acknowledgements page
Acknowledgments: https://www.beispiel.de/security-danke/
Typischer Fehler: Die britische Schreibweise Acknowledgements mit e. Das Feld heißt im RFC und im IANA-Register Acknowledgments. Weil Leser unbekannte Felder ignorieren müssen, wird die falsch geschriebene Zeile nicht als Fehler gemeldet, sondern still übergangen. Verwirrend: Die TR schreibt in ihrem Kommentar und in ihren Überschriften die britische Form. Im Kommentar ist das egal, im Feldnamen nicht.
Praxistipp: Eine Danksagungsseite darf am Anfang leer sein, mit einem Satz, wie man darauf kommt. Sie ist ein Anreiz ohne Geld, den ernsthafte Forschende schätzen.
CSAF
Zweck: CSAF verweist auf die Datei provider-metadata.json des Common Security Advisory Framework, eines OASIS-Standards für maschinenlesbare Sicherheitshinweise. Über diese Datei finden Werkzeuge Ihre Advisories automatisch, etwa um Kunden zu zeigen, welche ihrer Geräte betroffen sind.
Pflicht: Nicht im RFC, seit dem 15. Februar 2023 im IANA-Register, verwaltet von OASIS. Nach der TR ein Soll (4.2.8), eingeleitet mit # Our security advisories. Nach CSAF 2.0 ist das Feld eine von drei Möglichkeiten, wie ein CSAF Provider seine Metadaten auffindbar macht (Anforderungen 8 bis 10, mindestens eine ist nötig).
Format: Eine Webadresse mit https://, die direkt auf die provider-metadata.json zeigt. Das Feld darf mehrfach stehen, etwa nach einer Übernahme; CSAF 2.0 rät davon aber ab und verlangt, dass eine Adresse unter /.well-known/csaf/ dann als erstes CSAF-Feld steht.
# Our security advisories
CSAF: https://www.beispiel.de/.well-known/csaf/provider-metadata.json
Typischer Fehler: CSAF zeigt auf eine HTML-Seite mit Sicherheitshinweisen oder auf ein PDF-Archiv. Das Feld ist ausschließlich für die JSON-Metadaten gedacht.
Praxistipp: Setzen Sie das Feld nur, wenn Sie tatsächlich CSAF-Dokumente veröffentlichen. Ein Verweis ins Leere ist schlechter als kein Feld. Für Hersteller, die Sicherheitshinweise ohnehin regelmäßig herausgeben, ist CSAF der Weg, sie maschinenlesbar zu machen.
Hiring
Zweck: Hiring verweist auf Stellenangebote im Sicherheitsbereich (Abschnitt 2.5.6). Wer sich eine security.txt ansieht, ist oft genau die Person, die Sie suchen.
Pflicht: Nach RFC optional, in der TR nicht geregelt.
Format: Eine Webadresse mit https://.
Hiring: https://www.beispiel.de/karriere/it-sicherheit/
Typischer Fehler: Hiring zeigt auf die allgemeine Karriereseite, auf der seit Monaten keine Sicherheitsstelle mehr steht.
Praxistipp: Nur setzen, wenn es aktuell passende Stellen gibt, und beim vierteljährlichen Prüfen mitnehmen.
Bug-Bounty
Zweck: Bug-Bounty sagt maschinenlesbar, ob Sie für Meldungen Geld zahlen. Mit True zeigen Sie an, dass Meldende über ein Bug-Bounty-Programm eine Belohnung bekommen können, mit False, dass es keine gibt. Das Register verweist dafür auf den CERT Guide to Coordinated Vulnerability Disclosure der Carnegie Mellon University.
Pflicht: Nicht im RFC, seit dem 7. März 2026 im IANA-Register, höchstens einmal. In der TR nicht geregelt, weil sie älter ist.
Format: True oder False.
Bug-Bounty: False
Typischer Fehler: Werte wie No, none oder ein Link zum Programm. Das Register kennt nur True und False; Einzelheiten eines Programms gehören in die Richtlinie.
Praxistipp: Bug-Bounty: False ist die einfachste Maßnahme gegen Mails, die nach einer Prämie fragen. Es hält nicht alle ab, gibt Ihrer Antwort aber eine Grundlage. Mehr dazu unter Spam nach der security.txt.
Vollständiges Beispiel mit allen Feldern
So sieht eine Datei aus, die alle zehn Felder nutzt und den Aufbau der TR einhält. Vor dem Veröffentlichen wird sie signiert; die Signaturrahmen fehlen hier der Übersicht halber. Weitere fertige Dateien, auch die kürzeste gültige und eine mit typischen Fehlern, finden Sie bei den Beispielen.
# Our canonical URI
Canonical: https://www.beispiel.de/.well-known/security.txt
# Our security addresses
Contact: mailto:psirt@beispiel.de
Contact: mailto:csirt@beispiel.de
Contact: https://www.beispiel.de/security-contact/
# Our OpenPGP keys
Encryption: https://www.beispiel.de/.well-known/psirt.asc
Encryption: https://www.beispiel.de/.well-known/csirt.asc
# Our security acknowledgements page
Acknowledgments: https://www.beispiel.de/security-danke/
# Our preferred languages
Preferred-Languages: de, en
# Our security policy
Policy: https://www.beispiel.de/security-policy/
# Our security advisories
CSAF: https://www.beispiel.de/.well-known/csaf/provider-metadata.json
Hiring: https://www.beispiel.de/karriere/it-sicherheit/
Bug-Bounty: False
Expires: 2027-10-01T00:00:00.000Z
Ob Ihre eigene Datei diese Regeln einhält, zeigt der Check in wenigen Sekunden, wahlweise nach RFC 9116 oder nach der TR, einschließlich Signatur und Schlüssel.
Häufige Fragen
Welche Felder muss eine security.txt mindestens haben?
Nach RFC 9116 nur zwei: Contact, mindestens einmal, und Expires, genau einmal. Nach der BSI TR-03183-3 zusätzlich Canonical, Encryption für jede Mailadresse, Preferred-Languages mit Englisch, Policy und eine Signatur.
Welches Datumsformat braucht Expires?
RFC 3339 mit Uhrzeit und Zeitzone, zum Beispiel 2027-10-01T00:00:00.000Z. Nach der TR müssen T und Z groß geschrieben sein. Ein Datum ohne Uhrzeit oder in deutscher Schreibweise ist ungültig.
Heißt das Feld Acknowledgments oder Acknowledgements?
Acknowledgments, ohne e nach dem g. So steht es in RFC 9116 und im IANA-Register. Die britische Schreibweise ist für Prüfprogramme ein unbekanntes Feld und wird ignoriert.
Darf ich mehrere Contact-Felder angeben?
Ja, so viele Sie brauchen, jedes in einer eigenen Zeile. Die Reihenfolge zählt: Das erste Feld ist der bevorzugte Weg. Nach der TR stehen PSIRT-Postfach, CSIRT-Postfach und Meldeseite in dieser Reihenfolge.
Kann ich den PGP-Schlüssel direkt in die security.txt schreiben?
Nein. RFC 9116 verbietet Schlüssel im Feld Encryption ausdrücklich. Das Feld enthält nur die Adresse, unter der der Schlüssel abrufbar ist, nach der TR direkt als .asc-Datei.
Muss ich das Feld CSAF setzen?
Nur wenn Sie Sicherheitshinweise im CSAF-Format veröffentlichen. Die TR empfiehlt es Herstellern, verlangt es aber nicht. Ein Verweis auf eine nicht vorhandene Datei schadet mehr, als er nützt.
Ist die Groß- und Kleinschreibung der Feldnamen wichtig?
Nein, Feldnamen sind nach RFC 9116 unabhängig von Groß- und Kleinschreibung. Bei Werten kann sie zählen, etwa beim T und Z im Datum nach der TR.
Was passiert mit Feldern, die nicht im Standard stehen?
Sie sind erlaubt und werden von Lesern ignoriert, die sie nicht kennen. Neue Felder kommen über das Register der IANA hinzu, zuletzt Bug-Bounty im März 2026.
Quellen
- RFC 9116: A File Format to Aid in Security Vulnerability Disclosure, Abschnitte 2, 2.1 bis 2.5.8, 3.1, 4 und 5.3, IETF, April 2022.
- IANA-Register security.txt Fields, Stand 7. März 2026.
- BSI TR-03183-3 Vulnerability Reports and Notifications, Version 1.0.0, Abschnitte 4.2.1 bis 4.2.10, 4.3.1, 4.3.2, 4.4.4 und 4.4.5, Bundesamt für Sicherheit in der Informationstechnik, 20. August 2025.
- Common Security Advisory Framework Version 2.0, Abschnitte 7.1.7 bis 7.1.10 und 7.2.2, OASIS Standard, 18. November 2022.
- RFC 3339: Date and Time on the Internet: Timestamps, IETF, Juli 2002.
- RFC 5646: Tags for Identifying Languages, IETF, September 2009.
- RFC 2142: Mailbox Names for Common Services, Roles and Functions, Abschnitt 4, IETF, Mai 1997.