Skip to main content

Module reconcile

Module reconcile 

Source
Expand description

World-derived reconciliation: inputs, identity, token plan, workload, status and finalizer. World-derived reconciliation of a KanidmRadiusServer.

Every pass reads Kanidm and Kubernetes and lets the pure token planner decide; CR status is written as a report and never read back for a decision. Order:

  1. Restore guard, referenced Kanidm, namespace authorization (an unauthorized CR gets a ResourceNotWatched event and no finalizer).
  2. Finalizer, then read-only input validation before any mutation: an invalid input leaves the running Deployment and token untouched. An unresolvable image blocks only a server with no Deployment yet; a running one keeps its current image so rotation goes on.
  3. Ensure the UID-bound Kanidm account and its membership edge.
  4. Observe tokens, config Secrets, the Deployment template, ReplicaSets and pods; plan.
  5. Mint a candidate and verify it with whoami, only if the plan says so.
  6. Create the immutable config Secret, then apply the Deployment and the Service (a Service failure is reported after step 7, not before).
  7. Re-observe (if anything was written), revoke and garbage-collect.
  8. Write status, on every path; transient errors then drive backoff.

Modules§

apply
Ownership-checked server-side apply, create-only Secret and delete. Ownership-checked Kubernetes writes for the RADIUS controller.
cleanup
Finalizer steps. Finalizer for a KanidmRadiusServer.
config
Validated config rendering for the upstream Kanidm RADIUS service. Validated configuration for the upstream Kanidm RADIUS container.
error
Typed errors of the executors and of a reconcile pass. Typed errors of the RADIUS executors and of one reconcile pass.
identity
Kanidm account naming, ownership-checked ensure and delete. Deterministic Kanidm identity for individual RADIUS custom resources, and the executors that ensure and delete it.
image
Image inference and the verified runtime identity of the RADIUS image. Conservative image selection for the independently deployed Kanidm RADIUS.
inputs
Fail-closed input validation and public-material digest. Fail-closed preflight for referenced RADIUS inputs.
kanidm_token
Kanidm token mint, verify and revoke executors. Kanidm token executors: list, mint, verify and revoke.
meta
One module for every label, annotation and Secret key the operator uses. Every label, annotation and Secret key the RADIUS operator reads or writes.
observe
Builds the planner input from Kanidm and Kubernetes lists. Observe the world the token planner decides on.
status
Conditions and status, applied with server-side apply. Status of a KanidmRadiusServer: a pure builder plus the SSA write.
tls
EAP TLS certificate and private key validation. EAP/RADIUS certificate preflight checks.
token
Pure token planner: which token to run, revoke and garbage-collect. Pure token planner for the RADIUS service account.
workload
Deployment, Service and content-addressed config Secret builders. Kubernetes workload builders for an independent Kanidm RADIUS endpoint.

Constants§

RADIUS_FINALIZER

Functions§

kanidm_uri
Kanidm URL the RADIUS runtime uses: the Kanidm origin, else its domain. The RADIUS spec has no field for it.
reconcile_radius