We take security issues seriously. If you believe you have found a security vulnerability in voussoir, please report it responsibly rather than opening a public issue.
Do not open a GitHub issue or PR with the details. Instead, report it privately via one of:
- GitHub: use the repository's Private vulnerability reporting feature (Security → Report a vulnerability), or
- Email:
security@efathom.com
Please include:
- A clear description of the vulnerability and its impact
- Steps to reproduce, or a proof-of-concept if available
- The affected version(s) / commit(s)
- Any suggested remediation
- You will receive an acknowledgment within a few business days.
- We will validate the report and keep you informed of our assessment and fix timeline.
- Once a fix is available we will publish a security advisory and credit the reporter (unless you prefer to remain anonymous).
| Version | Supported |
|---|---|
latest main |
✅ |
| latest tagged release | ✅ |
voussoir's security posture is structural, not opt-in:
- Every tool carries a
Capabilitymask and produces aTrusttaint; theStandardExecutorenforces both inline — there is no skip flag. - The
Authorizer/CredentialBrokerProtocols implement authz/authn; the defaultAuthorizeris the fail-closedDenyByDefaultAuthorizer— bind a concreteAuthorizer(Role / Domain / Chained) to grant tool access. - The
Guardrailchain screens input / tool_call / tool_output / output stages.default_container()now binds thestandardprofile; usebind_default_guardrails(profile="strict", url_allowlist=[...])for PII + URL allow-listing. - Security-critical container bindings (
Authorizer,KeyProvider,ITelemetrySink,ILLMProvider,IMemoryStore,ISessionStore,IToolExecutor) are frozen afterdefault_container()returns so plugins cannot rebind them.
- Never commit real credentials — use environment variables or a secret
manager for
ANTHROPIC_API_KEY/OPENAI_API_KEY/OPENROUTER_API_KEY, the A2A JWT secret, and database passwords. - Set
VOUSSOIR_A2A_JWT_SECRETandVOUSSOIR_A2A_ALLOWED_ISSUERSfor any A2A peer deployment. Empty issuer allow-list is default-deny. - Bind a concrete
Authorizer(Role / Domain / Chained) before exposing tool-using agents. - Enable the
strictguardrail profile and configure a URL allow-list if user data or external URLs flow through your agents. - Use JSON logs (
VOUSSOIR_LOG_FORMAT=json) and export OpenTelemetry traces + metrics to your observability backend. - Pin and review dependencies — Dependabot updates are enabled, but review them before merging.