aboutsummaryrefslogtreecommitdiffstats
path: root/docs/example.toml
diff options
context:
space:
mode:
authortv <tv@krebsco.de>2026-11-15 16:43:53 +0000
committertv <tv@krebsco.de>2026-11-15 16:43:53 +0000
commitaf120b87c42ca56f69bbe6f8d27c023919742430 (patch)
tree60b493edf48aad388ddc9682498f1ad8c5527b53 /docs/example.toml
parent2d1c64a6e7134f4d6942d4539b27d45f14e7538c (diff)
swarm: a new swarm's policy recorded in its genesis change
A swarm strict from its start had its policy written by its first user in a later change. A change is judged by the policy at its history, so any member could always add a change whose history is from before the policy: judged by none, needing no signature, taken whenever it comes. Since signed values are read by `seq`, an envelope planted there with the highest `seq` there is can never be followed: a ban, a user, a declaration, for good. `--bootstrap-policy JSON`, with `--genesis`, records the policy in the genesis change, with the first users: then no change of the swarm is from before it. It must be a policy this node knows, and a strict one needs `--bootstrap-keys`, or nobody could sign what decides who may do what.
Diffstat (limited to 'docs/example.toml')
-rw-r--r--docs/example.toml6
1 files changed, 6 insertions, 0 deletions
diff --git a/docs/example.toml b/docs/example.toml
index 77b9c09..3e189fe 100644
--- a/docs/example.toml
+++ b/docs/example.toml
@@ -150,6 +150,12 @@ htpasswd = "/etc/continuum/htpasswd"
# values (docs/access.md), so a swarm can be strict from its start.
# bootstrap-keys = ["alice=ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAA… laptop"]
+# With genesis: the swarm's write protection policy (docs/access.md), recorded in its
+# first change with its first users, so that no change of the swarm is from before it:
+# {"version": 1, "values": "signed"} makes it strict from its start, and needs
+# bootstrap-keys.
+# bootstrap-policy = '{"version": 1, "values": "signed"}'
+
# How log lines look: text (timestamped), journal (for systemd's journal: no timestamp or
# colours, the level as each line's priority, for journalctl -p), or auto: journal when
# stdout goes to the journal, else text.