aboutsummaryrefslogtreecommitdiffstats
path: root/docs/openapi.yaml
diff options
context:
space:
mode:
authortv <tv@krebsco.de>2026-11-08 14:18:33 +0000
committertv <tv@krebsco.de>2026-11-08 15:32:31 +0100
commitd56b3b069782585a6edcc9c608236361c2644a51 (patch)
tree22839d0582b3b5a841465b23bfa13957fc6e84ea /docs/openapi.yaml
parentfac4b143587188d283578bc51e13ca44bcfc6382 (diff)
envelope: a signed value names its swarm
Review 3.1, part of finding 12: a signed value's payload bound path, user, time and prev, but not the swarm. A user with the same name and key in two swarms could have an envelope replayed from one into the other, wherever the path holds no envelope yet (prev ""). The payload now names the swarm (`swarm`), and a node takes an envelope only for its own. /auth/whoami says the swarm, and continuum-signed and the example in api.md sign it. Wire version 44: nodes before this refuse such envelopes, and those after refuse the old ones.
Diffstat (limited to 'docs/openapi.yaml')
-rw-r--r--docs/openapi.yaml4
1 files changed, 2 insertions, 2 deletions
diff --git a/docs/openapi.yaml b/docs/openapi.yaml
index f0d54a9..13d8a65 100644
--- a/docs/openapi.yaml
+++ b/docs/openapi.yaml
@@ -192,7 +192,7 @@ paths:
schema:
type: string
example: |
- {"path":["config"],"value":{"mode":"fast"},"user":"alice","at":1762400000000,"prev":""}
+ {"swarm":"6f9a…","path":["config"],"value":{"mode":"fast"},"user":"alice","at":1762400000000,"prev":""}
-----BEGIN SSH SIGNATURE-----
U1NIU0lH…
-----END SSH SIGNATURE-----
@@ -981,7 +981,7 @@ paths:
get:
tags: [Auth]
summary: Who you are here
- description: The user, how it proved it (`htpasswd`, `header`, `token`), its registry entry's capabilities, and its token's claims if it came with one.
+ description: The swarm, the user, how it proved it (`htpasswd`, `header`, `token`), its registry entry's capabilities, and its token's claims if it came with one.
responses:
'200':
description: Who.