Skip to content

Commit 183322e

Browse files
authored
Update SECURITY.md
1 parent ea12edf commit 183322e

1 file changed

Lines changed: 82 additions & 13 deletions

File tree

SECURITY.md

Lines changed: 82 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -1,24 +1,93 @@
11
# Security Policy
22

3-
## Supported versions
4-
This project is pre-1.0. Treat it as **prototype / evaluation** software.
3+
## Supported status
54

6-
## Reporting a vulnerability
7-
Please do **not** open a public issue for security-sensitive bugs.
5+
This project is currently **pre-1.0** and should be treated as **prototype / evaluation software** unless separately hardened and licensed for production use.
86

9-
Preferred:
10-
1) Use GitHub’s **Private Vulnerability Reporting** / Security Advisory flow for this repository, if enabled.
11-
2) If that’s not available, open an Issue titled **“Security (private)”** with minimal details and request a private channel.
7+
## Do not report security issues in public
8+
9+
Please do **not** open a normal public bug report for a security-sensitive issue.
10+
11+
Use one of these paths instead.
12+
13+
## Preferred reporting path
14+
15+
### 1) GitHub Private Vulnerability Reporting / Security Advisory
16+
17+
If private vulnerability reporting is enabled for this repository, use that first.
1218

1319
Include:
14-
- what you found
20+
21+
- affected component or file
22+
- issue description
1523
- impact
1624
- reproduction steps
17-
- affected files / components
18-
- whether you have a suggested fix
25+
- conditions required to trigger it
26+
- suggested fix, if you have one
27+
28+
## Fallback path when private reporting is unavailable
29+
30+
Open the issue template:
31+
32+
- `.github/ISSUE_TEMPLATE/security-private-channel.md`
33+
34+
Use the title:
35+
36+
- `Security (private channel requested)`
37+
38+
Keep the public issue minimal. Do **not** post exploit details publicly.
39+
40+
Include only:
41+
42+
- affected area at a high level
43+
- severity estimate
44+
- request for a private channel
45+
- your preferred contact method
46+
47+
## What not to post publicly
48+
49+
Do not post any of the following in a public issue:
50+
51+
- exploit payloads
52+
- private keys
53+
- secret material
54+
- customer or internal environment details
55+
- step-by-step weaponized reproduction details
56+
57+
## What helps triage quickly
58+
59+
A high-quality private report usually includes:
60+
61+
- precise affected path or component
62+
- attack preconditions
63+
- realistic impact
64+
- whether integrity, policy enforcement, receipt validity, or key handling is affected
65+
- whether the issue is local-only or remotely triggerable
66+
- whether a mitigation already exists
67+
68+
## Scope areas of particular interest
69+
70+
Security-sensitive areas in this repo include:
71+
72+
- policy enforcement boundary
73+
- receipt canonicalization
74+
- signature creation and verification
75+
- approval-signature verification
76+
- chain validation
77+
- key resolution and trust anchoring
78+
- storage integrity assumptions
79+
80+
## Coordination expectation
81+
82+
Please allow time for confirmation and remediation before public disclosure.
83+
84+
If you need to discuss coordinated disclosure timing, say so in the initial private report.
85+
86+
## Recommended starting documents
87+
88+
Before reporting, it may help to review:
1989

20-
## Goals
21-
IX-Agent-Notary exists specifically to reduce agent blast radius and increase auditability, so security feedback is welcome.
22-
Start from:
2390
- `docs/THREAT_MODEL.md`
2491
- `docs/KEY_MANAGEMENT.md`
92+
- `docs/POLICY_INTEGRITY.md`
93+
- `docs/ARCHITECTURE.md`

0 commit comments

Comments
 (0)