diff --git a/docs/SECURITY.md b/docs/SECURITY.md index d99a64b..972375e 100644 --- a/docs/SECURITY.md +++ b/docs/SECURITY.md @@ -48,6 +48,19 @@ When enabled, device authentication provides: - **Push access control**: Deploy keys managed via Gitea API - **Instant revocation**: One command cuts off both signing and push +Enforcement requires deploying the `relicario-server` pre-receive hook +on the vault remote. The crate provides two subcommands: + +- `relicario-server generate-hook` — emits the hook script to install at + `/hooks/pre-receive` +- `relicario-server verify-commit ` — checks one commit's signature + against `.relicario/devices.json` and `.relicario/revoked.json` as of + that commit; the hook calls this for every pushed ref + +Without the server hook, signed commits provide authorship metadata only +— any process with push access can land an unsigned commit, since +verification is otherwise advisory. + See `docs/superpowers/specs/2026-05-02-device-authentication-design.md`. ## Access Control @@ -57,5 +70,4 @@ Without device authentication, access control is transport-layer only: - **CLI**: SSH key authentication to git remote - **Extension**: Git credentials in browser storage -Device registration was optional before v0.4.0. With device auth enabled, -all commits must be signed by a registered device. +Device registration is optional but recommended for shared vaults.