aboutsummaryrefslogtreecommitdiffstats
path: root/docs/access.md
diff options
context:
space:
mode:
Diffstat (limited to 'docs/access.md')
-rw-r--r--docs/access.md12
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`).