2020-06-04 07:38:45 -04:00
|
|
|
# End to end encryption by default
|
2020-06-03 17:09:56 -04:00
|
|
|
|
2020-07-17 07:22:51 -04:00
|
|
|
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.
|
2020-06-03 17:09:56 -04:00
|
|
|
|
|
|
|
## Disabling encryption by default
|
|
|
|
|
|
|
|
Set the following on your homeserver's
|
|
|
|
`/.well-known/matrix/client` config:
|
2020-08-14 08:31:57 -04:00
|
|
|
|
2020-06-03 17:09:56 -04:00
|
|
|
```json
|
|
|
|
{
|
2020-08-24 11:34:58 -04:00
|
|
|
"io.element.e2ee": {
|
2020-06-03 17:09:56 -04:00
|
|
|
"default": false
|
|
|
|
}
|
|
|
|
}
|
|
|
|
```
|
2020-08-14 08:03:04 -04:00
|
|
|
|
2020-08-14 08:31:57 -04:00
|
|
|
# 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:
|
|
|
|
|
|
|
|
```json
|
|
|
|
{
|
2020-08-24 11:34:58 -04:00
|
|
|
"io.element.e2ee": {
|
|
|
|
"secure_backup_required": true
|
2020-08-14 08:31:57 -04:00
|
|
|
}
|
|
|
|
}
|
|
|
|
```
|
|
|
|
|
2020-08-14 08:03:04 -04:00
|
|
|
# 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
|
2020-08-24 11:34:58 -04:00
|
|
|
`io.element.e2ee` if both exist.
|