various fixes

- fix typo
- make property name plural since it may contain multiple items
- mention that users will appear in sync when they upload keys
pull/977/head
Hubert Chathi 6 years ago
parent f4fe318a85
commit ca0baa54df

@ -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,13 +246,15 @@ response:
} }
} }
}, },
"self_signing_key": { "self_signing_keys": {
"@alice:example.com": {
"user_id": "@alice:example.com", "user_id": "@alice:example.com",
"usage": ["self_signing"], "usage": ["self_signing"],
"keys": { "keys": {
"ed25519:base64+self+signing+public+key": "base64+self+signing+public+key", "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": {

Loading…
Cancel
Save