Skip to main content

Sops

@dataverket/sopsv2026.10.27.2· AGPL-3.0-only· 8d agoVAULTS
01README

SOPS + age vault for swamp: one encrypted file per secret. put encrypts {"value": …} to the configured age recipients into <secretsDir>/<key>.enc.json and needs nothing but their public keys, so a writer can store a value for readers whose identities it does not hold: a human without the cluster key, or a workflow that mints a credential. get decrypts one file, list walks the directory without decrypting, delete removes the file. A key with / becomes a directory path; git history is per secret, and no write touches any other secret. Forked from @zocc/sops-age (Apache-2.0), see NOTICE.md; that provider keeps every secret in one file and decrypts it all to write. sops runs with an argument vector, never a shell; values reach it through a private temporary directory, never as an argument. Decryption is the caller's unless configured: ageKeyFile names a path, ageKeyName a file beside sops's own keys.txt that is used when it exists, so a vault config can name a process key without an operator's home path, and a YubiKey identity works unchanged where the file is absent. swamp vault migrate <vault> --to-type @dataverket/sops splits an existing single-file vault.

02Vaults1
SOPS + age, one file per secretconfigurable
@dataverket/sopsfiles.ts

One SOPS-encrypted JSON file per secret under a directory; put needs only the recipients' public keys, so a writer can store a value it cannot read back. get decrypts one file, list walks the directory, delete removes the file.

03Previous Versions4
2026.10.27.1AGPL-3.0-only(was Apache-2.0)
2026.10.19.1Apache-2.0(was none)

ageKeyName: an age identity named by file name, found beside sops's own keys.txt and used when it exists and the caller exports no SOPS_AGE_KEY_FILE, so a vault config can name a process key without an operator's home path. ageKeyFile and ageKeyName are alternatives. The test task grants --allow-run, so the integration tests run; license declared.

2026.09.20.2
2026.09.20.1
04Stats
A
100 / 100
Downloads
50
Archive size
26.3 KB
  • Has README or module doc2/2earned
  • README has a code example1/1earned
  • README is substantive1/1earned
  • Most symbols documented1/1earned
  • No slow types (deprecated)1/1earned
  • Dependencies pass trust audit2/2earned
  • Docs keep secrets in a vault1/1earned
  • Has description1/1earned
  • Platform support declared (or universal)2/2earned
  • License2/2earned
  • Verified public repository2/2earned
05Platforms
06Labels