Skip to content

Latest commit

 

History

History
188 lines (146 loc) · 6.62 KB

security-roadmap.md

File metadata and controls

188 lines (146 loc) · 6.62 KB

Lộ trình cải tiến bảo mật

⚠️ Trạng thái: Đề xuất / Lộ trình

Tài liệu này mô tả các hướng tiếp cận đề xuất và có thể bao gồm các lệnh hoặc cấu hình giả định. Để biết hành vi runtime hiện tại, xem config-reference.md, operations-runbook.md, và troubleshooting.md.

Tình trạng bảo mật hiện tại: nền tảng vững chắc

ZeroClaw đã có application-layer security xuất sắc:

✅ Command allowlist (không phải blocklist) ✅ Bảo vệ path traversal ✅ Chặn command injection ($(...), backticks, &&, >) ✅ Cách ly secret (API key không bị rò rỉ ra shell) ✅ Rate limiting (20 actions/hour) ✅ Channel authorization (rỗng = từ chối tất cả, * = cho phép tất cả) ✅ Phân loại rủi ro (Low/Medium/High) ✅ Làm sạch biến môi trường ✅ Chặn forbidden paths ✅ Độ phủ kiểm thử toàn diện (1.017 test)

Những gì còn thiếu: cách ly cấp hệ điều hành

🔴 Chưa có sandboxing cấp OS (chroot, containers, namespaces) 🔴 Chưa có giới hạn tài nguyên (giới hạn CPU, memory, disk I/O) 🔴 Chưa có audit logging chống giả mạo 🔴 Chưa có syscall filtering (seccomp)

So sánh: ZeroClaw vs PicoClaw vs production grade

Tính năng PicoClaw ZeroClaw hiện tại ZeroClaw + lộ trình Mục tiêu production
Kích thước binary ~8MB 3.4MB ✅ 3.5-4MB < 5MB
RAM < 10MB < 5MB ✅ < 10MB < 20MB
Thời gian startup < 1s < 10ms ✅ < 50ms < 100ms
Command allowlist Không rõ ✅ Có ✅ Có ✅ Có
Path blocking Không rõ ✅ Có ✅ Có ✅ Có
Injection protection Không rõ ✅ Có ✅ Có ✅ Có
OS sandbox Không ❌ Không ✅ Firejail/Landlock ✅ Container/namespaces
Resource limits Không ❌ Không ✅ cgroups/Monitor ✅ Full cgroups
Audit logging Không ❌ Không ✅ Ký HMAC ✅ Tích hợp SIEM
Điểm bảo mật C B+ A- A+

Lộ trình triển khai

Giai đoạn 1: kết quả nhanh (1-2 tuần)

Mục tiêu: giải quyết các thiếu sót nghiêm trọng với độ phức tạp tối thiểu

Nhiệm vụ File Công sức Tác động
Landlock filesystem sandbox src/security/landlock.rs 2 ngày Cao
Memory monitoring + OOM kill src/resources/memory.rs 1 ngày Cao
CPU timeout mỗi lệnh src/tools/shell.rs 1 ngày Cao
Audit logging cơ bản src/security/audit.rs 2 ngày Trung bình
Cập nhật config schema src/config/schema.rs 1 ngày -

Kết quả bàn giao:

  • Linux: truy cập filesystem bị giới hạn trong workspace
  • Tất cả nền tảng: bảo vệ memory/CPU chống lệnh chạy vô hạn
  • Tất cả nền tảng: audit trail chống giả mạo

Giai đoạn 2: tích hợp nền tảng (2-3 tuần)

Mục tiêu: tích hợp sâu với OS để cách ly cấp production

Nhiệm vụ Công sức Tác động
Tự phát hiện Firejail + wrapping 3 ngày Rất cao
Bubblewrap wrapper cho macOS/*nix 4 ngày Rất cao
Tích hợp cgroups v2 systemd 3 ngày Cao
Syscall filtering với seccomp 5 ngày Cao
Audit log query CLI 2 ngày Trung bình

Kết quả bàn giao:

  • Linux: cách ly hoàn toàn như container qua Firejail
  • macOS: cách ly filesystem với Bubblewrap
  • Linux: thực thi giới hạn tài nguyên qua cgroups
  • Linux: allowlist syscall

Giai đoạn 3: hardening production (1-2 tuần)

Mục tiêu: các tính năng bảo mật doanh nghiệp

Nhiệm vụ Công sức Tác động
Docker sandbox mode 3 ngày Cao
Certificate pinning cho channels 2 ngày Trung bình
Xác minh config đã ký 2 ngày Trung bình
Xuất audit tương thích SIEM 2 ngày Trung bình
Tự kiểm tra bảo mật (zeroclaw audit --check) 1 ngày Thấp

Kết quả bàn giao:

  • Tùy chọn cách ly thực thi dựa trên Docker
  • HTTPS certificate pinning cho channel webhooks
  • Xác minh chữ ký file config
  • Xuất audit JSON/CSV cho phân tích ngoài

Xem trước config schema mới

[security]
level = "strict"  # relaxed | default | strict | paranoid

# Cấu hình sandbox
[security.sandbox]
enabled = true
backend = "auto"  # auto | firejail | bubblewrap | landlock | docker | none

# Giới hạn tài nguyên
[resources]
max_memory_mb = 512
max_memory_per_command_mb = 128
max_cpu_percent = 50
max_cpu_time_seconds = 60
max_subprocesses = 10

# Audit logging
[security.audit]
enabled = true
log_path = "~/.config/zeroclaw/audit.log"
sign_events = true
max_size_mb = 100

# Autonomy (hiện có, được cải thiện)
[autonomy]
level = "supervised"  # readonly | supervised | full
allowed_commands = ["git", "ls", "cat", "grep", "find"]
forbidden_paths = ["/etc", "/root", "~/.ssh"]
require_approval_for_medium_risk = true
block_high_risk_commands = true
max_actions_per_hour = 20

Xem trước lệnh CLI

# Kiểm tra trạng thái bảo mật
zeroclaw security --check
# → ✓ Sandbox: Firejail active
# → ✓ Audit logging enabled (42 events today)
# → → Resource limits: 512MB mem, 50% CPU

# Truy vấn audit log
zeroclaw audit --user @alice --since 24h
zeroclaw audit --risk high --violations-only
zeroclaw audit --verify-signatures

# Kiểm tra sandbox
zeroclaw sandbox --test
# → Testing isolation...
#   ✓ Cannot read /etc/passwd
#   ✓ Cannot access ~/.ssh
#   ✓ Can read /workspace

Tóm tắt

ZeroClaw đã an toàn hơn PicoClaw với:

  • Binary nhỏ hơn 50% (3.4MB so với 8MB)
  • RAM ít hơn 50% (< 5MB so với < 10MB)
  • Startup nhanh hơn 100 lần (< 10ms so với < 1s)
  • Policy engine bảo mật toàn diện
  • Độ phủ kiểm thử rộng

Khi triển khai lộ trình này, ZeroClaw sẽ trở thành:

  • Cấp production với OS-level sandboxing
  • Nhận biết tài nguyên với bảo vệ memory/CPU
  • Sẵn sàng audit với logging chống giả mạo
  • Sẵn sàng doanh nghiệp với các cấp độ bảo mật có thể cấu hình

Công sức ước tính: 4-7 tuần để triển khai đầy đủ Giá trị: biến ZeroClaw từ "an toàn để kiểm thử" thành "an toàn cho production"