Skip to content

1.1.0

Choose a tag to compare

@github-actions github-actions released this 06 Nov 23:08
· 17 commits to main since this release
Immutable release. Only release title and notes can be modified.
1.1.0
618ea75

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_ENABLED is gone: a server with it set refuses to start. Use ENABLED_APPS=sync,mcp.
  • The admin panel turns on only with admin in ENABLED_APPS.
  • Recommended: run the admin panel in a second container on the same /vaults and /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 get 401,
    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 except POST /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) get 400 before routing.
  • One rule for vault paths: hidden segments (except .keep), .., \, a leading ~ and the like get 400
    on every route and an error from MCP. Git no longer reads the vault's files: a .gitignore, .gitattributes
    or nested .git inside 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 429 with Retry-After: 5.
  • Form bodies (application/x-www-form-urlencoded, multipart/*) get 415. Scripts using curl's -d need
    -H 'Content-Type: application/octet-stream'.
  • X-Rock-Sync-Vault is checked on GET /vaults and DELETE /token too.
  • Verbose logs leave out credential-like headers and answer bodies.
  • rack 3.2.8, sqlite3 2.10.2.

Plugin

  • Only the X-Rock-Sync-Vault header is new. Nothing changes for devices on a VPN or without a proxy.