Audiobuzz
8376f9a92e
Verifying the step signer against a real step-ca surfaced two real bugs the mock signer had hidden, plus made the bench CA actually initialise: - signer.go: move --not-after from `step ca token` (validity caps ~1h -> "token validity too long") to `step ca sign` (it is the CERT lifetime). Without this the step signer never issues a cert. - dot1x-bench compose: DOCKER_STEPCA_INIT_PASSWORD_FILE pointed at a file that does not exist at first init (it is an INPUT path), so `step ca init` failed and never wrote secrets/password. Use DOCKER_STEPCA_INIT_PASSWORD (the value) which the entrypoint writes to secrets/password, where bootstrap + broker read. - bootstrap.sh: self-heal the root-owned ./pki Docker auto-creates; detect the CA password at $STEPPATH/password or secrets/password (varies by image version); raise authority.claims.maxTLSCertDuration so 720h fleet certs are allowed (stock cap 24h, which also blocked bootstrap's own RADIUS cert); fix RADIUS cert paths to write via the /export mount (were host paths run inside the container, so they never resolved). - serving stack: add the enrol-broker service (temporary home; nginx already proxies /enrol/) defaulting to the zero-dependency lab path (mock signer + insecure loopback admin), with ENROL_* knobs to switch to step + mTLS. - verify-serving.sh: exercise request -> approve -> cert through the deployed nginx /enrol/ proxy. - TODO #11: record the step-signer verification + the two fixes. Step signer VERIFIED end-to-end against a real step-ca: issued cert chains to the fleet root, EKU clientAuth, hostnqn derived from serial.
87 lines
4.2 KiB
YAML
87 lines
4.2 KiB
YAML
# =============================================================================
|
|
# Secure-path bench: step-ca (fleet CA) + FreeRADIUS (EAP-TLS), on the SERVING
|
|
# host (the trusted side). The authenticator (hostapd-wired + MACsec) is NOT
|
|
# here — it runs on a node between each workstation and this host (see
|
|
# authenticator/). Host networking so FreeRADIUS sees RADIUS/1812 from the
|
|
# authenticator and step-ca is reachable for enrolment.
|
|
#
|
|
# cp .env.example .env # set CA_DNS / CA_PASSWORD / RADIUS_SECRET
|
|
# docker compose up -d step-ca && ./step-ca/bootstrap.sh && docker compose up -d freeradius
|
|
#
|
|
# Images are pulled from Docker Hub here; mirror them through your registry
|
|
# (like the serving stack does for nginx/alpine) if you don't have egress.
|
|
# =============================================================================
|
|
|
|
services:
|
|
# --- Fleet CA (signs TPM-generated CSRs; trust anchor for the image) --------
|
|
step-ca:
|
|
image: smallstep/step-ca:latest
|
|
network_mode: host
|
|
restart: unless-stopped
|
|
environment:
|
|
# Auto-init on first start (smallstep image convention). bootstrap.sh adds
|
|
# the enrolment provisioner + issues the RADIUS server cert afterwards.
|
|
DOCKER_STEPCA_INIT_NAME: "Fleet Bench CA"
|
|
DOCKER_STEPCA_INIT_DNS_NAMES: "${CA_DNS:-ca.fleet.lab},localhost"
|
|
DOCKER_STEPCA_INIT_ADDRESS: ":${CA_PORT:-8443}"
|
|
DOCKER_STEPCA_INIT_PROVISIONER_NAME: "enrol"
|
|
# Password to encrypt the CA keys + 'enrol' provisioner. Must be the VALUE
|
|
# (_PASSWORD), not _PASSWORD_FILE: the latter is an INPUT path the entrypoint
|
|
# reads FROM (for a mounted docker secret), which doesn't exist at first
|
|
# init → `step ca init` fails → no CA, no secrets/password (the "CA not
|
|
# initialised" error). With _PASSWORD the entrypoint WRITES it to
|
|
# /home/step/secrets/password, where bootstrap.sh + the enrol-broker read it.
|
|
DOCKER_STEPCA_INIT_PASSWORD: "${CA_PASSWORD:-changeme-bench}"
|
|
volumes:
|
|
- ./pki/stepca:/home/step # CA state (root/intermediate/keys/db) — gitignored
|
|
- ./pki:/export # bootstrap.sh drops root_ca.crt here for the image/radius
|
|
|
|
# --- RADIUS (EAP-TLS; validates client cert vs step-ca root, returns MSK) ---
|
|
freeradius:
|
|
image: freeradius/freeradius-server:latest
|
|
network_mode: host # RADIUS 1812/1813 from the authenticator
|
|
restart: unless-stopped
|
|
depends_on:
|
|
- step-ca
|
|
# -X = full debug to stdout; priceless for the first bring-up. Drop to plain
|
|
# `radiusd -f` once EAP-TLS is green.
|
|
command: ["radiusd", "-X"]
|
|
volumes:
|
|
- ./freeradius/clients.conf:/etc/raddb/clients.conf:ro
|
|
- ./freeradius/mods-available/eap:/etc/raddb/mods-available/eap:ro
|
|
# certs issued by bootstrap.sh: the RADIUS server cert/key + the CA root.
|
|
- ./pki/radius:/etc/raddb/certs/fleet:ro
|
|
|
|
# --- TPM enrolment broker (the ONE unauthenticated, pre-auth endpoint) -------
|
|
# docs/tpm-enrolment-design.md. Host networking so the SERVING stack's nginx
|
|
# reaches the public listener on 127.0.0.1:9090 (proxied as /enrol/) and step-ca
|
|
# is reachable for signing. The admin web UI (mTLS) listens on 127.0.0.1:9443 —
|
|
# bind it to the management network ONLY; never expose it to the boot LAN.
|
|
#
|
|
# First issue the admin mTLS PKI (dedicated admin CA, NOT the fleet root):
|
|
# ../enrol-broker/admin-pki.sh ./pki/broker <admin-name>
|
|
enrol-broker:
|
|
build: ../enrol-broker
|
|
network_mode: host
|
|
restart: unless-stopped
|
|
depends_on:
|
|
- step-ca
|
|
environment:
|
|
BROKER_PUBLIC_ADDR: "127.0.0.1:9090"
|
|
BROKER_ADMIN_ADDR: "127.0.0.1:9443"
|
|
BROKER_SIGNER: "step"
|
|
STEP_CA_URL: "https://${CA_DNS:-ca.fleet.lab}:${CA_PORT:-8443}"
|
|
STEP_CA_ROOT: "/pki/root_ca.crt"
|
|
STEP_PROVISIONER: "enrol"
|
|
STEP_PROVISIONER_PASSWORD_FILE: "/pki/stepca/secrets/password"
|
|
STEP_CERT_NOT_AFTER: "720h"
|
|
BROKER_PENDING_TTL: "10m"
|
|
BROKER_WORDS: "8"
|
|
HOSTNQN_BASE: "nqn.2026-06.org.example.fleet:host-"
|
|
# Admin mTLS — server cert/key + the DEDICATED admin client CA (see above).
|
|
BROKER_ADMIN_CERT: "/pki/broker/server.crt"
|
|
BROKER_ADMIN_KEY: "/pki/broker/server.key"
|
|
BROKER_ADMIN_CLIENT_CA: "/pki/broker/admin-ca.crt"
|
|
volumes:
|
|
- ./pki:/pki:ro
|