hermesvault.yaml 3.0 KB

12345678910111213141516171819
  1. name: hermesvault
  2. repo: https://github.com/Guerilla-ops/floorvault
  3. sha: 62e41853d1d9bf4d84f3ff22d3755d9762efdd3c
  4. subdir: plugins/hermesvault
  5. description: "Keep secrets out of plaintext .env files: a local encrypted vault (FloorVault, AES-256-SIV) whose items Hermes loads as environment variables at startup (mapped source \"hermesvault\", hv: references), with a hermes hvault CLI to manage items. The vault key lives in your OS key store (Keychain, Secret Service, DPAPI), a key file, a systemd-creds credential, or HERMES_VAULT_KEY. Disclosure — reads an encrypted store under <HERMES_HOME>/agent-vault (or secrets.hermesvault.dir) at startup; hermes hvault commands write to it and hermes hvault setup creates it; reads its own master key only from the variable named by token_env (default HERMES_VAULT_KEY) in the environment Hermes scopes to the profile being fetched, else from the custody set in secrets.hermesvault.custody: os (default; macOS Keychain, Linux Secret Service or Windows DPAPI, service floor-vault, shared with other FloorVault apps on the same account), key_file (the file named by secrets.hermesvault.key_file, which must not be writable by group or others), or systemd-creds (master.key.sdcred beside the store) — never from FLOOR_VAULT_KEY, VAULT_MASTER_KEY or FLOOR_VAULT_KEY_FILE, which it also protects from being overwritten; a configured custody that fails is reported, never replaced by another; startup never prompts and never creates a key, a credential or a store (a locked or missing key is reported and Hermes starts without those variables), and only hermes hvault setup may unlock the key store or create the key; reads Hermes' own command line (sys.argv and sys.orig_argv, no other process's) to compare with the command bindings stored on an item by floorvault secrets allow, and resolves a bound item only when Hermes was started with one of them (secrets.hermesvault.require_binding, default off, also skips items with no binding); resolved values become environment variables of the Hermes process and its children, like .env entries; installs floorvault>=0.2.8,<0.4 from PyPI (plus secretstorage on Linux, pyobjc-framework-Security on macOS); one subprocess, only with custody: systemd-creds: the system's own systemd-creds (decrypt --user at startup; encrypt and decrypt in hermes hvault setup), found only in system directories, run as an argument list with no shell and a minimal environment, the key passed through a pipe; otherwise no subprocesses; no network calls, no self-update; protection is at rest, not against code already running as the same user."
  6. maintainer: Guerilla-ops
  7. tier: community
  8. category: tools
  9. requires_hermes: ">=0.21.2"
  10. docs_url: https://github.com/Guerilla-ops/floorvault/blob/62e41853d1d9bf4d84f3ff22d3755d9762efdd3c/plugins/hermesvault/README.md
  11. image: https://raw.githubusercontent.com/Guerilla-ops/floorvault/62e41853d1d9bf4d84f3ff22d3755d9762efdd3c/docs/assets/hermesvault-banner.png
  12. version: "0.3.0"
  13. readme: true
  14. platforms: []
  15. capabilities:
  16. provides_tools: []
  17. provides_hooks: []
  18. provides_middleware: []
  19. requires_env: []