security.txt
security.txt to mały plik tekstowy zdefiniowany w RFC 9116 i udostępniany pod /.well-known/security.txt, który informuje badaczy bezpieczeństwa, jak zgłosić podatność właścicielowi strony lub produktu.
Ostatnia aktualizacja: 13 listopada 2026
security.txt to zwykły plik tekstowy, który organizacja publikuje na swojej stronie internetowej, aby poinformować, jak zgłosić jej podatność bezpieczeństwa. Definiuje go RFC 9116, informacyjny dokument RFC opublikowany w kwietniu 2022 r. przez Edwina Foudila i Yakova Shafranovicha. Badacz, który znajdzie problem, pobiera https://example.com/.well-known/security.txt i otrzymuje adres kontaktowy, link do polityki ujawniania i opcjonalnie klucz szyfrujący, zamiast zgadywać ogólny adres wsparcia.
Gdzie go umieścić
- Lokalizacja:
/.well-known/security.txt, udostępniany przez HTTPS jakotext/plainz kodowaniem UTF-8. - Starsza ścieżka: plik w katalogu głównym
/security.txtjest dozwolony ze względu na zgodność i może przekierowywać do ścieżki well-known. Jeśli istnieją oba, pierwszeństwo ma plik well-known. - Zakres: plik obejmuje tylko dokładnie ten host, z którego jest udostępniany, a nie subdomeny ani domenę nadrzędną.
www.example.comishop.example.compotrzebują własnych plików lub przekierowania.
Pola
Każdy wiersz to para Name: value; w nazwach pól wielkość liter nie ma znaczenia, a wiersze zaczynające się od # są komentarzami. Każdy adres URI w polu musi używać HTTPS.
| Pole | Wymagane | Co zawiera |
|---|---|---|
| Contact | Tak | Adres mailto:, tel: lub https:. Może się powtarzać; kolejność wskazuje preferencję |
| Expires | Tak | Dokładnie raz, jako data i godzina w formacie RFC 3339. Zalecane mniej niż rok naprzód |
| Encryption | Nie | Link do klucza do szyfrowania zgłoszeń, a nie sam klucz |
| Policy | Nie | Link do polityki ujawniania podatności |
| Acknowledgments | Nie | Link do strony z podziękowaniami dla badaczy |
| Preferred-Languages | Nie | Najwyżej raz, znaczniki języka takie jak en, fi. Przy braku pola przyjmuje się angielski |
| Canonical | Nie | Adresy URI, pod którymi plik ma się znajdować; używać razem z podpisem |
| Hiring | Nie | Link do ofert pracy w bezpieczeństwie |
Inne pola są zarejestrowane w IANA w rejestrze pól security.txt, a czytniki muszą ignorować pola, których nie rozpoznają. Dla zespołów bezpieczeństwa produktu ważne są dwa: CSAF, zdefiniowane w standardzie OASIS CSAF 2.0, które wskazuje plik provider-metadata.json dostawcy CSAF, aby narzędzia mogły znaleźć Państwa biuletyny do odczytu maszynowego (zob. CSAF), oraz Bug-Bounty z przewodnika CERT po skoordynowanym ujawnianiu podatności.
Pełny przykład
# 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
Wymagane są tylko dwa wiersze Contact i wiersz Expires. Minimalny plik ma trzy wiersze.
Expires
Pole Expires jest wymagane po to, by zapomniany plik przestał być uznawany za wiarygodny. RFC 9116 zaleca datę przypadającą za mniej niż rok, a badacz powinien traktować wygasły plik jako nieaktualny. W praktyce warto odnawiać go według harmonogramu: sprawdzi się przypomnienie w kalendarzu albo job CI, który kończy się błędem miesiąc przed tą datą. Wygasły security.txt mówi badaczom, że nikt nie czyta tej skrzynki.
Podpisywanie
RFC 9116 zaleca podpisanie pliku podpisem OpenPGP w postaci jawnego tekstu i użycie pola Canonical w podpisanym pliku, aby podpis uwierzytelniał też miejsce, w którym plik ma się znajdować. Podpisany plik obejmuje te same pola:
-----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 pozostawia badaczom sprawdzenie, czy klucz podpisujący rzeczywiście należy do Państwa, więc warto to ułatwić, np. publikując odcisk klucza w innym miejscu niż ten sam serwer WWW.
Czego security.txt nie robi
- Nie daje zgody na testowanie. RFC mówi to wprost; to, co badacze mogą robić, należy do polityki ujawniania.
- Nie jest polityką. Wskazuje na nią. Co zawiera polityka, wraz z szablonem, opisuje strona skoordynowane ujawnianie podatności.
- Przyciąga szum. Publiczny adres otrzymuje spam i automatyczne raporty ze skanerów, dlatego należy kierować go do zespołu, który prowadzi triaż, a nie do skrzynki jednej osoby.
security.txt jest przeznaczony dla stron internetowych i domen. Projekty open source na GitHubie zwykle używają w tym samym celu pliku SECURITY.md w repozytorium.
Związek z CRACI
CRACI nie przyjmuje zgłoszeń podatności i nie publikuje plików security.txt. Kto obsługuje zgłoszenia i jak, opisują strony PSIRT i skoordynowane ujawnianie podatności.