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_helpis the organisation's word on where a key comes from, a URL or a sentence, carried inme.client_defaultsaskey_help, beside the document rather than in it: a document holds only what a config file takes.client_keyis a secret, empty unless an administrator chooses it, and then goes in the document'sdefaultsasapi_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 (setsays 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_helpin its copy of the document (organisation.json) and writes that copy readable by the owner alone, since it may now hold a key.config.getcarrieskey_help, andapi_key_sourcesaysorganisationwhere 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