railiance-infra/docs
codex c84fe7a3de
All checks were successful
CI Smoke / host-smoke (push) Successful in 0s
CI Smoke / container-smoke (push) Successful in 1s
Make the k3s API firewall allowlist declarative
The live host restricted 6443/tcp to specific operator addresses, added by hand,
while this role still declared the port open to Anywhere with no source
restriction. The declared config was weaker than reality: running the base role
would have REMOVED the restriction and exposed the Kubernetes API to the
internet. Security was tightened on the host and never fed back into the source
of truth.

Found 2026-08-11 while diagnosing lost cluster access, which turned out to be an
ISP lease rotation (89.244.90.246 -> .236) against a hand-maintained allowlist.

Changes:
- defaults: k3s_api_allowed_sources (empty = 6443 closed to all external
  sources, the safe failure; SSH unaffected so the host stays recoverable) and
  k3s_api_revoked_sources, so rotated addresses are pruned rather than left as
  standing grants to whoever the ISP reassigns them to
- tasks: grant approved sources, then remove any blanket rule, then revoke
  retired ones. Order matters - grants are added before the blanket rule is
  deleted so convergence never opens a window with no API access
- group_vars/all.yaml: the current operator address, plus the two stale grants
  (.246 rotated, 85.132.220.102 historic) marked for revocation
- docs/verification.md: state that 6443 is source-restricted rather than
  listing it as a plainly allowed port

Not yet converged against the live host - the role change is committed but
running it is a production action needing operator approval.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-08-11 23:56:28 +02:00
..
adr ADR-004: Forgejo in-cluster Actions runner on railiance01 2026-07-03 22:29:28 +02:00
age-keys.md Define S1 reef rollout handoff 2026-07-25 15:13:41 +02:00
convergence.md Define S1 reef rollout handoff 2026-07-25 15:13:41 +02:00
deploy-stack.md WP-0005: T12 prep checklist, backup gate 4/7, doc refresh 2026-07-09 10:34:44 +02:00
forgejo-cutover-rollback.md WP-0005 T12: Option A — keep Gitea fallback, 30-day window 2026-07-09 11:32:25 +02:00
forgejo-gitea-retirement-checklist.md Add RAIL-HO-WP-0006 registry ref cleanup workplan (finished) 2026-07-09 11:59:08 +02:00
forgejo-migration-inventory.md WP-0005: T12 prep checklist, backup gate 4/7, doc refresh 2026-07-09 10:34:44 +02:00
forgejo-restore-drill-evidence.md WP-0005: T12 prep checklist, backup gate 4/7, doc refresh 2026-07-09 10:34:44 +02:00
provisioning.md Define S1 reef rollout handoff 2026-07-25 15:13:41 +02:00
reef-first-wave-source-map.md Rename first home reef target to reef-railiance 2026-07-26 09:00:32 +02:00
ssh-access.md Define S1 reef rollout handoff 2026-07-25 15:13:41 +02:00
verification.md Make the k3s API firewall allowlist declarative 2026-08-11 23:56:28 +02:00