service-setup: per-client accessTokenLifespan passthrough

acs-service-setup/lib/openid.js

@@ -294,6 +294,16 @@ class OpenIDSetup {
                 ...(spec.deviceAuthorizationFlowEnabled
                     ? { "oauth2.device.authorization.grant.enabled": "true" }
                     : {}),
+                // Per-client access-token lifespan override, in seconds.
+                // Keycloak's realm default (300s) is right for API tokens
+                // but wrong for an unattended display credential: a kiosk
+                // JWT (e.g. Grafana url_login) is re-presented on every
+                // request and the wall dies at exp, so a kiosk client
+                // wants a long lifespan (days) and a refresh-before-expiry
+                // on the consumer side. Omit for the realm default.
+                ...(spec.accessTokenLifespan
+                    ? { "access.token.lifespan": String(spec.accessTokenLifespan) }
+                    : {}),
             },
         };
         if (secret !== undefined) desired.secret = secret;

deploy/values.yaml

@@ -232,6 +232,13 @@ serviceSetup:
     #     name: Polyptic kiosk
     #     serviceAccountsEnabled: true
     #     standardFlowEnabled: false
+    #
+    # `accessTokenLifespan` (seconds) overrides the realm's access-token
+    # lifespan (default 300s) for one client. A kiosk JWT is re-presented
+    # on every request by the consuming app (e.g. Grafana url_login), so
+    # an unattended display dies at token expiry: give such clients a
+    # long lifespan (e.g. 2592000 = 30 days) and let the consumer refresh
+    # before expiry. Leave unset everywhere a human signs in.
     openidClients:
       grafana:
         enabled: true