mirror of https://github.com/vector-im/element-web.git synced 2024-08-10 00:03:58 +00:00

J. Ryan Stinnett fa265e498f Document new setting to require secure backup

This adds notes on configuring the new `.well-known` setting to require Element
users to set up secure backup before continuing into the app.

Part of https://github.com/vector-im/element-web/issues/14954

2020-08-19 16:22:56 +01:00

1.1 KiB

Raw Blame History

End to end encryption by default

By default, Element will create encrypted DM rooms if the user you are chatting with has keys uploaded on their account. For private room creation, Element will default to encryption on but give you the choice to opt-out.

Disabling encryption by default

Set the following on your homeserver's /.well-known/matrix/client config:

{
  "im.vector.e2ee": {
    "default": false
  }
}

Secure backup

By default, Element strongly encourages (but does not require) users to set up Secure Backup so that cross-signing identity key and message keys can be recovered in case of a disaster where you lose access to all active devices.

Requiring secure backup

To require Secure Backup to be configured before Element can be used, set the following on your homeserver's /.well-known/matrix/client config:

{
  "im.vector.e2ee": {
    "secureBackupRequired": true
  }
}

Compatibility

The settings above were first proposed under a im.vector.riot.e2ee key, which is now deprecated. Element will check for either key, preferring im.vector.e2ee if both exist.

1.1 KiB Raw Blame History