Browser-based graphical shell and control plane for a Linux server you own — real terminal, file manager, live metrics and BYOK AI in one mobile-first workspace. Next.js 16 · React 19 · node-pty · Tailwind v4 · shadcn/ui. Public alpha, self-hosted.
TypeScript browser-shellcontrol-planefile-managerhomelabmobile-firstnextjsptyreactself-hostedserver-managementshadcn-uisysadmintailwindcssterminaltypescriptvpsweb-desktopweb-terminal
// Policy scoping + redirect plumbing for the managed-app proxy, unit-tested
// straight off the pure helpers (the policy itself is proxy-csp.test.ts; the route
// wiring is covered in app/api/v1/managed-apps/proxy.test.ts).
import { describe, expect, it } from "vitest";
import {
buildUpstreamHeaders,
isServiceWorkerPath,
proxyPrefix,
rewriteLocation,
rewriteSetCookie,
upstreamCookieHeader,
cookiePrefix,
} from "./proxy-headers";
const PREFIX = proxyPrefix("hermes");
describe("host-bound app cookies", () => {
it("forces host-only Secure root cookies while preserving JS-readable CSRF cookies", () => {
expect(rewriteSetCookie("csrf=value; Domain=.mso.example.com; Path=/login; SameSite=None; Max-Age=60", "hermes", true, ""))
.toBe("__Host-mapp_hermes_csrf=value; Max-Age=60; Path=/; SameSite=Lax; Secure");
expect(rewriteSetCookie("session=s; HttpOnly", "hermes", true, "")).toContain("HttpOnly");
expect(rewriteSetCookie("session=s", "hermes", false, "")).toBeNull();
expect(rewriteSetCookie("session=s", "hermes", true, PREFIX)).toBeNull();
});
it.each(["real; __Host-mapp_hermes_session=shadow", "shadow; __Host-mapp_hermes_session=real"])("rejects duplicate session cookies regardless of path ordering: %s", (value) => {
expect(upstreamCookieHeader(`__Host-mapp_hermes_session=${value}`, cookiePrefix("hermes"))).toBeNull();
});
it("rejects legacy/domain cookie names and sibling namespaces", () => {
expect(upstreamCookieHeader("mapp_hermes_session=shadow; __Host-mapp_openclaw_session=sibling", cookiePrefix("hermes"))).toBeNull();
expect(upstreamCookieHeader("mapp_hermes_session=shadow; __Host-mapp_hermes_session=real", cookiePrefix("hermes"))).toBe("session=real");
});
});
describe("buildUpstreamHeaders", () => {
const base = new URL("http://127.0.0.1:9119");
const withHeaders = (init: Record<string, string>) =>
new Request("https://hermes.mso.example.com/api/config", { headers: init });
it("forwards Hermes' own session token, because dropping it 401s every fetch", () => {
// Loopback Hermes injects an ephemeral token into the SPA HTML and requires it
// back as X-Hermes-Session-Token. Stripping it renders the shell and no data —
// the exact failure this test exists to keep out.
const out = buildUpstreamHeaders(withHeaders({ "x-hermes-session-token": "tok" }), base, "hermes");
expect(out.get("x-hermes-session-token")).toBe("tok");
});
it("does not lend that header to a different app's upstream", () => {
const out = buildUpstreamHeaders(withHeaders({ "x-hermes-session-token": "tok" }), base, "openclaw");
expect(out.get("x-hermes-session-token")).toBeNull();
});
it("still refuses to relay Authorization for anyone", () => {
// Unlike the token above, this one a browser attaches by itself once prompted.
const out = buildUpstreamHeaders(withHeaders({ authorization: "Basic abc" }), base, "hermes");
expect(out.get("authorization")).toBeNull();
});
it("keeps the cockpit session cookie on this side of the boundary", () => {
const out = buildUpstreamHeaders(
withHeaders({ cookie: "session=cockpit; __Host-mapp_hermes_hermes_session_at=upstream" }),
base,
"hermes",
);
expect(out.get("cookie")).toBe("hermes_session_at=upstream");
});
});
describe("isServiceWorkerPath", () => {
it("catches the script OpenClaw actually registers, at any depth", () => {
expect(isServiceWorkerPath(["sw.js"])).toBe(true);
expect(isServiceWorkerPath(["control-ui", "sw.js"])).toBe(true);
expect(isServiceWorkerPath(["SW.JS"])).toBe(true);
expect(isServiceWorkerPath(["service-worker.js"])).toBe(true);
expect(isServiceWorkerPath(["serviceworker.js"])).toBe(true);
});
it("leaves ordinary assets alone", () => {
expect(isServiceWorkerPath([])).toBe(false);
expect(isServiceWorkerPath(["assets", "index-CEmUNp2y.js"])).toBe(false);
expect(isServiceWorkerPath(["sw.js", "chat"])).toBe(false);
expect(isServiceWorkerPath(["assets", "swift-BTPQlRLK.js"])).toBe(false);
});
});
describe("rewriteLocation", () => {
const base = new URL("http://127.0.0.1:9119");
const target = new URL("http://127.0.0.1:9119/chat");
it("re-bases a same-origin hop onto the proxy prefix", () => {
expect(rewriteLocation("/login?next=%2F", target, base, "hermes")).toBe(
`${PREFIX}/login?next=%2F`,
);
expect(rewriteLocation("http://127.0.0.1:9119/chat", target, base, "hermes")).toBe(
`${PREFIX}/chat`,
);
});
it("re-bases a relative Location against the URL actually requested", () => {
const deep = new URL("http://127.0.0.1:9119/chat/threads");
expect(rewriteLocation("42", deep, base, "hermes")).toBe(`${PREFIX}/chat/42`);
});
it("refuses an absolute off-origin Location instead of relaying it", () => {
// Emitting this turns the proxy into an open redirect, and per CSP3
// §6.6.2.6 path matching stops applying after the first hop.
expect(rewriteLocation("https://accounts.google.com/o/oauth2/auth?client_id=x", target, base, "hermes")).toBeNull();
});
it("refuses a protocol-relative Location, the cheapest open-redirect payload", () => {
expect(rewriteLocation("//evil.example", target, base, "hermes")).toBeNull();
expect(rewriteLocation("//evil.example/path?a=b", target, base, "hermes")).toBeNull();
});
it("refuses a neighbouring loopback port — same host is not same origin", () => {
expect(rewriteLocation("//127.0.0.1:1234", target, base, "hermes")).toBeNull();
expect(rewriteLocation("http://127.0.0.1:1234/admin", target, base, "hermes")).toBeNull();
});
it("refuses a scheme that is not the upstream's, and keeps junk inside the prefix", () => {
// javascript:/data: resolve to an opaque origin, so the origin check refuses them.
expect(rewriteLocation("javascript:alert(1)", target, base, "hermes")).toBeNull();
expect(rewriteLocation("data:text/html,<script>1</script>", target, base, "hermes")).toBeNull();
// A malformed value the browser would treat as a relative path stays a relative
// path — inside the prefix, which is the property that matters.
expect(rewriteLocation("::nonsense", target, base, "hermes")).toBe(`${PREFIX}/::nonsense`);
});
it("treats an empty Location as no redirect at all", () => {
// Resolves to the request target itself; the route never calls it (falsy),
// but if it ever did, the answer must stay inside the prefix.
expect(rewriteLocation("", target, base, "hermes")).toBe(`${PREFIX}/chat`);
});
});