enricobuehler
bda5556d37
Remediates the two web-console residuals from the 2026-07-05 posture audit: - Brute-force throttle (loginThrottle.ts): per-IP exponential backoff after 5 free attempts, plus a global floor for spread-out floods, keyed on the socket peer IP (not spoofable X-Forwarded-For) with a size-capped map. The constant-time compare already stopped the timing leak; this bounds guess *volume* against a by-design LAN-exposed console. - Session seal key now derives from the high-entropy mgmt token instead of the low-entropy login password, so a captured cookie is no longer an offline password oracle. Falls back to the password only when no token is configured (dev/local). Rotating the token now invalidates sessions. - Replace the process-wide NODE_TLS_REJECT_UNAUTHORIZED=0 with per-request Bun TLS scoped to the loopback proxy hop; a non-loopback mgmt URL now verifies normally. Dropped the env var from the systemd unit, Steam Deck installer, Windows run scripts, env examples, and web README. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
32 lines
1.8 KiB
Bash
32 lines
1.8 KiB
Bash
# punktfunk web console — packaged config reference.
|
|
#
|
|
# On a `apt install punktfunk-web` install you DO NOT edit anything: the systemd --user units wire
|
|
# everything automatically —
|
|
# punktfunk-web.service sets PUNKTFUNK_MGMT_URL=https://127.0.0.1:47990,
|
|
# PORT=47992, HOST=0.0.0.0, the PUNKTFUNK_UI_TLS_* cert paths + PUNKTFUNK_UI_SECURE=1, and sources:
|
|
# ~/.config/punktfunk/mgmt-token (written by the host's `serve` — the shared bearer token)
|
|
# ~/.config/punktfunk/web-password (written by punktfunk-web-init — the console login password)
|
|
# ~/.config/punktfunk/{cert,key}.pem (the host identity — the console serves HTTPS with it)
|
|
#
|
|
# This file documents the variables for a MANUAL deploy (running `bun .output/server/index.mjs`
|
|
# yourself — the console runs on bun: `Bun.serve` is a Bun API, node can't run it). The mgmt API is
|
|
# HTTPS with the host's self-signed loopback cert; the proxy accepts it ONLY for that loopback hop,
|
|
# scoped in code (Bun per-request TLS) — so NODE_TLS_REJECT_UNAUTHORIZED is deliberately unset.
|
|
PUNKTFUNK_MGMT_URL=https://127.0.0.1:47990
|
|
PORT=47992
|
|
HOST=0.0.0.0
|
|
|
|
# Serve the console over HTTPS (HTTP/1.1 over TLS) with the host's own identity cert. BOTH paths
|
|
# set ⇒ HTTPS. (No HTTP/2 or HTTP/3: Bun.serve has no HTTP/2 server, and a browser won't speak
|
|
# HTTP/3/QUIC against this self-signed, no-SAN host cert — so HTTP/1.1 over TLS is what's offered.)
|
|
PUNKTFUNK_UI_TLS_CERT=%h/.config/punktfunk/cert.pem
|
|
PUNKTFUNK_UI_TLS_KEY=%h/.config/punktfunk/key.pem
|
|
# Mark the session cookie Secure (required once served over TLS):
|
|
PUNKTFUNK_UI_SECURE=1
|
|
|
|
# Match the host's ~/.config/punktfunk/mgmt-token (auto-generated by the host if unset):
|
|
PUNKTFUNK_MGMT_TOKEN=
|
|
|
|
# Console login password (fails closed if unset on the built server):
|
|
PUNKTFUNK_UI_PASSWORD=
|