|
1 | 1 | # Security Policy |
2 | 2 |
|
3 | | -## Supported versions |
4 | | -This project is pre-1.0. Treat it as **prototype / evaluation** software. |
| 3 | +## Supported status |
5 | 4 |
|
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. |
8 | 6 |
|
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. |
12 | 18 |
|
13 | 19 | Include: |
14 | | -- what you found |
| 20 | + |
| 21 | +- affected component or file |
| 22 | +- issue description |
15 | 23 | - impact |
16 | 24 | - 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: |
19 | 89 |
|
20 | | -## Goals |
21 | | -IX-Agent-Notary exists specifically to reduce agent blast radius and increase auditability, so security feedback is welcome. |
22 | | -Start from: |
23 | 90 | - `docs/THREAT_MODEL.md` |
24 | 91 | - `docs/KEY_MANAGEMENT.md` |
| 92 | +- `docs/POLICY_INTEGRITY.md` |
| 93 | +- `docs/ARCHITECTURE.md` |
0 commit comments