Skip to content

Charter

A charter is a grant of rights from an authority: platform admins grant an identity client, and the owning team operates within it.

Charter (charter-iam) is a Kubernetes controller that turns one IAMClient custom resource into everything an application needs to sign users in with Microsoft Entra ID:

  • an Entra app registration and its service principal,
  • a client secret that is rotated automatically and revoked when no longer needed,
  • a Kubernetes Secret with the credentials, the issuer URL and, optionally, a ready-made Dex configuration,
  • optionally, a copy of those credentials in OpenBao, through an External Secrets Operator PushSecret.

It is built audit- and compliance-first for a regulated environment: nothing changes in Entra without a policy check and a verified approval, every change is recorded before and after it happens, and changes made by hand in the Entra portal are detected and reverted.

apiVersion: iam.rbc.example/v1alpha1
kind: IAMClient
metadata:
  name: payments-portal
  namespace: team-payments
  annotations:
    iam.rbc.example/requested-by: alice@example.com
    iam.rbc.example/approved-by: bob@example.com
    iam.rbc.example/change-ref: CHG0012345
spec:
  displayName: Payments Portal
  redirectURIs: [https://payments.apps.example.com/callback]
  owners: [11111111-1111-1111-1111-111111111111]
  secretRotation: 90d
  pushSecret: {}          # optional: also copy the credentials to OpenBao
flowchart LR A[Platform admin<br/>via Flux ResourceSet] -->|creates| C[IAMClient] O[Owning team] -->|edits redirectURIs| C C --> R[charter-iam controller] R -->|policy + approval gate| R R -->|Microsoft Graph| E[(Entra ID<br/>app + SP + secret)] R --> S[Secret &lt;name&gt;-entra] R -.->|optional| P[PushSecret] -.-> B[(OpenBao)] R --> L[[Audit log + Events]]

Where to start

Status

Charter is pre-production. It has been run end to end against a non-production Entra tenant (create, drift correction, approval gate, rotation, OpenBao delivery, deletion). The open items before production are listed in Compliance: open items.