Skip to content

Commit 7b2fce3

Browse files
kakraGemini CLI
andcommitted
docs: add threat model and limitations
Clarify the security model with explicit threat boundaries, known limitations, and implemented verification practices. Co-authored-by: OpenAI Codex <codex@openai.com> Co-authored-by: Gemini CLI <noreply@google.com>
1 parent eea5edb commit 7b2fce3

1 file changed

Lines changed: 12 additions & 0 deletions

File tree

docs/SECURITY_MODEL.md

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -45,6 +45,18 @@ This document summarizes implemented security properties, current hardening meas
4545
## 🧹 Automated Maintenance
4646
- **Mark-and-Sweep GC:** A background worker automatically deletes expired shares, incomplete TUS uploads, and orphaned blobs, adhering to the principle of **Data Minimization**.
4747

48+
## 🎯 Threat Model
49+
- **Designed For:** Trusted self-hosted deployments, temporary file exchange, and small operational teams that control their own infrastructure.
50+
- **Not Designed For:** Hostile multi-tenant hosting, zero-trust public exposure, or long-term confidential storage.
51+
- **Assumed Trust Boundary:** The operating system, local filesystem, and deployment operator are part of the trust boundary.
52+
53+
## ⚠️ Known Limitations
54+
- **No application-level encryption at rest:** ferry relies on the underlying host or storage layer for disk encryption.
55+
- **No central session revocation:** Sessions are cookie-based, so active sessions cannot be centrally enumerated or invalidated without replacing the session store.
56+
- **No distributed deployment model:** ferry is intentionally single-node and SQLite-backed.
57+
- **No complete quota enforcement layer yet:** Size and retention limits are configured, but they are not a substitute for external storage controls.
58+
- **No remote break-glass administration:** Recovery mode is intentionally local-only and must be started explicitly.
59+
4860
## 🚀 Development Process
4961
Ferry is built using a **Multi-AI Orchestration** approach:
5062
- **Google Gemini:** High-level logic, UI polish, and architectural guidance.

0 commit comments

Comments
 (0)