Skip to content

Concepts

How Charter works, from the outside in:

Vocabulary

Client
One IAMClient resource, and everything Charter creates for it.
Admin-only field
Any spec field except redirectURIs. Changing one needs a platform admin and a new change reference.
Owner-editable field
spec.redirectURIs. The owning team changes it itself.
uniqueName
The Entra alternate key Charter gives each registration, <prefix><namespace>-<name>. Every Graph call addresses the app by it, so a lost status or a crash never creates a duplicate.
Delivered key
The Entra password whose secret is currently in the client's Kubernetes Secret. Its key ID is the Secret's iam.rbc.example/key-id annotation.
Grace window
How long the previously delivered secret stays valid after a rotation (ROTATION_GRACE_HOURS), so consumers can pick up the new one.