security.txt
security.txt is een klein tekstbestand, gedefinieerd in RFC 9116 en geserveerd op /.well-known/security.txt, dat beveiligingsonderzoekers vertelt hoe ze een kwetsbaarheid melden aan de eigenaar van een website of product.
Laatst bijgewerkt: 13 november 2026
security.txt is een platte-tekstbestand dat een organisatie op haar website publiceert om te zeggen hoe u een beveiligingskwetsbaarheid bij haar meldt. Het is gedefinieerd in RFC 9116, een Informational RFC die in april 2022 is gepubliceerd door Edwin Foudil en Yakov Shafranovich. Een onderzoeker die een probleem vindt, haalt https://example.com/.well-known/security.txt op en krijgt een contactadres, een link naar het disclosurebeleid en eventueel een encryptiesleutel, in plaats van te gokken naar een algemeen supportadres.
Waar het staat
- Locatie:
/.well-known/security.txt, geserveerd via HTTPS alstext/plainmet de tekenset UTF-8. - Oud pad: een bestand op het hoogste niveau,
/security.txt, is toegestaan voor compatibiliteit en mag doorverwijzen naar het well-known-pad. Bestaan ze allebei, dan geldt het well-known-bestand. - Scope: het bestand geldt alleen voor de exacte host waarvan het wordt geserveerd, niet voor subdomeinen of het bovenliggende domein.
www.example.comenshop.example.comhebben elk een eigen bestand of een doorverwijzing nodig.
Velden
Elke regel is een paar Name: value; veldnamen zijn niet hoofdlettergevoelig en regels die met # beginnen, zijn commentaar. Elke web-URI in een veld moet HTTPS gebruiken.
| Veld | Verplicht | Wat het bevat |
|---|---|---|
| Contact | Ja | Een adres met mailto:, tel: of https:. Mag herhaald worden; de volgorde toont de voorkeur |
| Expires | Ja | Precies één keer, als RFC 3339-datum en -tijd. Aanbevolen: minder dan een jaar vooruit |
| Encryption | Nee | Een link naar de sleutel om meldingen te versleutelen, niet de sleutel zelf |
| Policy | Nee | Een link naar het beleid voor de openbaarmaking van kwetsbaarheden |
| Acknowledgments | Nee | Een link naar een pagina die onderzoekers bedankt |
| Preferred-Languages | Nee | Hoogstens één keer, taaltags zoals en, fi. Ontbreekt het, dan wordt Engels aangenomen |
| Canonical | Nee | De URI's waar dit bestand hoort te staan; gebruik het met een handtekening |
| Hiring | Nee | Een link naar vacatures in beveiliging |
Andere velden zijn bij IANA geregistreerd in het register van security.txt-velden, en lezers moeten velden negeren die ze niet herkennen. Twee zijn van belang voor productbeveiligingsteams: CSAF, gedefinieerd door de OASIS-standaard CSAF 2.0, dat verwijst naar het provider-metadata.json van een CSAF-provider zodat tools uw machineleesbare advisories kunnen vinden (zie CSAF), en Bug-Bounty, uit de CERT-gids voor coordinated vulnerability disclosure.
Een volledig voorbeeld
# Security contact for example.com
Contact: mailto:[email protected]
Contact: https://example.com/security/report
Expires: 2027-10-31T23:00:00.000Z
Encryption: https://example.com/.well-known/pgp-key.txt
Policy: https://example.com/security/disclosure-policy
Acknowledgments: https://example.com/security/hall-of-fame
Preferred-Languages: en, fi
Canonical: https://example.com/.well-known/security.txt
Hiring: https://example.com/careers/security
CSAF: https://example.com/.well-known/csaf/provider-metadata.json
Alleen de twee Contact-regels en de Expires-regel zijn verplicht. Een minimaal bestand is drie regels lang.
Expires
Expires is verplicht zodat een vergeten bestand niet langer wordt vertrouwd. RFC 9116 raadt een datum aan die minder dan een jaar in de toekomst ligt, en een onderzoeker moet een verlopen bestand als verouderd beschouwen. Vernieuw het in de praktijk volgens een schema: een agendaherinnering of een CI-job die een maand voor de datum faalt, werken allebei. Een verlopen security.txt vertelt onderzoekers dat niemand de inbox leest.
Ondertekening
RFC 9116 raadt aan het bestand te ondertekenen met een OpenPGP-cleartexthandtekening, en Canonical te gebruiken in een ondertekend bestand, zodat de handtekening ook bevestigt waar het bestand hoort te staan. Het ondertekende bestand omsluit dezelfde velden:
-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA256
Contact: mailto:[email protected]
Expires: 2027-10-31T23:00:00.000Z
Canonical: https://example.com/.well-known/security.txt
-----BEGIN PGP SIGNATURE-----
...
-----END PGP SIGNATURE-----
De RFC laat het aan onderzoekers over om te controleren of de ondertekeningssleutel echt van u is, dus maak dat makkelijk, bijvoorbeeld door de fingerprint van de sleutel ergens anders te publiceren dan op dezelfde webserver.
Wat security.txt niet doet
- Het geeft geen toestemming om te testen. De RFC zegt dat expliciet; wat onderzoekers mogen doen, hoort in uw disclosurebeleid.
- Het is geen beleid. Het verwijst naar een beleid. Wat een beleid bevat, met een sjabloon, staat in coordinated vulnerability disclosure.
- Het trekt ruis aan. Een openbaar adres ontvangt spam en geautomatiseerde scannermeldingen, dus leid het naar een team dat trieert, niet naar de inbox van één persoon.
security.txt is bedoeld voor websites en domeinen. Open-sourceprojecten op GitHub gebruiken voor hetzelfde doel meestal een SECURITY.md-bestand in de repository.
Hoe dit zich verhoudt tot CRACI
CRACI ontvangt geen kwetsbaarheidsmeldingen en publiceert geen security.txt-bestanden. Wie meldingen afhandelt en hoe, staat in PSIRT en coordinated vulnerability disclosure.