diff options
Diffstat (limited to 'docs/access.md')
| -rw-r--r-- | docs/access.md | 12 |
1 files changed, 9 insertions, 3 deletions
diff --git a/docs/access.md b/docs/access.md index c03f7c4..2f7fa5a 100644 --- a/docs/access.md +++ b/docs/access.md @@ -426,9 +426,15 @@ Signed then are what decides who may do what (every user's entry, every entry of `_continuum/access`, every ban), and the paths listed at `_continuum/access/userSigned`, a list of paths as capabilities name them, `*` for any one key: `[["config"], ["servers", "*", "secret"]]`. Each such value is an envelope, one string -(`cv1.<payload>.<signature>`): the payload names the path, the value (`null`: deleted), -the user, when, and the envelope it replaces (`prev`), and the signature is the user's -over it, as `ssh-keygen -Y sign -n continuum-value` makes it, with one of its `keys`. +(`cv2.<value>.<meta>.<signature>`): the value as its user wrote it (`null`: deleted); +apart from it, the meta, which names the swarm, the path, the user, when, the envelope +it replaces (`prev`) and its number (`seq`, one more than that one's, 0 where it +replaces none); and the user's signature over both, as +`ssh-keygen -Y sign -n continuum-value` makes it, with one of its `keys`. Where a place +holds several envelopes, written at once, the one with the highest `seq` is its value +(of equal ones, the one with the lower SHA-256), before anything that isn't one: so an +older envelope put back beside a newer one, by a change made not to see it, changes +nothing, whatever the order of the changes' operations. `scripts/continuum-signed` is a reference client, with `ssh-keygen`, `curl` and `jq`: it logs in by key, writes and deletes signed values (`put config '{"mode": "fast"}'`), and checks one against its user's keys (`verify config`). |
