Repository navigation
1.1.0
·
17 commits
to main
since this release
Immutable
release. Only release title and notes can be modified.
The purpose of this release was to severely enhance security for publicly exposed backends.
Breaking: ENABLED_APPS decides what a server process serves
sync(the sync API),mcp,admin, comma-separated; unset:sync.MCP_ENABLEDis gone: a server with it set refuses to start. UseENABLED_APPS=sync,mcp.- The admin panel turns on only with
admininENABLED_APPS. - Recommended: run the admin panel in a second container on the same
/vaultsand/db, reachable only
from your private network (Processes).
New
ALLOWED_VAULTS: a container's sync API serves only the vaults you list. Other vaults' tokens get401,
their connection codes are refused and used up. Meant for the container behind a proxy
(Exposing).- The plugin sends
X-Rock-Sync-Vault: <vault>with every request exceptPOST /pair, so a proxy can let
only some vaults through. The server refuses it when it doesn't match the credentials. - Exposing the server: a guide to putting it behind a proxy (allowlist, Cloudflare, checks).
Security
- Non-canonical request paths (
//,.., encoded/\., control characters) get400before routing. - One rule for vault paths: hidden segments (except
.keep),..,\, a leading~and the like get400
on every route and an error from MCP. Git no longer reads the vault's files: a.gitignore,.gitattributes
or nested.gitinside a vault changes nothing. Check the log after updating: vaults already holding such
paths are named at startup (Storage). - Long polls are capped: 2 per token, 12 per process, then
429withRetry-After: 5. - Form bodies (
application/x-www-form-urlencoded,multipart/*) get415. Scripts using curl's-dneed
-H 'Content-Type: application/octet-stream'. X-Rock-Sync-Vaultis checked onGET /vaultsandDELETE /tokentoo.- Verbose logs leave out credential-like headers and answer bodies.
- rack 3.2.8, sqlite3 2.10.2.
Plugin
- Only the
X-Rock-Sync-Vaultheader is new. Nothing changes for devices on a VPN or without a proxy.