Skip to content

The Three Secrets Model ​

ShellGuard establishes a strict hierarchy of trust governed by The Three Secrets.


🗝️ The Secrets Breakdown ​

SecretGovernsStoredThreat Mitigation
ADMIN_TOKENOpens the /superlobster control planeEnvironment variable (.env)Token brute-forcing & unauthorized administration
DB_ENCRYPTION_KEYUnlocks SQLCipher (Layer 3) & Per-Row Metadata AES (Layer 2)Environment variable (.env)Server disk exfiltration & filesystem theft
hu- Key (per user)Authenticates user identity & unlocks Zero-Knowledge secrets (Layer 1)User's offline Vault Access File (.json)Total server compromise & database breach

⚖️ Trust Boundaries ​

Key Invariant: ​

Even if a rogue administrator possesses both the ADMIN_TOKEN and the host DB_ENCRYPTION_KEY, they cannot decrypt any user's passwords, TOTP seeds, or files.

Sovereign Zero-Knowledge Secrets Vault. Released under AGPL-3.0. • Privacy Policy