Skip to content

An organisation says, in its own words, where a person gets a key for local sessions, and may choose to hand one key to everybody who signs in; the clients show the word wherever a key is asked for, and troupe config key pastes one

Decision 960 · accepted · 2026-10-27 · supersedes 675

An organisation enforces a configuration for local sessions and gives people defaults (Decision 869), but the one thing the defaults could not bring was the key, and nothing told a person where to get one: Decision 675 ruled that the plane never hands out a key, since anybody signed in could read it, and left each person to find their own. IT Minds mints keys at its own gateway and wanted to point people there; another organisation would rather say "open a ticket at the helpdesk"; a third does not care about personal keys and would hand everybody the same one. Troupe is built for all three.

  • Two settings in the Organisation group. client_key_help is the organisation's word on where a key comes from, a URL or a sentence, carried in me.client_defaults as key_help, beside the document rather than in it: a document holds only what a config file takes. client_key is a secret, empty unless an administrator chooses it, and then goes in the document's defaults as api_key. That is the half of 675 this undoes, knowingly: the setting's own consequence says that whoever can sign in can read it, that it is one key with one bill, and that a key a person pasted themselves still wins, since the defaults sit below the user file. The settings list never shows the value (set says whether there is one), the console previews it as "set (new)", and the plane signs the answer as it signs the rest.
  • The daemon keeps key_help in its copy of the document (organisation.json) and writes that copy readable by the owner alone, since it may now hold a key. config.get carries key_help, and api_key_source says organisation where the key in force is the document's: the environment and the person's file still come first.

Governs: apps/troupe_plane/lib/troupe/plane/settings.ex, apps/troupe_core/lib/troupe/config/org.ex, apps/troupe_core/lib/troupe/config/model_settings.ex