diff options
Diffstat (limited to 'docs')
| -rw-r--r-- | docs/access.md | 8 | ||||
| -rw-r--r-- | docs/example.toml | 6 |
2 files changed, 11 insertions, 3 deletions
diff --git a/docs/access.md b/docs/access.md index 2f7fa5a..89e74d7 100644 --- a/docs/access.md +++ b/docs/access.md @@ -51,8 +51,10 @@ A swarm gets a registry from its start if its genesis node is given its first us everything (`[]` and `["_continuum"]`). Other users, of its `--htpasswd` or any node's, may do nothing until added (the genesis node warns of those of its `--htpasswd`). With `--bootstrap-keys alice=ssh-ed25519\ AAAA…\ laptop` it records their keys too, so they -log in by key and sign values from the start: a swarm whose first user then writes the -policy (Values signed by their users, below) is strict from its start. +log in by key and sign values from the start, and with +`--bootstrap-policy '{"version": 1, "values": "signed"}'` the policy (Values signed by +their users, below) in the same change: the swarm is strict from its start, and no +change of it is from before the policy. Without it, the swarm has no registry: its users are all alike (A swarm without a registry, below), until someone gives it one. `--protocol-writers` counts in both: without a registry, as who may write protocol data; with one, to set it right @@ -465,7 +467,7 @@ replaced: a registry whose entries hold the users' keys turns strict as it is. A means trusted as it is: whatever entries, policy and bans it holds then count, plain values and envelopes alike, checked or not, whoever wrote them before (under a policy that isn't strict, a member may write as any user). So a swarm is best strict from its -start (`--bootstrap-keys`, A new swarm, above); one already running turns strict +start (`--bootstrap-policy`, A new swarm, above); one already running turns strict through a remake (Turning a swarm strict, below), which keeps only what an operator looked over. Writing the strict policy into it directly trusts it as it is: look it over first (`continuum-signed verify` on each entry). A value there that isn't an envelope 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. |
