docs: add rationale for the two-proxy (inner/outer Caddy) split #1

Closed
opened 2026-09-30 02:49:34 +00:00 by time · 3 comments

network.md (TLS section) ends with "(TBD: rationale for the two-proxy split)." I left it unexplained rather than infer it. Please add a sentence or two on why the inner Caddy (citrine, step-ca relationship) and outer Caddy (bort, public entry) are separate, and I'll fold it in.

network.md (TLS section) ends with "(TBD: rationale for the two-proxy split)." I left it unexplained rather than infer it. Please add a sentence or two on why the inner Caddy (citrine, step-ca relationship) and outer Caddy (bort, public entry) are separate, and I'll fold it in.
Owner

so I don't want to have any unencrypted traffic that is sniffable on any VLAN; all http traffic should (ideally) have SSL enabled. As such, each host/lxc/vm typically instantiates its own caddy proxy which gets internal certs from step-ca, then the outer proxy (which only serves a subset of those sites) gets LE certs for a handful. The outer proxy terminates public TLS and re-encrypts with the private step-ca key for internal TLS.

so I don't want to have any unencrypted traffic that is sniffable on any VLAN; all http traffic should (ideally) have SSL enabled. As such, each host/lxc/vm typically instantiates its own caddy proxy which gets internal certs from step-ca, then the outer proxy (which only serves a subset of those sites) gets LE certs for a handful. The outer proxy terminates public TLS and re-encrypts with the private step-ca key for internal TLS.
Owner

This is true on basically every internal host, not just hydra or citrine. If it's not true, it should be flagged, but I think it's all covered. Some sites don't have step-ca-produced certs yet (i.e opnsense and a couple other sites), but they use self-signed certs for now until I get all of them on the same setup.

This is true on basically every internal host, not just hydra or citrine. If it's not true, it should be flagged, but I think it's all covered. Some sites don't have step-ca-produced certs yet (i.e opnsense and a couple other sites), but they use self-signed certs for now until I get all of them on the same setup.
Author

Done. TLS section rewritten: no-plaintext-on-any-VLAN goal, per-host Caddy with step-ca certs, outer Caddy terminating public TLS and re-encrypting with the step-ca key, self-signed cert exception noted. Diagram updated.

Done. TLS section rewritten: no-plaintext-on-any-VLAN goal, per-host Caddy with step-ca certs, outer Caddy terminating public TLS and re-encrypting with the step-ca key, self-signed cert exception noted. Diagram updated.
time closed this issue 2026-09-30 04:25:02 +00:00
Sign in to join this conversation.
No labels
No milestone
No project
No assignees
2 participants
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set

Reference
daru/cryogen-lab#1
No description provided.