@bitkyc08/opencodex
Version:
Universal provider proxy for OpenAI Codex & Claude Code — use any LLM with Codex CLI/App/SDK and Claude Code
628 lines (580 loc) • 29.3 kB
text/typescript
import { createHash, randomUUID, X509Certificate } from "node:crypto";
import {
chmodSync, closeSync, constants, fstatSync, lstatSync, mkdirSync, openSync, readFileSync,
readSync, renameSync, rmSync, statSync, writeFileSync, type BigIntStats,
} from "node:fs";
import { dirname, isAbsolute, join, posix } from "node:path";
import { canonicalPickerConfigDir, ensurePersistentPickerCa } from "./picker-ca-persistence";
import type { PickerCaStore } from "./picker-ca-store";
import { withClientLifecycle, withClientLifecycleSync } from "../../client/lifecycle-lock";
import { sameFileIdentity } from "../../lib/file-identity";
import {
ALL_IP_ADDRESS_BASES,
createCertificateAuthority,
issueServerLeaf,
type LocalInterceptCa,
type PemKeyPair,
} from "./local-ca";
/** Separate root for Desktop traffic: its critical DNS constraint is checked on every reload. */
export const PICKER_HOST = "claude.ai";
export const PICKER_CA_COMMON_NAME = "opencodex Claude Desktop Picker CA";
export const PICKER_STATE_DIR = "claude-picker";
export interface PickerCa extends LocalInterceptCa { fingerprint: string }
export interface LinuxPickerTrustStore { dir: string; directoryId: string; certDbId: string }
export interface PendingPickerCaUntrust { certPem: string; sha1: string; sha256: string; linuxStore?: LinuxPickerTrustStore }
const processAuthorities = new Map<string, PickerCa>();
const MAX_PENDING_CA_BYTES = 64 * 1024;
const LEGACY_OWNER_MTIME_TOLERANCE_MS = 2_000;
export function pickerStateDir(configDir: string): string { return join(configDir, PICKER_STATE_DIR); }
export function pickerCaCertPath(configDir: string): string { return join(pickerStateDir(configDir), "ca.pem"); }
export function pickerLeafCertPath(configDir: string): string { return join(pickerStateDir(configDir), "leaf.pem"); }
export function pickerCaOwnerPath(configDir: string): string { return join(pickerStateDir(configDir), "ca-owner.json"); }
export function pickerCaPendingUntrustPath(configDir: string): string { return join(pickerStateDir(configDir), "pending-untrust.json"); }
function pickerCaLockPath(configDir: string): string { return join(pickerStateDir(configDir), "ca.lock.sqlite"); }
function linuxTrustStorePath(configDir: string): string { return join(pickerStateDir(configDir), "linux-trust-store.json"); }
function isLinuxPickerTrustStore(value: unknown): value is LinuxPickerTrustStore {
if (!value || typeof value !== "object" || Object.keys(value).sort().join(",") !== "certDbId,dir,directoryId") return false;
const store = value as Partial<LinuxPickerTrustStore>;
const validIdentity = (id: unknown) => typeof id === "string" && /^\d+:[1-9]\d*$/.test(id);
return typeof store.dir === "string" && (isAbsolute(store.dir) || posix.isAbsolute(store.dir))
&& !store.dir.includes("\0") && !store.dir.split(/[/\\]/).includes("..")
&& validIdentity(store.directoryId) && validIdentity(store.certDbId);
}
export function sameLinuxPickerTrustStore(a?: LinuxPickerTrustStore, b?: LinuxPickerTrustStore): boolean {
return a?.dir === b?.dir && a?.directoryId === b?.directoryId && a?.certDbId === b?.certDbId;
}
export function pickerCaFingerprints(certPem: string): { sha1: string; sha256: string } {
const der = new X509Certificate(certPem).raw;
return {
sha1: createHash("sha1").update(der).digest("hex").toUpperCase(),
sha256: createHash("sha256").update(der).digest("hex").toUpperCase(),
};
}
interface DerItem { tag: number; body: Buffer; next: number }
function readDer(bytes: Buffer, at: number): DerItem | null {
if (at + 2 > bytes.length) return null;
const tag = bytes[at]!;
let length = bytes[at + 1]!;
let cursor = at + 2;
if (length & 0x80) {
const width = length & 0x7f;
if (width === 0 || width > 4 || cursor + width > bytes.length) return null;
length = 0;
for (let i = 0; i < width; i++) length = length * 256 + bytes[cursor++]!;
}
if (cursor + length > bytes.length) return null;
return { tag, body: bytes.subarray(cursor, cursor + length), next: cursor + length };
}
function children(bytes: Buffer): DerItem[] | null {
const out: DerItem[] = [];
for (let cursor = 0; cursor < bytes.length;) {
const item = readDer(bytes, cursor);
if (!item) return null;
out.push(item);
cursor = item.next;
}
return out;
}
function constrainedToPickerHost(value: Buffer): boolean {
const root = readDer(value, 0);
if (!root || root.tag !== 0x30 || root.next !== value.length) return false;
const fields = children(root.body);
if (!fields || fields.length !== 2 || fields[0]!.tag !== 0xa0 || fields[1]!.tag !== 0xa1) return false;
const excluded = children(fields[1]!.body);
const excludesAllIps = excluded?.length === ALL_IP_ADDRESS_BASES.length && excluded.every((subtree, index) => {
const base = subtree.tag === 0x30 ? children(subtree.body) : null;
return base?.length === 1 && base[0]!.tag === 0x87
&& base[0]!.body.equals(Buffer.from(ALL_IP_ADDRESS_BASES[index]!));
});
if (!excludesAllIps) return false;
const subtrees = children(fields[0]!.body);
const subtree = subtrees?.length === 1 && subtrees[0]!.tag === 0x30 ? children(subtrees[0]!.body) : null;
return subtree?.length === 1 && subtree[0]!.tag === 0x82
&& subtree[0]!.body.equals(Buffer.from(PICKER_HOST, "ascii"));
}
interface ParsedExtension { oid: Buffer; critical: boolean; value: Buffer }
/** One Extension SEQUENCE → oid, criticality, and extnValue bytes; malformed shapes return null. */
function parseExtension(item: DerItem): ParsedExtension | null {
if (item.tag !== 0x30) return null;
const fields = children(item.body);
if (!fields || fields.length < 2 || fields.length > 3 || fields[0]!.tag !== 0x06) return null;
const value = fields[fields.length - 1]!;
if (value.tag !== 0x04) return null;
if (fields.length === 2) return { oid: fields[0]!.body, critical: false, value: value.body };
// DER encodes the critical flag only as BOOLEAN TRUE; anything else is not a real extension.
if (fields[1]!.tag !== 0x01 || !fields[1]!.body.equals(Buffer.from([0xff]))) return null;
return { oid: fields[0]!.body, critical: true, value: value.body };
}
// DER OID bodies for the only four extensions a picker authority carries. A SAN, an EKU, or any
// other extension means the certificate is not a picker authority, whatever its subject claims.
const EXT_BASIC_CONSTRAINTS = "551d13";
const EXT_KEY_USAGE = "551d0f";
const EXT_SUBJECT_KEY_IDENTIFIER = "551d0e";
const EXT_NAME_CONSTRAINTS = "551d1e";
const PICKER_CA_EXTENSION_OIDS = new Set([
EXT_BASIC_CONSTRAINTS, EXT_KEY_USAGE, EXT_SUBJECT_KEY_IDENTIFIER, EXT_NAME_CONSTRAINTS,
]);
/** basicConstraints CA:TRUE with pathLenConstraint 0 — the anchor signs leaves, not other CAs. */
const PICKER_CA_BASIC_CONSTRAINTS = Buffer.from([0x30, 0x06, 0x01, 0x01, 0xff, 0x02, 0x01, 0x00]);
/** keyUsage keyCertSign | cRLSign only — the anchor can never sign a TLS handshake itself. */
const PICKER_CA_KEY_USAGE = Buffer.from([0x03, 0x02, 0x01, 0x06]);
/**
* The trust decision accepts exactly the extension profile createCertificateAuthority emits, not
* merely a certificate that happens to contain the right name constraint. A root that also carries
* leaf privileges (SAN, serverAuth EKU, digitalSignature) could be presented directly as an
* off-host server certificate, where name constraints on subordinates no longer apply.
*/
function acceptsExtensionProfile(extensions: DerItem[]): boolean {
const seen = new Set<string>();
for (const item of extensions) {
const extension = parseExtension(item);
if (extension === null) return false;
const key = extension.oid.toString("hex");
if (!PICKER_CA_EXTENSION_OIDS.has(key) || seen.has(key)) return false;
seen.add(key);
switch (key) {
case EXT_BASIC_CONSTRAINTS:
if (!extension.critical || !extension.value.equals(PICKER_CA_BASIC_CONSTRAINTS)) return false;
break;
case EXT_KEY_USAGE:
if (!extension.critical || !extension.value.equals(PICKER_CA_KEY_USAGE)) return false;
break;
case EXT_SUBJECT_KEY_IDENTIFIER: {
const id = readDer(extension.value, 0);
if (extension.critical || id === null || id.tag !== 0x04 || id.next !== extension.value.length) return false;
break;
}
default:
if (!extension.critical || !constrainedToPickerHost(extension.value)) return false;
}
}
return seen.size === PICKER_CA_EXTENSION_OIDS.size;
}
/** Independently authorize a root before installing it as system trust. */
export function acceptsPickerAuthority(certPem: string): boolean {
try {
const cert = new X509Certificate(certPem);
const names = cert.subject.split("\n");
if (!names.includes(`CN=${PICKER_CA_COMMON_NAME}`)) return false;
if (names.filter(line => line.startsWith("CN=")).length !== 1) return false;
// A picker authority is self-issued and self-signed; a foreign issuer is not one of ours.
if (cert.issuer !== cert.subject || !cert.verify(cert.publicKey)) return false;
const root = readDer(cert.raw, 0);
const certificate = root?.tag === 0x30 && root.next === cert.raw.length ? children(root.body) : null;
const tbs = certificate?.[0]?.tag === 0x30 ? children(certificate[0].body) : null;
const extensionField = tbs?.find(item => item.tag === 0xa3);
const wrapped = extensionField && readDer(extensionField.body, 0);
const extensions = wrapped?.tag === 0x30 && wrapped.next === extensionField!.body.length
? children(wrapped.body) : null;
return extensions !== null && acceptsExtensionProfile(extensions);
} catch {
return false;
}
}
/** Atomically publish a public certificate; these files carry no key material. */
function publishPem(path: string, pem: string): void {
const tmp = `${path}.${process.pid}.${randomUUID()}.tmp`;
try {
writeFileSync(tmp, pem, { flag: "wx", mode: 0o644 });
try { chmodSync(tmp, 0o644); } catch { /* best-effort on platforms without POSIX modes */ }
renameSync(tmp, path);
} finally {
rmSync(tmp, { force: true });
}
}
/**
* Publish this process's authority and record which pid owns it, so another process that shares
* the config directory can distinguish "the file went missing or stale" from "a live peer rotated
* the authority" — only the former may be overwritten.
*/
function publishAuthority(configDir: string, ca: PickerCa): void {
publishPem(pickerCaCertPath(configDir), ca.certPem);
publishOwner(configDir, ca);
}
function publishOwner(configDir: string, ca: PickerCa): void {
publishPem(pickerCaOwnerPath(configDir), JSON.stringify({
pid: process.pid,
startTime: processStartIdentity(process.pid),
sha256: ca.fingerprint,
}) + "\n");
}
function currentProcessOwnsPublishedCa(configDir: string, ca: PickerCa): boolean {
try {
const owner = JSON.parse(readFileSync(pickerCaOwnerPath(configDir), "utf8")) as Record<string, unknown>;
return owner.pid === process.pid && owner.sha256 === ca.fingerprint
&& owner.startTime === processStartIdentity(process.pid);
} catch { return false; }
}
/** The OS process start identity prevents a recycled PID from impersonating the recorded owner. */
function processStartIdentity(pid: number, utc = false): string | null {
if (process.platform === "linux") {
try {
const stat = readFileSync(`/proc/${pid}/stat`, "utf8");
const afterCommand = stat.lastIndexOf(") ");
const ticks = afterCommand < 0 ? undefined : stat.slice(afterCommand + 2).trim().split(/\s+/)[19];
return ticks && /^\d+$/.test(ticks) ? ticks : null;
} catch { return null; }
}
if (process.platform === "darwin") {
try {
const result = Bun.spawnSync(["/bin/ps", "-o", "lstart=", "-p", String(pid)], {
stdin: "ignore", stdout: "pipe", stderr: "ignore",
...(utc ? { env: { ...process.env, TZ: "UTC" } } : {}),
});
const value = result.stdout.toString().trim();
return result.exitCode === 0 && value.length > 0 && value.length <= 128 ? value : null;
} catch { return null; }
}
return null;
}
/** Darwin's lstart is local wall-clock time; Linux's /proc start ticks are not comparable to mtime. */
function processStartEpochMs(pid: number): number | null {
if (process.platform !== "darwin") return null;
const identity = processStartIdentity(pid, true);
if (identity === null) return null;
const epoch = Date.parse(`${identity} UTC`);
return Number.isFinite(epoch) ? epoch : null;
}
function processAlive(pid: number): boolean {
if (!Number.isInteger(pid) || pid <= 0) return false;
if (pid === process.pid) return true;
try {
process.kill(pid, 0);
return true;
} catch (error) {
// EPERM means the process exists but is not signallable by us; ESRCH means it is gone.
return error !== null && typeof error === "object" && (error as { code?: unknown }).code === "EPERM";
}
}
/**
* True when the published certificate belongs to a live process's authority. The owner
* record is only trusted while it describes the certificate actually on disk: a stale or
* third-party `ca-owner.json` cannot shield a file that was tampered with after the owner wrote it.
*/
function livePublishedOwner(configDir: string, published: string): boolean {
try {
const owner = JSON.parse(readFileSync(pickerCaOwnerPath(configDir), "utf8")) as unknown;
if (owner === null || typeof owner !== "object") return false;
const { pid, sha256, startTime } = owner as { pid?: unknown; sha256?: unknown; startTime?: unknown };
if (typeof pid !== "number" || typeof sha256 !== "string") return false;
if (sha256 !== pickerCaFingerprints(published).sha256) return false;
if (!processAlive(pid)) return false;
// Older records have no start identity. On Darwin, wall-clock start after the owner
// file proves PID reuse; otherwise preserve the conservative live-owner decision.
if (startTime === undefined || startTime === null) {
const startedAt = processStartEpochMs(pid);
if (startedAt === null) return true;
let mtime: number;
try { mtime = statSync(pickerCaOwnerPath(configDir)).mtimeMs; }
catch { return true; }
return !Number.isFinite(mtime) || startedAt <= mtime + LEGACY_OWNER_MTIME_TOLERANCE_MS;
}
if (typeof startTime !== "string" || startTime.length === 0 || startTime.length > 128) return false;
const actual = processStartIdentity(pid);
return actual === null || actual === startTime;
} catch {
return false;
}
}
function publicCertificate(pem: string): PendingPickerCaUntrust | null {
try {
const certPem = new X509Certificate(pem).toString();
return { certPem, ...pickerCaFingerprints(certPem) };
} catch {
return null;
}
}
function trustStateStat(path: string): BigIntStats | null {
try { return lstatSync(path, { bigint: true }); }
catch (error) {
if ((error as NodeJS.ErrnoException).code === "ENOENT") return null;
throw error;
}
}
function readPublicTrustStateBytes(path: string, checkLinuxOwner: boolean): Buffer | null {
const uid = checkLinuxOwner ? process.getuid?.() : undefined;
const directory = dirname(path);
const ownerControlled = (stat: BigIntStats) => uid === undefined || (stat.uid === BigInt(uid) && (stat.mode & 0o022n) === 0n);
const safeFile = (stat: BigIntStats) => stat.isFile() && stat.nlink === 1n
&& stat.size <= BigInt(MAX_PENDING_CA_BYTES) && ownerControlled(stat);
const sameEntry = (a: BigIntStats, b: BigIntStats) => a.ino !== 0n && sameFileIdentity(a, b) && a.ctimeNs === b.ctimeNs;
const unsafe = () => new Error("picker_ca_pending_untrust_unsafe");
// NSS bindings carry cleanup authority. Validate their containing directory even
// when the journal is absent, then verify the path and open descriptor agree.
const parent = uid === undefined ? null : trustStateStat(directory);
if (uid !== undefined && !parent) return null;
if (parent && (!parent.isDirectory() || !ownerControlled(parent))) throw unsafe();
const entry = trustStateStat(path);
if (!entry) return null;
if (!safeFile(entry)) throw unsafe();
let fd: number;
try {
fd = openSync(path, constants.O_RDONLY | (constants.O_NOFOLLOW ?? 0) | (constants.O_NONBLOCK ?? 0));
} catch {
throw unsafe();
}
try {
const opened = fstatSync(fd, { bigint: true });
if (!sameEntry(entry, opened) || !safeFile(opened)) throw unsafe();
const bytes = Buffer.alloc(MAX_PENDING_CA_BYTES + 1);
let used = 0;
while (used < bytes.length) {
const count = readSync(fd, bytes, used, bytes.length - used, null);
if (count === 0) break;
used += count;
}
const after = trustStateStat(path);
if (used > MAX_PENDING_CA_BYTES || !after || !sameEntry(opened, after) || !safeFile(after)) throw unsafe();
if (parent) {
const current = trustStateStat(directory);
if (!current?.isDirectory() || !sameEntry(parent, current) || !ownerControlled(current)) throw unsafe();
}
return bytes.subarray(0, used);
} finally {
closeSync(fd);
}
}
function readPublicTrustState(path: string, checkLinuxOwner: boolean): object | null {
const bytes = readPublicTrustStateBytes(path, checkLinuxOwner);
if (bytes === null) return null;
let value: unknown;
try { value = JSON.parse(bytes.toString("utf8")); }
catch { throw new Error("picker_ca_pending_untrust_invalid"); }
if (value === null || typeof value !== "object" || Array.isArray(value)) {
throw new Error("picker_ca_pending_untrust_invalid");
}
return value;
}
/** The pending record is public-only, but malformed or unsafe state must never be discarded. */
export function readPendingPickerCaUntrust(configDir: string, platform = process.platform): PendingPickerCaUntrust | null {
const value = readPublicTrustState(pickerCaPendingUntrustPath(configDir), platform === "linux");
if (value === null) return null;
const pending = value as Partial<PendingPickerCaUntrust>;
const keys = pending.linuxStore === undefined ? "certPem,sha1,sha256" : "certPem,linuxStore,sha1,sha256";
if (Object.keys(pending).sort().join(",") !== keys
|| (pending.linuxStore !== undefined && !isLinuxPickerTrustStore(pending.linuxStore))
|| typeof pending.certPem !== "string" || typeof pending.sha1 !== "string" || typeof pending.sha256 !== "string") {
throw new Error("picker_ca_pending_untrust_invalid");
}
const publicOnly = publicCertificate(pending.certPem);
if (!publicOnly || pending.certPem !== publicOnly.certPem
|| pending.sha1 !== publicOnly.sha1 || pending.sha256 !== publicOnly.sha256) {
throw new Error("picker_ca_pending_untrust_invalid");
}
return pending.linuxStore ? { ...publicOnly, linuxStore: pending.linuxStore } : publicOnly;
}
function writePrivateTrustState(path: string, value: object): void {
const temporary = `${path}.${process.pid}.${randomUUID()}.tmp`;
try {
writeFileSync(temporary, JSON.stringify(value) + "\n", { flag: "wx", mode: 0o600 });
try { chmodSync(temporary, 0o600); } catch { /* best-effort on platforms without POSIX modes */ }
renameSync(temporary, path);
} finally {
rmSync(temporary, { force: true });
}
}
function readLinuxTrustStore(configDir: string, sha256: string): LinuxPickerTrustStore | undefined {
const value = readPublicTrustState(linuxTrustStorePath(configDir), true);
if (value === null) return undefined;
const record = value as { sha256?: string; store?: LinuxPickerTrustStore };
if (Object.keys(record).sort().join(",") !== "sha256,store"
|| typeof record.sha256 !== "string" || !/^[0-9A-F]{64}$/.test(record.sha256)
|| !isLinuxPickerTrustStore(record.store)) throw new Error("picker_ca_linux_store_invalid");
return record.sha256 === sha256 ? record.store : undefined;
}
function writePendingPickerCaUntrust(configDir: string, pending: PendingPickerCaUntrust): void {
const linuxStore = readLinuxTrustStore(configDir, pending.sha256);
writePrivateTrustState(pickerCaPendingUntrustPath(configDir), { ...pending, linuxStore });
}
/**
* A lock failure is separate from a successful void callback. Once the callback entered, an
* exception (including lock release failure) propagates: its effects may be partial.
*/
function underPickerCaLock<T>(configDir: string, check: () => T):
| { kind: "acquired"; value: T }
| { kind: "unavailable"; error: unknown } {
let entered = false;
try {
const value = withClientLifecycleSync(() => {
entered = true;
return check();
}, { lockPath: pickerCaLockPath(configDir) });
return { kind: "acquired", value };
} catch (error) {
if (entered) throw error;
return { kind: "unavailable", error };
}
}
function lockedPickerCa<T>(configDir: string, check: () => T): T {
const result = underPickerCaLock(configDir, check);
if (result.kind === "unavailable") throw result.error;
return result.value;
}
function publishedPickerCa(configDir: string): string | null {
try { return readFileSync(pickerCaCertPath(configDir), "utf8"); }
catch (error) {
if (error !== null && typeof error === "object" && (error as { code?: unknown }).code === "ENOENT") return null;
throw error;
}
}
/** Serialize Linux trust changes with rotation. Record the exact store before certutil can mutate it. */
export async function withPublishedPickerCaLinuxTrust<T>(
configDir: string,
certPem: string,
work: (store: LinuxPickerTrustStore | undefined, save: (store: LinuxPickerTrustStore) => void, clear: () => void) => Promise<T>,
): Promise<T> {
configDir = canonicalPickerConfigDir(configDir);
const sha256 = pickerCaFingerprints(certPem).sha256;
const path = linuxTrustStorePath(configDir);
return withClientLifecycle(async () => {
if (publishedPickerCa(configDir) !== certPem) throw new Error("picker_ca_trust_state_changed");
const current = readLinuxTrustStore(configDir, sha256);
return work(current, store => {
if (readPendingPickerCaUntrust(configDir, "linux")) throw new Error("picker_ca_pending_untrust");
if (current && !sameLinuxPickerTrustStore(current, store)) throw new Error("picker_ca_linux_store_changed");
if (!current) writePrivateTrustState(path, { sha256, store });
}, () => {
if (current) rmSync(path);
});
}, { lockPath: pickerCaLockPath(configDir) });
}
function samePendingUntrust(current: PendingPickerCaUntrust | null, pending: PendingPickerCaUntrust): boolean {
return current?.certPem === pending.certPem && current.sha1 === pending.sha1
&& current.sha256 === pending.sha256 && sameLinuxPickerTrustStore(current.linuxStore, pending.linuxStore);
}
/** Record the verified NSS store before mutating it, conditional on the journal we read. */
export function bindPendingPickerCaLinuxStore(
configDir: string,
pending: PendingPickerCaUntrust,
store: LinuxPickerTrustStore,
): PendingPickerCaUntrust {
if (pending.linuxStore || !isLinuxPickerTrustStore(store)) throw new Error("picker_ca_linux_store_invalid");
const checkPending = () => {
if (!samePendingUntrust(readPendingPickerCaUntrust(configDir, "linux"), pending)) {
throw new Error("picker_ca_pending_untrust_changed");
}
};
// The lock setup hardens the state directory. Validate ownership and mode before it runs.
checkPending();
return lockedPickerCa(configDir, () => {
checkPending();
const bound = { ...pending, linuxStore: store };
writePrivateTrustState(pickerCaPendingUntrustPath(configDir), bound);
return bound;
});
}
/** A pending CA may still be serving when journal publication preceded a failed PEM replacement. */
export function pendingPickerCaHasLivePublishedOwner(
configDir: string,
pending: PendingPickerCaUntrust,
platform = process.platform,
): boolean {
return lockedPickerCa(configDir, () => {
if (!samePendingUntrust(readPendingPickerCaUntrust(configDir, platform), pending)) {
throw new Error("picker_ca_pending_untrust_changed");
}
const published = publishedPickerCa(configDir);
return published !== null && publicCertificate(published)?.sha256 === pending.sha256
&& livePublishedOwner(configDir, published);
});
}
/** Acknowledgement never clears an entry another process created or replaced. */
export function acknowledgePendingPickerCaUntrust(
configDir: string,
pending: PendingPickerCaUntrust,
confirmedUntrust: { ok: boolean },
platform = process.platform,
): boolean {
if (confirmedUntrust?.ok !== true) return false;
return lockedPickerCa(configDir, () => {
if (!samePendingUntrust(readPendingPickerCaUntrust(configDir, platform), pending)) return false;
rmSync(pickerCaPendingUntrustPath(configDir));
return true;
});
}
/**
* Drop the legacy exportable signing key, if one exists in the picker state dir. Releases before
* the process-scoped authority persisted `ca.key` next to `ca.pem`; the removal is deliberately
* unconditional so a later failed rotation can never leave that key behind.
*/
export function discardPickerCaKey(configDir: string): void {
try {
const stat = lstatSync(pickerStateDir(configDir));
if (!stat.isDirectory() || (process.platform !== "win32" && stat.uid !== process.getuid!())) {
throw new Error("picker_ca_directory_unsafe");
}
} catch (error) {
if (error !== null && typeof error === "object" && (error as { code?: unknown }).code === "ENOENT") return;
throw error;
}
rmSync(join(pickerStateDir(configDir), "ca.key"), { force: true });
}
export function ensurePickerCa(configDir: string, options: { rotation?: "startup"; persistent?: boolean; store?: PickerCaStore } = {}): PickerCa {
mkdirSync(configDir, { recursive: true, mode: 0o700 });
configDir = canonicalPickerConfigDir(configDir);
const dir = pickerStateDir(configDir);
// Persistent startup stores the signing key in the OS credential store; plain calls keep an
// in-process authority. Both paths remove legacy plaintext ca.key files, including cache hits.
discardPickerCaKey(configDir);
const cached = processAuthorities.get(dir);
const create = () => cached ?? (() => {
const ca = createCertificateAuthority({ commonName: PICKER_CA_COMMON_NAME, permittedDnsNames: [PICKER_HOST] });
return { ...ca, fingerprint: pickerCaFingerprints(ca.certPem).sha256 };
})();
mkdirSync(dir, { recursive: true, mode: 0o700 });
const pickerCa = lockedPickerCa(configDir, () => {
if (readPendingPickerCaUntrust(configDir)) throw new Error("picker_ca_pending_untrust");
if (options.persistent) {
return ensurePersistentPickerCa({
configDir, stateDir: dir, store: options.store, acceptsAuthority: acceptsPickerAuthority, create,
predecessor: ca => {
const published = publishedPickerCa(configDir);
if (published === ca.certPem || published === null) return null;
if (livePublishedOwner(configDir, published)) throw new Error("picker_ca_live_owner");
const outgoing = publicCertificate(published);
if (outgoing && options.rotation !== "startup") throw new Error("picker_ca_rotation_requires_startup");
return outgoing?.certPem ?? null;
},
publishMetadata: publishPem,
publish: (ca, predecessor) => {
if (predecessor) writePendingPickerCaUntrust(configDir, publicCertificate(predecessor)!);
publishAuthority(configDir, ca);
},
});
}
const pickerCa = create();
const published = publishedPickerCa(configDir);
if (published === pickerCa.certPem) {
// The signing key is still in this process. A missing/stale owner file must not let a
// second process rotate this live authority after an otherwise harmless cached ensure.
if (!currentProcessOwnsPublishedCa(configDir, pickerCa)) publishOwner(configDir, pickerCa);
return pickerCa;
}
if (published !== null && livePublishedOwner(configDir, published)) {
throw new Error("picker_ca_live_owner");
}
const outgoing = published === null ? null : publicCertificate(published);
if (outgoing && outgoing.sha256 !== pickerCa.fingerprint) {
if (options.rotation !== "startup") throw new Error("picker_ca_rotation_requires_startup");
writePendingPickerCaUntrust(configDir, outgoing);
}
publishAuthority(configDir, pickerCa);
return pickerCa;
});
if (!cached || options.persistent) processAuthorities.set(dir, pickerCa);
return pickerCa;
}
/** Fingerprint of this process's authority only — null until ensurePickerCa has run. */
export function publishedPickerCaSha256(configDir: string): string | null {
let canonical: string;
try { canonical = canonicalPickerConfigDir(configDir); } catch { return null; }
const cached = processAuthorities.get(pickerStateDir(canonical));
return cached ? pickerCaFingerprints(cached.certPem).sha256 : null;
}
/** Persist only the public leaf, so trust inspection verifies this exact local issuer. */
export function issuePickerLeaf(ca: PickerCa, configDir: string): PemKeyPair {
const leaf = issueServerLeaf(ca, PICKER_CA_COMMON_NAME, [PICKER_HOST]);
mkdirSync(pickerStateDir(configDir), { recursive: true, mode: 0o700 });
publishPem(pickerLeafCertPath(configDir), leaf.certPem);
return leaf;
}