openclaw/extensions/browser/src/security-audit.test.ts

import { describe, expect, it } from "vitest";
import { collectBrowserSecurityAuditFindings } from "./security-audit.js";

function collectFindings(
  config: Parameters<typeof collectBrowserSecurityAuditFindings>[0]["config"],
) {
  return collectBrowserSecurityAuditFindings({
    config,
    sourceConfig: config,
    env: {} as NodeJS.ProcessEnv,
    stateDir: "/tmp/openclaw-state",
    configPath: "/tmp/openclaw.json",
  });
}

function findingByCheckId(
  findings: ReturnType<typeof collectBrowserSecurityAuditFindings>,
  checkId: string,
) {
  const finding = findings.find((candidate) => candidate.checkId === checkId);
  if (!finding) {
    throw new Error(`expected browser security finding ${checkId}`);
  }
  return finding;
}

describe("browser security audit collector", () => {
  it("flags browser control without auth", () => {
    const findings = collectFindings({
      gateway: {
        controlUi: { enabled: false },
        auth: {},
      },
      browser: {
        enabled: true,
      },
    });

    const finding = findingByCheckId(findings, "browser.control_no_auth");
    expect(finding.severity).toBe("critical");
  });

  it("warns on remote http CDP profiles", () => {
    const findings = collectFindings({
      browser: {
        profiles: {
          remote: {
            cdpUrl: "http://example.com:9222",
            color: "#0066CC",
          },
        },
      },
    });

    const finding = findingByCheckId(findings, "browser.remote_cdp_http");
    expect(finding.severity).toBe("warn");
  });

  it("redacts private-host CDP URLs in findings", () => {
    const findings = collectFindings({
      browser: {
        ssrfPolicy: {
          dangerouslyAllowPrivateNetwork: true,
        },
        profiles: {
          remote: {
            cdpUrl:
              "http://169.254.169.254:9222/json/version?token=supersecrettokenvalue1234567890",
            color: "#0066CC",
          },
        },
      },
    });

    const finding = findingByCheckId(findings, "browser.remote_cdp_private_host");
    expect(finding.severity).toBe("warn");
    expect(finding.detail).toContain("token=supers…7890");
  });
});