security.txt
security.txt는 RFC 9116에 정의되고 /.well-known/security.txt에 게시되는 작은 텍스트 파일로, 보안 연구자에게 웹사이트나 제품 소유자에게 취약점을 보고하는 방법을 알려 줍니다.
최종 업데이트: 2026년 11월 13일
security.txt는 조직이 웹사이트에 게시해 보안 취약점을 보고하는 방법을 알려 주는 일반 텍스트 파일입니다. Edwin Foudil과 Yakov Shafranovich가 2022년 4월에 발행한 Informational RFC인 RFC 9116에 정의되어 있습니다. 문제를 발견한 연구자는 https://example.com/.well-known/security.txt를 가져와, 일반 지원 주소를 추측하는 대신 연락처 주소, 공개 정책 링크, 그리고 선택적으로 암호화 키를 얻습니다.
파일 위치
- 위치:
/.well-known/security.txt. HTTPS를 통해 UTF-8 문자 집합의text/plain으로 제공합니다. - 레거시 경로: 호환성을 위해 최상위
/security.txt의 파일도 허용되며, well-known 경로로 리디렉션할 수 있습니다. 둘 다 있으면 well-known 쪽이 우선합니다. - 범위: 파일은 제공되는 정확한 호스트만 다루며, 하위 도메인이나 상위 도메인은 포함하지 않습니다.
www.example.com과shop.example.com에는 각각 자체 파일이나 리디렉션이 필요합니다.
필드
각 줄은 Name: value 쌍입니다. 필드 이름은 대소문자를 구분하지 않으며, #으로 시작하는 줄은 주석입니다. 필드의 모든 웹 URI는 HTTPS를 사용해야 합니다.
| 필드 | 필수 | 내용 |
|---|---|---|
| Contact | 예 | mailto:, tel: 또는 https: 주소. 반복 가능하며 순서가 선호도를 나타냄 |
| Expires | 예 | 정확히 한 번, RFC 3339 날짜-시간으로. 1년 이내의 날짜 권장 |
| Encryption | 아니요 | 보고를 암호화할 키 자체가 아니라 키에 대한 링크 |
| Policy | 아니요 | 취약점 공개 정책에 대한 링크 |
| Acknowledgments | 아니요 | 연구자에게 감사를 표하는 페이지에 대한 링크 |
| Preferred-Languages | 아니요 | 최대 한 번, en, fi 같은 언어 태그. 없으면 영어로 간주 |
| Canonical | 아니요 | 이 파일이 있어야 할 URI. 서명과 함께 사용 |
| Hiring | 아니요 | 보안 관련 채용 공고에 대한 링크 |
그 밖의 필드는 IANA의 security.txt 필드 레지스트리에 등록되어 있으며, 읽는 쪽은 인식하지 못하는 필드를 무시해야 합니다. 제품 보안팀에 중요한 필드는 두 가지입니다. OASIS CSAF 2.0 표준이 정의한 CSAF는 CSAF 제공자의 provider-metadata.json을 가리켜 도구가 기계 판독형 권고를 찾을 수 있게 하고(CSAF 참조), Bug-Bounty는 CERT의 조정된 취약점 공개 가이드에서 나온 필드입니다.
전체 예시
# 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
필수는 두 개의 Contact 줄과 Expires 줄뿐입니다. 최소한의 파일은 세 줄입니다.
Expires
Expires는 잊힌 파일이 더 이상 신뢰받지 않도록 하기 위해 필수입니다. RFC 9116은 1년 이내의 미래 날짜를 권장하며, 연구자는 만료된 파일을 오래된 것으로 취급해야 합니다. 실무에서는 일정에 따라 갱신하세요. 캘린더 알림이나 날짜 한 달 전에 실패하는 CI 작업 모두 효과적입니다. 만료된 security.txt는 아무도 수신함을 읽지 않는다고 연구자에게 알리는 것과 같습니다.
서명
RFC 9116은 OpenPGP 평문 서명으로 파일에 서명하고, 서명된 파일에 Canonical을 사용해 서명이 파일이 있어야 할 위치까지 인증하도록 권장합니다. 서명된 파일은 같은 필드를 감쌉니다.
-----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는 서명 키가 실제로 여러분의 것인지 확인하는 일을 연구자에게 맡기므로, 예를 들어 같은 웹 서버가 아닌 다른 곳에 키의 지문을 게시해 확인을 쉽게 해 주세요.
security.txt가 하지 않는 일
- 테스트 권한을 부여하지 않습니다. RFC가 이를 명시적으로 밝히며, 연구자가 할 수 있는 일은 공개 정책에 담아야 합니다.
- 정책이 아닙니다. 정책을 가리킬 뿐입니다. 정책에 담을 내용과 템플릿은 조정된 취약점 공개에 있습니다.
- 노이즈를 부릅니다. 공개 주소에는 스팸과 자동 스캐너 보고가 들어오므로, 한 사람의 수신함이 아니라 분류를 담당하는 팀으로 전달하세요.
security.txt는 웹사이트와 도메인을 위한 것입니다. GitHub의 오픈 소스 프로젝트는 같은 목적으로 보통 리포지토리의 SECURITY.md 파일을 사용합니다.
CRACI와의 관계
CRACI는 취약점 보고를 접수하거나 security.txt 파일을 게시하지 않습니다. 누가 어떻게 보고를 처리하는지는 PSIRT와 조정된 취약점 공개에서 다룹니다.