Skip to content

Developer guide

Ground rules

  • Nothing reaches Entra before policy and approval pass. New mutations go after step 2 of the reconcile loop.
  • Every mutation is audited. Wrap it in Auditor::audited so it gets an attempted record before and a result record after. Add the action to audit records.
  • Secrets stay in SecretString. Never format one into a log, an error or an audit record.
  • New spec fields are admin-only by default. Make them Option with skip_serializing_if = "Option::is_none" so existing clients' admin hash does not change, and add them to the admission policy's compared fields.
  • The CRD is generated. Change src/crd.rs, then regenerate deploy/crd.yaml with make crd; CI fails if they differ.