Skip to content

Security: dpc/rostra

Security

SECURITY.md

Agent-browser security boundaries

Rostra's preview-rostra skill drives a signing-capable development UI with an external browser daemon. Treat the daemon, browser process, local host, page content, and development identity as security boundaries rather than ordinary test fixtures.

Canonical resource URL resolution

First-party UI routes accept legacy full RostraId and EventId path components, but generate short forms. Resolve a short RostraId only through the retained identity index. Resolve a full EventId through its short retained-event key and verify that the retained signed envelope recomputes to that exact full ID before shortening it. Never treat a matching short prefix as proof of a full EventId.

Before redirecting or serving an author-scoped resource, bind the route author to the retained envelope and, where applicable, to the materialized social-post record. GET and HEAD requests that use a legacy form return a 308 canonical URL without discarding the query string. Mutation POST routes resolve either form in place; they must not rely on a redirect to preserve the request body.

Private-message HTTP access

The functionality/security balance for these routes is governed by REQ-ui-functionality-security. Every /messages and /settings/messages request requires the exact requesting session's in-memory identity secret and a matching full active client. A second session's activation, a public-only login, or an open database is not authority to read plaintext or manage devices. POST forms require an independent random session-bound synchronizer token before any mutation; it is not the session credential. Full and short identity paths resolve through the ordinary retained identity rules before use.

These workflows return ordinary complete HTML pages and 303 redirects and remain usable without JavaScript. Thread composers use the same self-hosted Alpine persistence mechanism as new-post forms for account-and-recipient-scoped browser drafts and Ctrl+Enter submission. Message text uses the same sanitized Djot renderer as posts. Renderer output remains non-executable, and the private-page CSP prevents message content from initiating third-party media requests. All response classes, including extractor errors, missing routes, and redirects, use private/no-store caching, identity/no-compression, no-referrer, nosniff, framing denial, and a restrictive CSP that permits only the required same-origin scripts, CSS, fonts, images, and forms. It permits inline styles for the self-hosted MathJax renderer, while sanitized message content cannot supply style elements or attributes. Alpine's AJAX requests have same-origin connect access, and its attribute expression evaluator requires unsafe-eval; no inline or remote script source is allowed. The message workflow does not copy plaintext into request URLs, logs, delivery receipts, or decryption-result callbacks; rendered safe links remain user-controlled navigation targets. Local plaintext, including browser-persisted drafts, persists independently of ciphertext and epoch-key deletion; this is not endpoint or forensic-storage confidentiality.

Open conversations refresh through the existing authenticated UI websocket and ordinary authorized HTML requests, not a new periodic polling loop. The local background DM worker publishes coalesced, content-free progress wakeups after every committed serviced trial batch, whether it succeeds, misses, or discards an invalid queued item. These wakeups contain no identities, plaintext, arrival sequences, or decryption results, and never reach the p2p transport. The websocket rechecks the exact session's in-memory secret and full-client authority before forwarding a wakeup. Each resulting history request enforces the usual private-message authorization and response protections independently. Arrival cursors are independent of signed timestamps and session read markers; bounded pages catch up without losing delayed messages or arrivals another tab already read. Hidden conversations defer work until visible, overlapping notifications coalesce, and navigation stops further requests. A lost websocket or failed request can leave the view stale until a new wakeup, visibility change, or ordinary reload; live updates are an enhancement, not delivery receipts. Changes to notification payloads, their destination, or their relationship to decryption outcomes must recheck this boundary and the receive-security proof.

The named script, CSP, and browser-storage details describe the current implementation, not immutable stakeholder choices. Changes may use other mechanisms only while preserving the governing requirement and the authorization, escaping, response-protection, and leakage boundaries above.

User-controlled media responses

The new-post Add link helper accepts credential-free HTTP(S) URLs and produces escaped Djot, using the renderer's YouTube and Twitter/X post recognition. Optional title retrieval requires the requesting session's in-memory identity secret. It sends no incoming cookies, authorization, or referrer, and does not use environment proxies. Only ports 80 and 443 and conservatively validated public addresses are fetched. Every redirect repeats validation; validated DNS answers are pinned for the actual connection to prevent DNS rebinding. Retrieval is limited to three redirects, eight seconds overall, 256 KiB per response, and four concurrent requests. Recognized YouTube videos use the fixed YouTube oEmbed JSON endpoint with a canonical video URL; only its plain title is used, never its HTML, thumbnails, or other media fields. Recognized Twitter/X posts use the fixed publish.x.com/oembed JSON endpoint with a canonical post URL. Only plain text from the returned post paragraph becomes an editable, bounded title; script, style, and template content is excluded, and returned HTML is never rendered. Other links retain HTML title extraction. Metadata is plain, bounded, editable text, never markup or executable code. Retrieval failure leaves manual insertion available. The request intentionally discloses the chosen URL to its website from the Rostra server.

Twitter/X posts use the existing external-media load presentation. The first explicit activation assigns a fixed HTTPS platform.twitter.com/embed/Tweet.html URL to an iframe; no provider request occurs before that action. Only validated numeric post IDs enter the URL. Provider scripts never run in the signing-capable application document, and remote embed HTML is never accepted. The frame's sandbox allows scripts and the provider's own origin, but not top navigation; do not replace the fixed cross-origin URL with srcdoc or an app-origin wrapper under these permissions. The frame suppresses referrers and requests X's do-not-track mode, but expansion still discloses the viewer's IP address and allows X's media requests. Private-page CSP blocks the initial third-party frame navigation. Without JavaScript, the keyboard-accessible load link performs ordinary navigation instead.

Post frames are responsive and accept height-only resize notifications. The first-party listener requires the exact provider origin and the exact visible, marked iframe's contentWindow, validates the twttr.embed resize notification shape, and limits heights to 64–4096 pixels. Reported widths, element IDs, HTML, URLs, and other provider actions confer no authority.

Social-media event bytes and profile avatar bytes are untrusted even when their event signatures verify. An avatar must declare and contain one of AVIF, BMP, GIF, ICO, JPEG, PNG, SVG, TIFF, or WebP. SVG is fully parsed without a document type and is limited to the existing 1 MB avatar limit. Validate locally submitted avatars and repeat validation when serving retained data; signed event compatibility still permits historical malformed declarations.

The content renderer and /media/... route only embed and serve inline a declared type when its detected bytes match the intentional passive set: those image formats, plus MP4 and WebM video. Every other generic media response, including a MIME mismatch, unknown binary data, and active content, uses application/octet-stream and Content-Disposition: attachment with the fixed rostra-media.bin filename. Never derive a download filename from an author declaration or post text.

All avatar and generic-media responses use X-Content-Type-Options: nosniff and a sandboxing Content Security Policy that denies default sources, base URLs, and form submission. Set these headers before conditional ETag handling so 304 Not Modified preserves the security policy and representation metadata, including attachment disposition.

The skill wrapper loads a known-empty configuration and clears environment settings that could silently select persistent profiles or state, remote CDP or cloud providers, proxies, extensions, init scripts, plugins, and browser arguments. Do not bypass the wrapper. Refuse a pre-existing task session because launch-time restrictions cannot be retrofitted reliably.

Agent-browser's domain allowlist accepts the IPv6 host [::1], not an exact port. It therefore permits navigation to every HTTP service on that loopback host. Inspect link targets and form actions before authenticated activation, verify the exact origin after navigation, and do not treat the allowlist as an origin boundary.

Agent-browser controls Chromium and its daemon with the invoking user's privileges. A browser, proxy, extension, init script, plugin, provider, or remote CDP endpoint can observe credentials and page data. Use only the local Chromium launched through the skill wrapper on a trusted single-user host.

Agent-browser's auth vault encrypts credentials, but stores the vault and its decryption key under the same user account. A task-scoped vault entry is a temporary duplicate of the development mnemonic, not an independent security boundary. Create one only after explicit approval, delete it immediately after the login attempt, never reuse it, and report interrupted cleanup.

Snapshots, screenshots, downloads, traces, state files, and browser profiles can contain live or secret data. The skill forbids plaintext state and persistent profiles by default. Create approved artifacts with owner-only permissions under a task-unique directory, inspect only what is needed, and remove artifacts on success and handled failure.

Every secure non-AJAX /unlock render embeds a freshly generated, unused credential so Create Account can fill the login fields without a request. This makes merely opening that page credential-bearing: browser processes, same-origin scripts, proxies, extensions, snapshots, screenshots, page source, and DOM inspection can receive the mnemonic. Sensitive response headers reduce caching and framing risks but do not prevent that exposure. Use /unlock only on the trusted local single-user host, do not inspect or capture it, and authenticate immediately when it is unavoidable. This accepted risk is inherent in the chosen in-place interaction; revisit it if /unlock gains third-party scripts, if the browser isolation model changes, or if another account-creation flow is added.

An authenticated browser grants signing authority and can start network-visible activity. Rostra's masked identity page still contains the recovery phrase in the DOM. Never open or inspect /settings/identity. Log out and verify /unlock before closing. Browser or logout failure can leave server-memory authority; close the task session, remove its vault entry, report the failure, and restart just dev before relying on cleanup.

There aren't any published security advisories