사용 방법
- Contact 에 취약점을 신고할 연락처를 한 줄에 하나씩 적습니다. 이메일, 전화번호, https 신고 양식 주소 모두 됩니다.
- Expires 에 이 파일의 만료일을 고릅니다. 기본값은 약 1년 뒤입니다.
- 필요하면 정책 문서(Policy), 암호화 키(Encryption), 감사 명단(Acknowledgments), 선호 언어(Preferred-Languages)를 채웁니다.
- 빨간 경고가 없는지 확인하고 security.txt 다운로드 로 저장합니다.
- 사이트의
https://내도메인/.well-known/security.txt로 제공되게 올립니다. UTF-8 일반 텍스트이고 HTTPS 로 열려야 합니다.
security.txt 란
보안 연구자가 내 사이트에서 취약점을 발견했을 때 누구에게 어떻게 알려야 하는지 모르면 공개 게시판이나 SNS 로 가 버리기 쉽습니다. security.txt 는 신고 창구를 정해진 위치에 정해진 형식으로 적어 두는 파일이며, 2022년 RFC 9116 으로 규격이 정리되었습니다. 대기업 사이트뿐 아니라 개인 사이트와 오픈소스 프로젝트에서도 쓸 수 있습니다.
필드 설명
| 필드 | 필수 | 뜻 |
|---|---|---|
Contact |
필수 | 신고 연락처. mailto:, tel:, https: 가능. 여러 줄 가능 |
Expires |
필수 | 만료일. 1년 미만을 권장하며 한 번만 쓸 수 있음 |
Encryption |
선택 | 신고를 암호화해 받을 공개 키 주소 |
Acknowledgments |
선택 | 제보자 감사 명단 페이지 |
Preferred-Languages |
선택 | 신고에 쓰면 좋은 언어. 쉼표로 구분한 언어 태그 |
Canonical |
선택 | 이 파일의 정식 주소 |
Policy |
선택 | 취약점 공개 정책 문서 |
Hiring |
선택 | 보안 분야 채용 공고 |
CSAF |
선택 | CSAF 보안 권고 제공자의 provider-metadata.json 주소 |
URL 을 받는 필드는 https:// 로 시작해야 합니다. 이 도구는 http:// 와 상대 경로를 오류로 알려 줍니다. 이메일 주소를 Contact 에 그냥 적으면 mailto: 를, +82 2 555 1234 같은 전화번호에는 tel:+8225551234 형태로 tel: 을 붙여 줍니다.
출력 예시
# Security contact for example.com
Contact: mailto:security@example.com
Contact: https://example.com/report
Expires: 2027-10-17T23:59:59Z
Preferred-Languages: ko, en
Canonical: https://example.com/.well-known/security.txt
Policy: https://example.com/policy
Expires 는 고른 날짜의 23시 59분 59초(UTC)로 기록됩니다. 날짜가 지난 파일은 오래되어 믿을 수 없는 것으로 취급되니, 달력에 갱신일을 적어 두세요.
서명과 주의할 점
- 연락처가 바뀌는 위조를 막으려면 파일에 PGP 클리어사인 서명을 하는 방법이 있고 RFC 9116 이 권장합니다. 이 도구는 서명하지 않으며, 페이지 아래의 gpg 명령으로 직접 서명할 수 있습니다. 개인 키를 이 페이지에 붙여넣지 마세요.
- 연락처로 쓰는 메일함이 실제로 모니터링되는지 먼저 확인하세요. 신고 창구가 닫혀 있으면 파일이 없는 것보다 나쁠 수 있습니다.
- 같은 목적의 도구로 크롤러 규칙은 robots.txt 생성기, AI 안내 파일은 llms.txt 생성기, 암호화 키는 RSA 키 생성기를 쓸 수 있습니다.
자주 묻는 질문
꼭 있어야 하나요?
법적 의무는 아닙니다. 하지만 취약점을 책임 있게 알리려는 사람에게 창구를 보여 주는 가장 표준적인 방법입니다.
파일 위치는 어디인가요?
/.well-known/security.txt 가 표준 위치입니다. 하위 호환을 위해 /security.txt 도 허용되지만 새로 올린다면 .well-known 쪽을 쓰세요.
만료일을 길게 잡아도 되나요?
기술적으로는 되지만 RFC 9116 은 1년 미만을 권장하고, 이 도구도 1년 이상이면 경고합니다. 만료일이 있는 이유는 방치된 파일을 걸러내기 위해서입니다.
여러 연락처를 적어도 되나요?
네. Contact 는 여러 줄을 적을 수 있고 앞쪽일수록 우선입니다.
입력한 내용은 어디로 가나요?
입력한 글은 브라우저 안에서만 처리되며 서버로 전송되지 않습니다.