Spec: client access through inbuxa-relay (design note, #484) #489

Open
jcoffey-dev wants to merge 4 commits from spec/client-gateway into main
pull from: spec/client-gateway
Owner

Design note for #484 (client access through the relay). Spec only, nothing built, not approved.

Revised 11-21 after the t/340 discussion to cover two modes, chosen per port. Pass-through (the default, built first) never ends client TLS, so the relay sees no password, token or content. Terminating ends TLS at the relay and sends the server only requests it has parsed and rebuilt, so a parser exploit lands on the relay instead of the server. To keep that box worth trusting: no password sign-in through it, sessions bound to the relay's generation, its certificate key made on the relay, nothing kept on disk, a worker per connection, and a quarantine that the console or an outside monitor (Cairn OBS first) can trigger, followed by a clean rebuild.

Thirteen open questions at the end of the file, each with a recommended answer.

Design note for #484 (client access through the relay). Spec only, nothing built, not approved. Revised 11-21 after the t/340 discussion to cover two modes, chosen per port. Pass-through (the default, built first) never ends client TLS, so the relay sees no password, token or content. Terminating ends TLS at the relay and sends the server only requests it has parsed and rebuilt, so a parser exploit lands on the relay instead of the server. To keep that box worth trusting: no password sign-in through it, sessions bound to the relay's generation, its certificate key made on the relay, nothing kept on disk, a worker per connection, and a quarantine that the console or an outside monitor (Cairn OBS first) can trigger, followed by a clean rebuild. Thirteen open questions at the end of the file, each with a recommended answer.
jcoffey-dev added 1 commit 2026-11-19 18:50:07 +00:00
Spec: client access through inbuxa-relay (design note for #484)
ci / fork-checks (pull_request) Skipped
ci / build (pull_request) Skipped
github/ci (branch) GitHub Actions
ci / github (pull_request) Successful in 25s
d9205d4aba
Pass-through only: the relay reads the TLS name to route and filter and
never ends a client's TLS, so it never sees a password, token or message.
Covers ports, the stream pool, targets chosen by the downstream, PROXY v2
for the client's address, CAA accounturi against a relay-issued
certificate, DNS, limits and blocked addresses, footprint, tests, and seven
open questions with recommended answers. Not approved, not scheduled.
jcoffey-dev added 1 commit 2026-11-22 00:05:28 +00:00
Spec: client access through the relay in both modes, pass-through and terminating
ci / fork-checks (pull_request) Skipped
ci / build (pull_request) Skipped
github/ci (branch) GitHub Actions
ci / github (pull_request) Successful in 25s
a77ed7b459
Adds a terminating mode alongside pass-through, chosen per port: requests
are parsed and rebuilt at the relay so a parser exploit lands there, with
no password sign-in, sessions bound to a relay generation, the certificate
key made on the relay, nothing kept, a worker per connection, and a
quarantine that outside monitors can trigger. Open questions redone.
jcoffey-dev added 1 commit 2026-11-22 01:29:54 +00:00
Spec: the After 27.1 milestone is now called 27.7
ci / fork-checks (pull_request) Skipped
ci / build (pull_request) Skipped
github/ci (branch) GitHub Actions
ci / github (pull_request) Successful in 46s
c689a1fb57
jcoffey-dev added 1 commit 2026-11-22 01:44:43 +00:00
Spec: record answers to the client gateway questions (all as recommended)
ci / fork-checks (pull_request) Skipped
ci / build (pull_request) Skipped
github/ci (branch) GitHub Actions
ci / github (pull_request) Successful in 25s
5fbf21d5a9
All checks were successful
ci / fork-checks (pull_request) Skipped
ci / build (pull_request) Skipped
github/ci (branch) GitHub Actions
ci / github (pull_request) Successful in 25s
You are not authorized to merge this pull request.
This pull request can be merged automatically.
This branch is out-of-date with the base branch
View command line instructions

Checkout

From your project repository, check out a new branch and test the changes.
git fetch -u origin spec/client-gateway:spec/client-gateway
git checkout spec/client-gateway
Sign in to join this conversation.