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:
- Restore guard, referenced Kanidm, namespace authorization (an
unauthorized CR gets a
ResourceNotWatchedevent and no finalizer). - 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.
- Ensure the UID-bound Kanidm account and its membership edge.
- Observe tokens, config Secrets, the Deployment template, ReplicaSets and pods; plan.
- Mint a candidate and verify it with
whoami, only if the plan says so. - Create the immutable config Secret, then apply the Deployment and the Service (a Service failure is reported after step 7, not before).
- Re-observe (if anything was written), revoke and garbage-collect.
- 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§
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