O 138% więcej zgłoszonych CVE dziennie w 2026 niż przed rokiem.Nowość: zawsze aktywne Fixboxes. Podatne zależności, naprawione i zweryfikowane.
← Powrót do słownika

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 jako text/plain z kodowaniem UTF-8.
  • Starsza ścieżka: plik w katalogu głównym /security.txt jest 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.com i shop.example.com potrzebują 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.

PoleWymaganeCo zawiera
ContactTakAdres mailto:, tel: lub https:. Może się powtarzać; kolejność wskazuje preferencję
ExpiresTakDokładnie raz, jako data i godzina w formacie RFC 3339. Zalecane mniej niż rok naprzód
EncryptionNieLink do klucza do szyfrowania zgłoszeń, a nie sam klucz
PolicyNieLink do polityki ujawniania podatności
AcknowledgmentsNieLink do strony z podziękowaniami dla badaczy
Preferred-LanguagesNieNajwyżej raz, znaczniki języka takie jak en, fi. Przy braku pola przyjmuje się angielski
CanonicalNieAdresy URI, pod którymi plik ma się znajdować; używać razem z podpisem
HiringNieLink 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.