Commit 63d6bca
committed
docs(security): correct bcrypt cost + remove false encryption-at-rest claim
Two doc errors caught by the 2026-05 security audit (P0-3):
1. SECURITY.md claimed bcrypt cost 10. The code has been using cost 12
since gearbox/internal/framework/auth/password.go was written; the
doc just never caught up. Cost 12 is the 2026 OWASP baseline, so
the code is right and the doc was lagging.
2. SECURITY.md claimed "Credential Encryption: API keys encrypted at
rest (AES-256-GCM)". That implementation does not exist anywhere in
the codebase — a grep for "aes" / "GCM" / "cipher" returns zero hits
in gearbox-agent. Secrets are protected by filesystem permissions
(mode 0600) only. The claim is replaced with an honest description
of the actual posture, plus guidance on how to layer real
encryption-at-rest underneath (FDE / KMS).
Also adds the 2026-05 audit to the Security Audit History table.
The "real fix" for #2 (implementing envelope encryption with a KMS- or
TPM-backed key) is tracked separately; co-locating the decryption key
with the ciphertext on the same filesystem buys nothing real and the
honest doc is more defensible than the theatrical implementation.1 parent 09b5737 commit 63d6bca
1 file changed
Lines changed: 12 additions & 5 deletions
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
147 | 147 | | |
148 | 148 | | |
149 | 149 | | |
150 | | - | |
| 150 | + | |
151 | 151 | | |
152 | 152 | | |
153 | 153 | | |
| |||
171 | 171 | | |
172 | 172 | | |
173 | 173 | | |
174 | | - | |
| 174 | + | |
| 175 | + | |
| 176 | + | |
| 177 | + | |
| 178 | + | |
| 179 | + | |
| 180 | + | |
175 | 181 | | |
176 | 182 | | |
177 | 183 | | |
| |||
195 | 201 | | |
196 | 202 | | |
197 | 203 | | |
198 | | - | |
199 | | - | |
200 | | - | |
| 204 | + | |
| 205 | + | |
| 206 | + | |
| 207 | + | |
201 | 208 | | |
202 | 209 | | |
203 | 210 | | |
| |||
0 commit comments