| Version | Supported |
|---|---|
| 1.3.x | ✅ |
| 1.2.x | ✅ |
| 1.1.x | ✅ |
| < 1.1 | ❌ |
The full threat model is documented in
docs/THREAT_MODEL.md. It covers asset
classification, trust boundaries, attacker capabilities, and
residual risk for the snp CLI, snip-sync server, and sync protocol.
Only snp run invokes a shell to execute a snippet's command field.
All other commands — snp list, snp search, snp clip, snp edit,
snp sync, snp import, snp validate, snp backup, snp restore,
snp repair, snp doctor, snp status, snp register, snp premade —
treat the command field as opaque data and never execute it.
Snippets are encrypted client-side before leaving the machine. Only the snippet
body (description, command, tags) is encrypted; routing metadata (id,
timestamps, device_id, deleted) travels in the clear — see
Sync Encryption.
- Algorithm: AES-256-GCM (authenticated encryption with associated data).
- Key derivation: Argon2id with 16 MiB memory cost, 3 iterations, and 4 degrees of parallelism (OWASP-recommended parameters). The encryption key is derived from the API key and a per-payload random salt.
API keys are stored in the OS keychain (macOS Keychain, GNOME Keyring,
Windows Credential Manager). Keychain-backed configs store the @keychain
marker, never the key itself. On save, if the keychain is unavailable the write
is refused (keychain unavailable, refusing to store API key in plaintext)
rather than silently downgraded to a plaintext file. On load, a plaintext key
already present in sync.toml is migrated into the keychain and the file
re-saved with the marker; a marker whose keychain entry has been lost is a hard
error, not a silent empty credential. Keep keyring = "4" with its default
features: keyring 4's default is v1, which hard-enables the three platform
stores, and keyring::Entry is gated on v1 — building with
default-features = false is a compile error, not a silent downgrade.
There is no mock store.
SNP_ALLOW_PLAINTEXT_API_KEY=true is a test-only seam, compiled in under
#[cfg(feature = "test-support")] (src/config/sync_settings.rs). Setting it
in a production build has no effect at all — it cannot weaken or bypass
keychain storage. In a test-support build it forces plaintext storage on save
and forbids keychain access on load, so a config still holding the @keychain
marker fails to load rather than authenticating with the literal marker string.
On Unix, snp creates its config directory with mode 0o700 and
writes config, library, premade-library, and sync files with mode
0o600. These limits protect local snippet data and the API key
when the keychain is unavailable.
The detached auto-sync worker (snp auto-sync-worker) holds the
SyncExecutionLock for the duration of the sync cycle without
blocking the parent CLI; it invokes run_sync directly with no
descendant executor process. No secrets are placed in process arguments;
they are passed through file descriptors or environment variables only.
cargo deny check(viadeny.toml) is the local supply-chain gate for known security advisories and license compliance; it does not run in CI.- Locked
Cargo.lockfiles ensure reproducible builds and prevent silent dependency version changes.
If you discover a security vulnerability in snp, please report it responsibly.
Do NOT open a public GitHub issue for security vulnerabilities.
Instead, please email: dbowman91@proton.me (PGP key on request).
Include the following in your report:
- Description of the vulnerability
- Steps to reproduce
- Potential impact
- Suggested fix (if any)
- Acknowledgment: Within 48 hours
- Initial assessment: Within 1 week
- Fix or mitigation: Critical issues within 2 weeks, others within 30 days
Snippet commands are executed as-is via your shell. Only add snippets you trust. Avoid storing snippets that contain secrets (passwords, tokens, API keys) in plaintext TOML files; snippets are not encrypted at rest.
Only snp run invokes a shell. The following commands never execute
snippets:
snp getsnp listsnp searchsnp selectsnp clipsnp syncsnp importsnp validatesnp backupsnp restore --dry-runsnp repair --dry-runsnp doctorsnp statussnp registersnp premade
When using exact selectors (--id, --description-exact,
--command-exact), snp run bypasses the TUI and executes directly.
This is a deterministic path for automation; the caller is responsible
for verifying the target snippet.
Standalone self-update packages (direct download, not Homebrew or crates.io) include a SHA-256 checksum file. The updater verifies the checksum of the downloaded archive before extraction. Archive entries are validated: absolute paths, parent-directory traversal, symlinks, and hard links are rejected. HTTPS-only downloads prevent MITM attacks.
- In transit: Snippet content is encrypted client-side with
AES-256-GCM before being sent to the server; the server stores only
ciphertext for those fields. Per-snippet metadata —
id,created_at,updated_at,device_id,deleted— is sent as plaintext proto fields, because the server needs it for merge ordering and deletion tombstones.outputis local-only and is never sent. So a compromised server cannot read snippet content, but it can see snippet identifiers, timestamps, and deletion state. - Key derivation: Per-snippet Argon2id (16 MiB memory, 3 iterations, 4 threads — OWASP-recommended parameters) derives an encryption key from the API key and a per-payload random salt.
- API keys: Stored in the OS keychain (macOS Keychain, GNOME
Keyring, Windows Credential Manager) by default. Fall back to a
plaintext
sync.tomlonly whenSNP_ALLOW_PLAINTEXT_API_KEY=trueis set; a warning is emitted at runtime. - Integrity:
sync.tomlcarries a CRC32 comment line to detect accidental corruption. This is not a cryptographic integrity check — the threat model assumes local-only access. - Authentication: Current clients send the API key as a bearer
token in gRPC
authorizationmetadata. The proto request-bodyapi_keyfields remain for backward compatibility with older clients and are ignored when metadata is present.
deny.toml currently carries no active suppressions (ignore = []). Past
suppressions are removed once the upstream crate fixes the advisory — do not
re-add without a fresh exploitability analysis. The server uses
prometheus 0.14 (text encoder for /metrics only).
If you self-host the snip-sync server:
- Enable TLS in production. The client refuses to connect over
plaintext HTTP unless
SNIP_SYNC_ALLOW_HTTP=trueis set. - Use a reverse proxy (nginx, traefik, Caddy) to terminate TLS with a real certificate (Let's Encrypt, etc.).
- Use strong, unique API keys. The server enforces a minimum length and stores hashes with Argon2id; plaintext keys are never written to the database.
- Configure rate limiting. Default is 120 requests per minute per
API key; tune for your traffic via
[server.rate_limit]inconfig.toml. - Keep the server updated. Subscribe to releases on GitHub to be notified of security fixes.
- Restrict metrics endpoint access. The
/metricsendpoint returns Prometheus-format data; require basic auth ([server.metrics]username/password) or expose it only on an internal interface. - Back up the SQLite database (
snippets.dbby default) using the same backup strategy you would for any user data store.
On Unix, snp creates its config directory with mode 0o700 and
writes config, library, premade-library, and sync files with mode
0o600. These limits help protect local snippet data and the API key
when the keychain is unavailable.
- CRC32 integrity checks detect accidental corruption but do not authenticate against a malicious local actor. A local attacker with filesystem access can tamper with files without triggering integrity failures.
- No mutual TLS / client certificate authentication. The sync protocol authenticates via API key bearer tokens only. Clients without a valid API key are rejected, but additional client certificate verification is not currently supported.
For detailed audit findings and the methodology used, refer to
docs/SECURITY_AUDIT.md.
This security policy applies to the snp CLI tool, the snip-sync
server, and the snip-proto definitions — all part of the
eggstack/snip-it repository.
Third-party integrations and premade libraries (downloaded via
snp premade) are not covered: review them before installing.