Filip/matrix-spec
1
0
Fork 0
mirror of https://github.com/matrix-org/matrix-spec synced 2026-02-27 00:13:43 +01:00
Code Issues Actions 1 Packages Projects Releases Wiki Activity

various fixes

Browse source 
- fix typo
- make property name plural since it may contain multiple items
- mention that users will appear in sync when they upload keys
This commit is contained in:
Hubert Chathi 2019-01-30 11:26:21 -05:00
parent f4fe318a85
commit ca0baa54df
1 changed files with 14 additions and 8 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

22
proposals/1756-cross-signing.md
View file

@ -8,7 +8,7 @@ this user must then verify each key on each of their devices. If Alice has *n*
devices, and Bob has *m* devices, then for Alice to be able to communicate with devices, and Bob has *m* devices, then for Alice to be able to communicate with
Bob on any of their devices, this involves *n×m* key verifications. Bob on any of their devices, this involves *n×m* key verifications.
One way to address this is for each user to use a device signing key to signs One way to address this is for each user to use a device signing key to sign
all of their devices. Thus another user who wishes to verify their identity all of their devices. Thus another user who wishes to verify their identity
only needs to verify the device signing key and can use the signatures created only needs to verify the device signing key and can use the signatures created
by the device signing key to verify their devices. by the device signing key to verify their devices.
@ -141,7 +141,7 @@ response:
// ... // ...
} }
}, },
"self_signing_key": { "self_signing_keys": {
"@alice:example.com": { "@alice:example.com": {
"user_id": "@alice:example.com", "user_id": "@alice:example.com",
"usage": ["self_signing"], "usage": ["self_signing"],
@ -153,6 +153,10 @@ response:
} }
``` ```
After uploading self-signing and user-signing keys, the user will show up in
the `changed` property of the `device_lists` field of the sync result of any
others users who share an encrypted room with that user.
Signatures of keys can be uploaded using `/keys/signatures/upload`. Signatures of keys can be uploaded using `/keys/signatures/upload`.
For example, Alice signs one of her devices (HIJKLMN), and Bob's self-signing key. For example, Alice signs one of her devices (HIJKLMN), and Bob's self-signing key.
@ -242,11 +246,13 @@ response:
} }
} }
}, },
"self_signing_key": { "self_signing_keys": {
"user_id": "@alice:example.com", "@alice:example.com": {
"usage": ["self_signing"], "user_id": "@alice:example.com",
"keys": { "usage": ["self_signing"],
"ed25519:base64+self+signing+public+key": "base64+self+signing+public+key", "keys": {
"ed25519:base64+self+signing+public+key": "base64+self+signing+public+key",
}
} }
} }
} }
@ -266,7 +272,7 @@ Bob's key:
// ... // ...
} }
}, },
"self_signing_key": { "self_signing_keys": {
"@bob:example.com": { "@bob:example.com": {
"user_id": "@bob:example.com", "user_id": "@bob:example.com",
"keys": { "keys": {