The GitHub App's OpenBao grant is optional on a plane that has no App and required once one is set up, so a plane whose App would stop signing is not reported healthy¶
Decision 946 · accepted · 2026-10-25 · issue #765 · supersedes 934
Why. Decision 934 made the plane check its OpenBao grants look-only from one list,
Troupe.KMS.Policy.plane_grants/1, and called the GitHub App's grant optional: a plane
without an App needs none of it, and missing it left the plane healthy. That holds only
before an App exists. Once one is set up, the grant is what signs the App's tokens and
checks its webhooks; without it "one set up before stops signing", as the grant's own text
says, and the console's Overview still showed the plane healthy, with the grant under
nothing that asked for attention. D134 and D135 recorded it: the grant was always
reported optional, an App configured or not.
The decision.
- Required once there is an App.
Troupe.Plane.KMSCheck.run/1marks thegithub-appgrant required whenTroupe.Plane.GitHub.configured?/0holds: the App has an id, a key in transit and at least one installation, which is whatadmin.github.getalready answers asconfigured. Before that it stays optional, and a missing one still says "(needed only for that)". - The check decides, not the list.
plane_grants/1is introupe_protocol, which knows nothing of a plane's App, andmix troupe.openbao.policywritesdocs/admin/openbao.mdfrom it; the page already says the grant is "only with a GitHub App". So the list keepsrequired: falseand the check, which runs on the plane, turns it on. The role line a plane that cannot log in is given lists the required policies, so it names the App's too once there is an App. - An App half set up is not one. An id without a key, or a key without an
installation, signs nothing yet; the grant is optional until all three are there, and
importing the key is what fails meanwhile, with the refusal
admin.github.putgives.
The rest of Decision 934 stands.
Proof. kms_check_test.exs: with a token that holds every required grant and not the
App's, the plane is healthy and the grant optional with no App row, and not healthy, the
grant required and its sentence without "(needed only for that)", once an App row with an
id, a key version and an installation exists. The second test failed on the chunk's tip
(ok: true, required: false) before the change.
Governs: apps/troupe_plane/lib/troupe/plane/kms_check.ex, apps/troupe_plane/lib/troupe/plane/github.ex