security.txt
security.txt on RFC 9116:ssa määritelty pieni tekstitiedosto, joka tarjotaan polussa /.well-known/security.txt ja joka kertoo tietoturvatutkijoille, miten haavoittuvuudesta ilmoitetaan verkkosivuston tai tuotteen omistajalle.
Päivitetty viimeksi: 13. marraskuuta 2026
security.txt on tekstitiedosto, jonka organisaatio julkaisee verkkosivustollaan kertoakseen, miten sille ilmoitetaan tietoturvahaavoittuvuudesta. Se on määritelty RFC 9116:ssa, Edwin Foudilin ja Yakov Shafranovichin huhtikuussa 2022 julkaisemassa Informational-tyyppisessä RFC:ssä. Ongelman löytänyt tutkija hakee osoitteen https://example.com/.well-known/security.txt ja saa yhteysosoitteen, linkin julkistamiskäytäntöön ja halutessasi salausavaimen sen sijaan, että hänen pitäisi arvata yleinen tukiosoite.
Mihin se sijoitetaan
- Sijainti:
/.well-known/security.txt, tarjottuna HTTPS:n yli muodossatext/plainUTF-8-merkistöllä. - Vanha polku: ylimmän tason
/security.txt-tiedosto on sallittu yhteensopivuuden vuoksi, ja se voi ohjata well-known-polkuun. Jos molemmat ovat olemassa, well-known-polun tiedosto voittaa. - Kattavuus: tiedosto koskee vain täsmälleen sitä isäntää, josta se tarjotaan, ei aliverkkotunnuksia eikä ylätason verkkotunnusta.
www.example.comjashop.example.comtarvitsevat kumpikin oman tiedoston tai uudelleenohjauksen.
Kentät
Jokainen rivi on Name: value -pari; kenttien nimissä kirjainkoolla ei ole väliä, ja #-merkillä alkavat rivit ovat kommentteja. Jokaisen kentässä olevan web-URI:n on käytettävä HTTPS:ää.
| Kenttä | Pakollinen | Mitä se sisältää |
|---|---|---|
| Contact | Kyllä | mailto:-, tel:- tai https:-osoite. Voi toistua; järjestys kertoo etusijan |
| Expires | Kyllä | Tasan kerran, RFC 3339 -muotoisena päivämääränä ja kellonaikana. Suositus alle vuoden päähän |
| Encryption | Ei | Linkki ilmoitusten salaamiseen käytettävään avaimeen, ei itse avain |
| Policy | Ei | Linkki haavoittuvuuksien julkistamiskäytäntöön |
| Acknowledgments | Ei | Linkki sivulle, jolla tutkijoita kiitetään |
| Preferred-Languages | Ei | Enintään kerran, kielitunnisteet kuten en, fi. Englanti oletetaan, jos kenttä puuttuu |
| Canonical | Ei | URI:t, joista tämä tiedosto on tarkoitus löytää; käytä allekirjoituksen kanssa |
| Hiring | Ei | Linkki tietoturva-alan avoimiin työpaikkoihin |
Muut kentät rekisteröidään IANAn security.txt-kenttärekisteriin, ja lukijoiden on ohitettava kentät, joita ne eivät tunnista. Kaksi on tärkeitä tuoteturvallisuustiimeille: OASIS CSAF 2.0 -standardin määrittelemä CSAF, joka osoittaa CSAF-tarjoajan provider-metadata.json-tiedostoon, jotta työkalut löytävät koneluettavat tietoturvatiedotteesi (katso CSAF), sekä CERTin koordinoidun haavoittuvuuksien julkistamisen oppaasta peräisin oleva Bug-Bounty.
Täysi esimerkki
# 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
Vain kaksi Contact-riviä ja Expires-rivi ovat pakollisia. Pienin mahdollinen tiedosto on kolmen rivin mittainen.
Expires
Expires on pakollinen, jotta unohdettuun tiedostoon lakataan luottamasta. RFC 9116 suosittelee alle vuoden päässä olevaa päivämäärää, ja tutkijan pitäisi pitää vanhentunutta tiedostoa vanhentuneena tietona. Käytännössä uusi se aikataulun mukaan: kalenterimuistutus tai CI-job, joka epäonnistuu kuukautta ennen päivämäärää, toimivat molemmat. Vanhentunut security.txt kertoo tutkijoille, ettei kukaan lue postilaatikkoa.
Allekirjoitus
RFC 9116 suosittelee tiedoston allekirjoittamista OpenPGP:n selkotekstiallekirjoituksella ja Canonical-kentän käyttämistä allekirjoitetussa tiedostossa, jotta allekirjoitus todentaa myös sen, mistä tiedosto on tarkoitus löytää. Allekirjoitettu tiedosto ympäröi samat kentät:
-----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ättää tutkijoiden tehtäväksi tarkistaa, että allekirjoitusavain todella kuuluu sinulle, joten tee se helpoksi esimerkiksi julkaisemalla avaimen sormenjälki muualla kuin samalla verkkopalvelimella.
Mitä security.txt ei tee
- Se ei anna lupaa testata. RFC sanoo tämän suoraan; se, mitä tutkijat saavat tehdä, kuuluu julkistamiskäytäntöösi.
- Se ei ole käytäntö. Se osoittaa käytäntöön. Käytännön sisältö pohjineen löytyy sivulta koordinoitu haavoittuvuuksien julkistaminen.
- Se houkuttelee kohinaa. Julkiseen osoitteeseen tulee roskapostia ja automaattisten skannereiden ilmoituksia, joten ohjaa se tiimille, joka tekee triagen, eikä yhden ihmisen postilaatikkoon.
security.txt on tarkoitettu verkkosivustoille ja verkkotunnuksille. GitHubissa olevat avoimen lähdekoodin projektit käyttävät samaan tarkoitukseen yleensä repositorion SECURITY.md-tiedostoa.
Miten CRACI liittyy tähän
CRACI ei vastaanota haavoittuvuusilmoituksia eikä julkaise security.txt-tiedostoja. Sitä, kuka ilmoitukset käsittelee ja miten, käsitellään sivuilla PSIRT ja koordinoitu haavoittuvuuksien julkistaminen.