Skip to content

Commit

Permalink
Merge pull request #3147 from uhoreg/cross_signing_backup_ssss
Browse files Browse the repository at this point in the history
Add information about using SSSS for cross-signing and key backup.
  • Loading branch information
uhoreg authored and richvdh committed Aug 27, 2021
2 parents 4b40ecc + 21fa486 commit 194fef8
Show file tree
Hide file tree
Showing 2 changed files with 13 additions and 0 deletions.
1 change: 1 addition & 0 deletions changelogs/client_server/newsfragments/3147.feature
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
Add information about using SSSS for cross-signing and key backup.
12 changes: 12 additions & 0 deletions content/client-server-api/modules/end_to_end_encryption.md
Original file line number Diff line number Diff line change
Expand Up @@ -944,6 +944,13 @@ example, if Alice and Bob verify each other using SAS, Alice's
`mac` property. Servers therefore must ensure that device IDs will not
collide with cross-signing public keys.

The cross-signing private keys can be stored on the server or shared with other
devices using the [Secrets](#secrets) module. When doing so, the master,
user-signing, and self-signing keys are identified using the names
`m.cross_signing.master`, `m.cross_signing.user_signing`, and
`m.cross_signing.self_signing`, respectively, and the keys are base64-encoded
before being encrypted.

###### Key and signature security

A user's master key could allow an attacker to impersonate that user to
Expand Down Expand Up @@ -1083,6 +1090,11 @@ as follows:
When reading in a recovery key, clients must disregard whitespace, and
perform the reverse of steps 1 through 3.

The recovery key can also be stored on the server or shared with other devices
using the [Secrets](#secrets) module. When doing so, it is identified using the
name `m.megolm_backup.v1`, and the key is base64-encoded before being
encrypted.

###### Backup algorithm: `m.megolm_backup.v1.curve25519-aes-sha2`

When a backup is created with the `algorithm` set to
Expand Down

0 comments on commit 194fef8

Please sign in to comment.