Home / Core Health / Create a security.txt file at /.well-known/security.txt
Content & Files · Scan Check Guide

Create a security.txt file at /.well-known/security.txt

15 min Impact: medium Effort: low ✓ Scan-verified — no manual checkbox

A security.txt file (at /.well-known/security.txt) gives security researchers a clear, official way to report a vulnerability they've found — without it, someone who discovers a real problem in your site has no idea who to contact and may post it publicly instead of reporting it responsibly.

security.txt is a standard file that tells security researchers how to responsibly disclose vulnerabilities to you. Without it, researchers may disclose publicly.

The full picture

A security.txt file addresses a genuine, practical problem in vulnerability disclosure — a security researcher who discovers a genuine vulnerability in your systems needs a clear, reliable way to report it responsibly, and without this file, they're often left guessing at an appropriate contact method, which can lead to delayed reporting, public disclosure before you're aware, or simply the researcher giving up on responsible reporting entirely.

This file, published at the specific, standardized location browsers and security tools know to check, provides genuine, structured contact information specifically for security reports — distinct from a general contact form or customer support channel, which security researchers reasonably assume may not route urgent vulnerability reports to the right technical team quickly.

The genuine practice of maintaining a responsible disclosure channel signals real security maturity to the broader security research community — organizations known to have functioning, monitored security contact channels are more likely to receive good-faith vulnerability reports before any malicious exploitation occurs, rather than researchers defaulting to public disclosure due to no clear private reporting path.

This file requires minimal ongoing maintenance once established, but genuine value depends on the contact information remaining current and, critically, actually monitored — a security.txt file pointing to an unmonitored or abandoned contact method provides false reassurance while still failing at the actual goal of enabling real vulnerability disclosure.

How to fix it

  1. 1
    Create the file
    At /.well-known/security.txt, include at minimum a Contact: line with an email or URL for reports.
  2. 2
    Add an expiry date
    Expires: with an ISO date is required by the spec — set it a year out and renew it periodically.
  3. 3
    Optionally add a policy link
    Policy: pointing to a page describing your responsible-disclosure process, if you have one.

Common mistakes

How you'll know it's done

https://yoursite.com/.well-known/security.txt loads and contains a valid Contact and Expires field.

Tools that help

H.I.V.E. checks this automatically

Fix it, then re-scan — the check confirms itself. No manual checkbox, the scan is the truth.

Run this check in H.I.V.E. →