security.txt
security.txt on väike tekstifail, mis on määratletud standardis RFC 9116 ja asub aadressil /.well-known/security.txt ning ütleb turvauurijatele, kuidas veebisaidi või toote omanikule haavatavusest teatada.
Viimati uuendatud: 13. november 2026
security.txt on lihttekstifail, mille organisatsioon avaldab oma veebisaidil, et öelda, kuidas talle turvahaavatavusest teatada. See on määratletud dokumendis RFC 9116, mis on Edwin Foudili ja Yakov Shafranovichi aprillis 2022 avaldatud informatiivne RFC. Uurija, kes leiab probleemi, laadib alla faili https://example.com/.well-known/security.txt ja saab kontaktaadressi, lingi avalikustamispoliitikale ja soovi korral krüpteerimisvõtme, selle asemel et üldist tugiaadressi ära arvata.
Kuhu see käib
- Asukoht:
/.well-known/security.txt, serveeritakse HTTPS-i kaudu tüübigatext/plainja UTF-8 märgistikuga. - Pärandtee: ühilduvuse huvides on lubatud fail juurtasemel
/security.txtja see võib suunata ümber well-known teele. Kui mõlemad on olemas, kehtib well-known fail. - Ulatus: fail katab ainult täpselt seda hosti, kust seda serveeritakse, mitte alamdomeene ega ülemdomeeni.
www.example.comjashop.example.comvajavad kumbki oma faili või ümbersuunamist.
Väljad
Iga rida on paar Name: value; väljanimed ei ole tõstutundlikud ja märgiga # algavad read on kommentaarid. Iga välja veebi-URI peab kasutama HTTPS-i.
| Väli | Kohustuslik | Mida see sisaldab |
|---|---|---|
| Contact | Jah | Aadress mailto:, tel: või https:. Võib korduda; järjekord näitab eelistust |
| Expires | Jah | Täpselt üks kord, RFC 3339 kuupäev-kellaajana. Soovitatav vähem kui aasta ette |
| Encryption | Ei | Link aruannete krüpteerimise võtmele, mitte võti ise |
| Policy | Ei | Link haavatavuste avalikustamise poliitikale |
| Acknowledgments | Ei | Link lehele, mis tänab uurijaid |
| Preferred-Languages | Ei | Kõige rohkem üks kord, keelesildid nagu en, fi. Kui puudub, eeldatakse inglise keelt |
| Canonical | Ei | URI-d, kust see fail on mõeldud leidmiseks; kasutage koos allkirjaga |
| Hiring | Ei | Link turvavaldkonna vabadele töökohtadele |
Muud väljad on registreeritud IANA security.txt väljade registris ja lugejad peavad tundmatuid välju eirama. Tooteturbe meeskondadele on olulised kaks: CSAF, mille määratleb OASIS CSAF 2.0 standard ja mis osutab CSAF-i pakkuja failile provider-metadata.json, et tööriistad leiaksid teie masinloetavad turvateated (vt CSAF), ja Bug-Bounty, mis pärineb CERT-i koordineeritud haavatavuste avalikustamise juhendist.
Täisnäide
# 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
Kohustuslikud on ainult kaks rida Contact ja rida Expires. Minimaalne fail on kolm rida pikk.
Expires
Expires on kohustuslik, et unustatud faili enam ei usaldataks. RFC 9116 soovitab kuupäeva, mis on vähem kui aasta tulevikus, ja uurija peaks aegunud faili käsitlema vananenuna. Praktikas uuendage seda graafiku alusel: sobivad nii kalendrimeeldetuletus kui ka CI-töö, mis kukub läbi kuu aega enne kuupäeva. Aegunud security.txt ütleb uurijatele, et keegi postkasti ei loe.
Allkirjastamine
RFC 9116 soovitab faili allkirjastada OpenPGP lihttekstallkirjaga (cleartext signature) ja kasutada allkirjastatud failis välja Canonical, et allkiri autendiks ka koha, kust fail on mõeldud leidmiseks. Allkirjastatud fail ümbritseb samu välju:
-----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-----
RFC jätab uurijate ülesandeks kontrollida, et allkirjastamisvõti kuulub tõesti teile, seega tehke see lihtsaks, näiteks avaldades võtme sõrmejälje kusagil mujal kui samas veebiserveris.
Mida security.txt ei tee
- See ei anna luba testida. RFC ütleb seda selgesõnaliselt; mida uurijad tohivad teha, kuulub teie avalikustamispoliitikasse.
- See ei ole poliitika. See osutab poliitikale. Mida poliitika sisaldab, koos mallega, on kirjas artiklis koordineeritud haavatavuste avalikustamine.
- See tõmbab ligi müra. Avalik aadress saab rämpsposti ja automaatskannerite raporteid, nii et suunake see meeskonnale, kes teeb triaaži, mitte ühe inimese postkasti.
security.txt on mõeldud veebisaitidele ja domeenidele. GitHubis olevad avatud lähtekoodiga projektid kasutavad samal eesmärgil tavaliselt repositooriumis faili SECURITY.md.
Kuidas see CRACI-ga seostub
CRACI ei võta vastu haavatavusteateid ega avalda security.txt faile. Kes teateid käsitleb ja kuidas, on kirjas artiklites PSIRT ja koordineeritud haavatavuste avalikustamine.