Skip to content

Secure, Fast, and Extensible Sandbox runtime for AI agents.

docs(releases): correct rc.2 notes per review (port-floor filename, classic-profile scoping, vault export failure semantics)

高然6325476b1023
diff --git a/docs/releases/1.2.0-rc.2.md b/docs/releases/1.2.0-rc.2.md
index 219ea2cf2..17c00f365 100644
--- a/docs/releases/1.2.0-rc.2.md
+++ b/docs/releases/1.2.0-rc.2.md
@@ -1,9 +1,9 @@
-Second release candidate on the `1.2.0` line, carrying everything merged since `release-1.2.0-rc.1` — the headline is the Credential Vault (OSEP-0022) landing end to end for fast sandboxes: an egress-held vault with durable per-subject persistence and pause/resume transfer, the user-reachable server-routed vault API, and a pool-pinned MITM CA. Network policy follows the same egress-held pattern, and `NetworkRule` gains port-scoped rules across the whole stack. Images publish now; SDK/CLI packages ship at the `1.2.0` stable bump. Please test and report issues.
+Second release candidate on the `1.2.0` line, carrying everything merged since `release-1.2.0-rc.1` — the headline is the Credential Vault (OSEP-0022) landing end to end for fast sandboxes: an egress-held vault with durable per-subject persistence and pause/resume transfer, the user-reachable server-routed vault API, and a pool-pinned MITM CA. Network policy follows the same egress-held pattern, and `NetworkRule` gains port-scoped rules in the classic profile — fast sandboxes reject them fail-closed until the fastlet nft path enforces them. Images publish now; SDK/CLI packages ship at the `1.2.0` stable bump. Please test and report issues.
## Highlights
- Credential Vault (OSEP-0022) lands end to end for fast sandboxes: the egress sidecar holds the vault with durable per-subject files, sealed snapshot transfer for pause/resume, and stale-subject takeover on slot reuse ([#2249](https://github.com/opensandbox-group/OpenSandbox/pull/2249) [#2252](https://github.com/opensandbox-group/OpenSandbox/pull/2252) [#2255](https://github.com/opensandbox-group/OpenSandbox/pull/2255) [#2250](https://github.com/opensandbox-group/OpenSandbox/pull/2250)); the server exposes the user-reachable `POST|GET|PATCH|DELETE /v1/sandboxes/{id}/credential-vault` API over the FastPath handler relay with credential values never appearing on any public read ([#2263](https://github.com/opensandbox-group/OpenSandbox/pull/2263)), and the MITM CA is pinned per pool so an egress restart no longer rotates the trust anchor under live sandboxes ([#2251](https://github.com/opensandbox-group/OpenSandbox/pull/2251))
-- Network policy mirrors the vault: the recorded fast-sandbox policy becomes egress-held state with relay CRUD, durable persistence, and pause/resume snapshot transfer ([#2309](https://github.com/opensandbox-group/OpenSandbox/pull/2309)), and `NetworkRule` gains port-scoped rules end to end — spec, sidecar nftables, server validation, and all five SDKs — plus an operator-side TCP port floor that no user policy can open ([#2212](https://github.com/opensandbox-group/OpenSandbox/pull/2212))
+- Network policy mirrors the vault: the recorded fast-sandbox policy becomes egress-held state with relay CRUD, durable persistence, and pause/resume snapshot transfer ([#2309](https://github.com/opensandbox-group/OpenSandbox/pull/2309)), and `NetworkRule` gains port-scoped rules end to end in the classic profile — spec, sidecar nftables, server validation, and all five SDKs, while fast sandboxes reject `ports` fail-closed for now — plus an operator-side TCP port floor that no user policy can open ([#2212](https://github.com/opensandbox-group/OpenSandbox/pull/2212))
- Lifecycle and diagnostics polish: `lifecycle.renewalPolicy` replaces the opaque renew extensions key (OSEP-0009) ([#2296](https://github.com/opensandbox-group/OpenSandbox/pull/2296)); the diagnostics context API reaches server, all five SDKs, and the CLI ([#2292](https://github.com/opensandbox-group/OpenSandbox/pull/2292)); execd fixes make start failures distinguishable, preserve session output byte-for-byte, and stop silent disk growth ([#2303](https://github.com/opensandbox-group/OpenSandbox/pull/2303) [#2318](https://github.com/opensandbox-group/OpenSandbox/pull/2318) [#2295](https://github.com/opensandbox-group/OpenSandbox/pull/2295))
## Server
@@ -60,11 +60,11 @@ Code changes below ride the `1.2.0` stable release — rc ships no SDK packages.
The OSEP-0022 vault items concern the `fast-sandbox` profile's credential-vault surface; the OSEP-0023 follow-ups remain scoped to the default-off experimental revision runtime.
- Add the egress-held vault for fast sandboxes (OSEP-0022), landing in stages: the internal `/vault/{sandboxUid}` relay surface with create-only POST (409 on duplicate, atomic across server replicas), full-revision PUT with `expectedRevision` and an `expectedIncarnation` precondition so a stale writer can never land on a reset's successor, value-including GET, and DELETE that keeps the policy ([#2249](https://github.com/opensandbox-group/OpenSandbox/pull/2249)); durable per-subject persistence — one file per subject under a Pod-scoped volume (optional tmpfs), the same commit protocol as policy files so **acked means durable and applied**, incarnation-fenced reload, and purge on unbind ([#2252](https://github.com/opensandbox-group/OpenSandbox/pull/2252)); and the superseded fastlet-proxy vault route removed with its pending-push cache ([#2247](https://github.com/opensandbox-group/OpenSandbox/pull/2247))
-- Carry the vault across pause/resume (OSEP-0022 "Vault Lifecycle"): `VAULT_EXPORT` copies the vault file into the snapshot bundle strictly before runtime teardown and seals the subject (all vault ops answer 409 while paused; enforcement continues), and `VAULT_IMPORT` is the only authorized incarnation transfer — the bundle re-stamps with the restored fence before `data-plane-ready`, validated against the current policy before any durable effect; any export failure leaves the subject unsealed so the pause proceeds and restore fails closed on the missing file ([#2255](https://github.com/opensandbox-group/OpenSandbox/pull/2255)); a `vaultTransfer` capability signal lets older fastlets skip the transfer instead of failing the checkpoint against a pre-vault egress ([#2290](https://github.com/opensandbox-group/OpenSandbox/pull/2290))
+- Carry the vault across pause/resume (OSEP-0022 "Vault Lifecycle"): `VAULT_EXPORT` copies the vault file into the snapshot bundle strictly before runtime teardown and seals the subject (all vault ops answer 409 while paused; enforcement continues), and `VAULT_IMPORT` is the only authorized incarnation transfer — the bundle re-stamps with the restored fence before `data-plane-ready`, validated against the current policy before any durable effect; a genuine export failure leaves the subject unsealed and fails the pause checkpoint, so teardown never runs without a bundle and the egress-local vault survives for the retry ([#2255](https://github.com/opensandbox-group/OpenSandbox/pull/2255)); a `vaultTransfer` capability signal lets an egress without vault persistence skip the transfer entirely — the checkpoint proceeds without the vault (pre-transfer semantics) instead of failing ([#2290](https://github.com/opensandbox-group/OpenSandbox/pull/2290))
- Define stale-subject takeover on slot reuse: the fast-sandbox dispatch key is the slot IP and slots are reused, so a `SET_BINDING` can claim a key still held by a dead-but-registered subject — egress now treats that as authoritative, tearing down the stale subject's nft rules, DNS refcount, MITM redirect, and vault slice under the registry lock before registering the successor deny-first; traffic is never dispatched to stale rules, late unloads stay fence-guarded no-ops, and every failure path leaves each subject either fully registered or fully evicted ([#2250](https://github.com/opensandbox-group/OpenSandbox/pull/2250))
- Pin the fast-sandbox MITM CA (OSEP-0022 "MITM Trust Anchor"): the pool-pinned, versioned CA is seeded from a read-only secret mount into the mitmdump confdir (idempotent, fail-closed on an unloadable pair), replacing generate-on-start — an egress restart no longer rotates the CA and silently invalidates every live sandbox's TLS trust; a missing or mismatched CA refuses only the MITM addon (policy enforcement unaffected) with `mitmCaFingerprint` / `mitmCaDown` surfaced on `/healthz` and the actions status, so a template↔pool Secret mispairing is visible at a glance ([#2251](https://github.com/opensandbox-group/OpenSandbox/pull/2251))
- Align the fast-sandbox network policy with the vault pattern: the recorded policy becomes egress-held state — a `/policy/{sandboxUid}` relay surface with revision preconditions (unknown subject 404, incarnation mismatch 412, sealed 409), durable per-subject files using the same commit protocol, `POLICY_EXPORT`/`POLICY_IMPORT` snapshot transfer mirroring the vault, and, after an egress restart, the committed file superseding the replayed create-time binding input ([#2309](https://github.com/opensandbox-group/OpenSandbox/pull/2309))
-- Support port-scoped egress rules end to end (classic profile): `NetworkRule.ports` (TCP 1–65535, ≤256 per rule) makes `target` optional — port-only rules, or ports combined with an IP/CIDR; domain+`ports` is rejected since domain rules evaluate at the DNS proxy layer; deny-before-allow precedence holds across scoping, and a PATCH merge-key bug that let a second port-only rule evict the first is fixed; an operator-shipped `reachable.ports.always` whitelist is enforced as an always-deny ahead of every user rule so even `defaultAction: allow` cannot open a non-whitelisted port; the fast-sandbox route rejects `ports` with 400 until the fastlet nft path can enforce them (fail-closed, documented) ([#2212](https://github.com/opensandbox-group/OpenSandbox/pull/2212))
+- Support port-scoped egress rules end to end (classic profile): `NetworkRule.ports` (TCP 1–65535, ≤256 per rule) makes `target` optional — port-only rules, or ports combined with an IP/CIDR; domain+`ports` is rejected since domain rules evaluate at the DNS proxy layer; deny-before-allow precedence holds across scoping, and a PATCH merge-key bug that let a second port-only rule evict the first is fixed; an operator-shipped `reachable.ports.cap` whitelist is enforced as an always-deny ahead of every user rule so even `defaultAction: allow` cannot open a non-whitelisted port; the fast-sandbox route rejects `ports` with 400 until the fastlet nft path can enforce them (fail-closed, documented) ([#2212](https://github.com/opensandbox-group/OpenSandbox/pull/2212))
- Add static TLS passthrough selectors to the experimental live-revision runtime: `OPENSANDBOX_EGRESS_MITMPROXY_PASSTHROUGH_HOSTS` is a bounded exact/wildcard host array applied at ClientHello with 443-overlap rejection; existing nonempty native `ignore_hosts`/`allow_hosts` now **reject startup in live mode** — migrate static TLS bypass entries to the array (legacy mode unchanged, no public interceptionMode added) ([#2229](https://github.com/opensandbox-group/OpenSandbox/pull/2229))
- Emit TLS admission counters: one best-effort event per final ClientHello admission feeds `egress.mitm.tls.connections_total` with closed `mode`/`decision`/`reason` labels — it measures admission decisions, not handshakes or requests, and is explicitly not security evidence ([#2265](https://github.com/opensandbox-group/OpenSandbox/pull/2265))
- Add the installation-only subject revision IPC foundation (OSEP-0023 Phase 4): an authenticated v2 Unix-socket channel routes target-bound revision transactions to independent, admission-disabled installation receivers with frozen request bytes and lost-reply reconciliation; no production caller yet ([#2284](https://github.com/opensandbox-group/OpenSandbox/pull/2284))