Security Model
Capability-based access control, the governance gate, mesh transport and peer admission, tokens, revocation, rate limiting, message limits and browser sandboxing, each with the file that implements it.
WeftOS applies several independent controls. This page lists each with its source; it does not rate the combined posture. For the operator reference see docs/reference/security.md and, for agents, the Capabilities and Governance pages.
Capability-based access control
Every agent process carries AgentCapabilities (spawn, IPC, tool and network flags, an IPC scope and resource limits), and CapabilityChecker enforces them (crates/clawft-kernel/src/capability.rs). See Capabilities.
Dual-layer governance gate
With the governance gate wired in at boot, a message is checked at routing in A2ARouter::send and again at handler time in the agent loop (Symposium D7; boot.rs, a2a.rs, agent_loop.rs). A routing Deny stops delivery; a routing Defer still delivers and the handler decides. See Governance, including the default-deny rule for workload.* actions.
Mesh transport encryption
Mesh streams are wrapped in a Noise session (crates/clawft-kernel/src/mesh_noise.rs): the XX pattern for first contact (mutual authentication) and IK for a known responder key, using Noise_XX_25519_ChaChaPoly_SHA256 for XX. The QUIC transport (mesh_quic.rs, ADR-026) uses quinn's TLS only to satisfy the QUIC handshake: it mints an ephemeral self-signed certificate on listen and skips certificate verification on connect, because the Noise session authenticates the peer. QUIC without a Noise session would therefore be unauthenticated.
The mesh listener defaults to loopback 127.0.0.1:9489 (CHANGELOG 0.8.4-rc.1); a machine must be configured to listen on a LAN address.
Post-quantum pieces
- ML-KEM-768 key exchange: placeholder, not protection.
mesh_noise.rsdefinesKemConfig, a negotiation result and aHybridKeyExchange, andWeftHandshakecarries akem_supportedflag (mesh.rs). The exchange step is a stand-in:KemUpgrade::executederives the "post-quantum" secret as a SHA-256 of the stringml-kem-768-simulatedplus the remote public key, and its own comment says a real implementation would use ML-KEM-768 encapsulate and decapsulate. Do not rely on it for quantum resistance. The classical Noise session (X25519, ChaCha20-Poly1305) is what protects mesh traffic. - ML-DSA-65 chain signatures:
ChainManagercan hold an ML-DSA-65 key next to the Ed25519 key anddual_signevents; the key is optional (chain.rs). See ExoChain.
Peer admission
After the optional Noise handshake, a peer may send an AdmitHello that signs the session's Noise handshake hash (so a captured hello cannot be replayed on another session) and binds the node id to the Ed25519 key the id is derived from (crates/clawft-kernel/src/mesh_admit.rs). Policy sits behind AdmissionGate: AllowAll is the default behaviour, and CryptoGate implements off, observe and enforce using a pinned governance genesis hash, revocation and a verdict source. At boot, kernel.mesh.admission = "enforce" requires kernel.mesh.genesis_hash (boot.rs). A peer's claimed destination scope is ignored, and its source scope is kept only when admission verified the peer.
Revocation
A persistent host ban list is loaded at boot and checked in the peer handshake (revocation.rs). The same list revokes package ids, signer keys and artifact hashes for workloads (ADR-099 section 7).
Bearer tokens
The daemon is the single issuer and validator of bearer tokens (token_authority/, ADR-102 D3 and D4). A token is a 256-bit random secret shown once to the issuer; only its SHA-256 is kept, and every issue and revoke is a chain event. A token has owner scope, so it is owner-equivalent with one exception enforced in the daemon: a token cannot issue, revoke or list tokens. The TTL is the limit.
Rate limiting
rate_limit.rs provides a keyed sliding-window limiter (WEFT-148) used per source on ClusterMembership::add_peer and per principal on GovernanceEngine::evaluate. A limit of 0 disables it. Separately, ResourceLimits caps messages and tool calls per agent, and the WASM runner meters fuel; see WASM Sandbox.
Message size limits
16 MiB maximum: MAX_MESSAGE_SIZE for mesh framing (mesh.rs, mesh_framing.rs) and KERNEL_IPC_MAX_MESSAGE_BYTES for kernel IPC (ipc.rs).
Peer capability validation
WeftHandshake carries governance_genesis_hash, a governance version string, a capabilities bitmap, the kem_supported flag, the chain head sequence and the supported sync streams (mesh.rs). Capability tokens a peer advertises are checked against an allow-list and an Ed25519 signature (capability_claim.rs).
Browser sandboxing
AgentCapabilities::browser_default() gives no spawning, no network, a restricted IPC scope (public topics only) and lower limits; three default browser_policy rules (BP-001 to BP-003) block the same things without elevation, and elevation goes through the governance gate (capability.rs, governance.rs).
Chain integrity
SHAKE-256 hash linking, Ed25519 signatures, optional ML-DSA-65 dual signing and witness-chain verification (chain.rs). The governance.genesis event anchors the rule set, and a pinned genesis hash is what peers compare at admission.
Updates and releases
weaver update verifies release signatures and fails closed (CHANGELOG 0.8.2). The wasmtime sandbox-escape fix shipped in 0.8.4-rc.15 (wasmtime 48.0.7, CHANGELOG rc.15). See Update and signing.
Persistence
What is persisted to disk at 0.8.4: the chain and tree checkpoints, cluster and app catalogs, and the JSON save/load helpers for the causal graph and HNSW index.
Platform features
What shipped in the 0.8.x line beyond the kernel: cogs, the cog data plane, governed placement, exposures, the Seed licence proxy, project topology, the tailnet router, the chief of staff, the AI org, voice, and verified updates. Each page states its ADR status and what is built.