Project Stash House — Workstation Credential Stewardship
Download White Paper
The definitive 8-page white paper on Stash House architecture and implementation.
Download stash.pdf (8 pages)The Problem: Workstation Entropy
Developer workstations are highly dynamic environments, prone to accumulating sensitive credentials across a multitude of unencrypted files, configuration stubs, and source code repositories. This "workstation sprawl" creates a significant attack surface, despite best-effort pre-commit security tooling in CI/CD pipelines. Project stash-house addresses this post-sprawl remediation challenge, offering a reproducible framework for local secret hygiene and encrypted stewardship.
Core Operational Primitives
Stash House leverages standard UNIX tooling to establish a robust local-first credential management system:
- Local GPG Keys: All secrets are encrypted using a developer's personal GPG key, ensuring a strong, auditable chain of custody.
- Standard UNIX
passUtility: Credentials are stored in a hierarchical GPG-encrypted directory structure managed by thepassutility. This provides a familiar, plaintext-agnostic interface for secret retrieval. - Keyringer Integration: For teams requiring shared secret management without a centralized vault,
keyringerextendspasswith robust multi-user access controls and revocation mechanisms.
The core principle is to treat the workstation as the definitive source of truth for credentials, with strong encryption at rest and a clearly defined materialization boundary.
Interactive Terminal Demo: 4-Phase Workflow
Experience the Stash House workflow firsthand with this interactive terminal simulator. Click through the tabs to see how exposed credentials are discovered, secured, and safely used.
Stash House Resource Catalog
Explore the full suite of Stash House project assets, including the white paper, presentation slides, and supporting documentation.
White Paper
The complete 8-page manuscript detailing the Stash House architecture, implementation mechanics, and experimental extensions.
Download PDFLaTeX Source Code
The full LaTeX source file for the white paper, including all figures, references, and custom commands.
View SourceBSides Colorado Slides
Presentation deck from BSides Colorado, focusing on local credential hygiene and developer workflow integration.
Download SlidesExecutive Summary Slides
A concise slide deck for leadership and executive briefings, highlighting key security benefits and operational impact.
Download SlidesStash.drawio Diagram
The editable source file for the Stash House architecture diagram.
Download DiagramPassword Store Readme
Detailed guide on setting up and using the pass utility for local secret management.
Keyringer Markdown
Documentation on integrating keyringer for collaborative secret management.
Experimental Extensions (Section 6)
The following features are advanced research prototypes for distributed transport and federated quorum, outlined in Section 6 of the white paper. They are optional and operate independently of the core local workstation hygiene toolchain:
- Nostr NIP-78 Transport: Decentralized ciphertext synchronization.
- FOKS Key Brokerage: Hardware security key integration for decryption governance.
- Enterprise Identity Bridge: Interoperability with LDAP/Kerberos.
These extensions are for multi-environment mobility and are not required for core stash-house operation.
ORCID