This is an old revision of the document!
This is a section of the manual on how to use Element's end-to-end-encryption. To see the rest of the manual, find the page here
End-to-end encryption means that only the parties participating in a conversation are able to decrypt and read the messages that were send. Our server is not able to decrypt the messages that were sent, preventing third parties to read the messages.
When using encryption in a room (or direct chat) all messages in that chat will be encrypted. Everyone of your clients (e.g. the webclient at meet.physik.fu-berlin.de or Element on your phone) will have a session with its own keys. This is mostly transparent to you as a user, but you must always hold either of the following to be true:
If either of this is the case, you will keep access to your old encrypted messages, so generate a recovery passphrase and save it in your password safe.
When you log in to Element, it will ask you to set up encryption recovery. This step will make sure that you can share encrypted messages across all your devices and different sessions. If you do not wish to use encryption you can skip this step. However as encryption will be used by default we highly recommend setting up encryption.
To setup encryption recovery you have to choose a secure passphrase.
Optional By default the server backs up your encryption keys, so you can recover your encrypted messages if you loose access to all sessions that had access to them. You can choose for the keys not to be saved on the server. They can still be transmitted from one active session of yours to another.
Additionally you can download a recovery key, which you can use if you forget or loose the passphrase.
To access your encryption history and for other users to verify you it is necessary to verify a new session. To verify a session you can either confirm a new session from an existing session or enter your recovery passphrase.
When logging in with a new device you will get prompted to verify it.
If you are logged into another session there will be a popup asking you to verify the new session:
Click on the green "Verify" button in the popup and an explaining popup will appear.
Select to continue and you will be asked for a verification method. Currently the only option is to compare a sting of emojis.
Compare the emojis in the two sessions.
Confirm the emojis match on both devices to complete verifying the session.
Alternatively you can select to verify a session by using your recovery passphrase:
If you have old unverified sessions that you don't have access to anymore, it is best to delete them so that other users don't see you as unverified.
To find out if you have unverified sessions left, enter a chat in which you participate and find your name in the user sidebar on the left. If you have unverified sessions, there will be a red shield icon on your user icon.
If you have unverified sessions, click on your name in the sidebar. This will show you a list of your sessions and which of them are unverified.
Click on each of the unverified sessions which you can not access anymore and note down their session-ID. (In the picture below it is VBPCSWTETS)
To delete the session you noted down, click on your Name in the top left corner and select the settings.
In the settings menu select the section "Security & Privacy"
In the "Security & Privacy" setting select all the session you want to delete and click on "Delete sessions"
For end-to-end encryption to be really secure users have to verify they are talking to each other. To do this each user is verifying each their devices, and additionally verifies every user once. Every device another verified user verified themselves will be considered verified.
Example: Alice and Bob start a conversation in their logged in sessions. For the encryption to be secure they have to verify they are actually talking to each other. In Element this is done by comparing a list of emojis that are shown to both users. Alice requests a verification with Bob and they verify they get shown the same string of emojis. When Bob starts using a new session (e.g. using a different Browser/Device) he can use the session that was verified with Alice's session to also verify his new session. Alice's session automatically sees that Bob verified the new session and accepts it into the encrypted conversation.
For this step to make sense you have to be able to communicate with the other user in a way that makes sure you are actually talking to them. For this we recommend video/audio-chat, or just sitting next to each other.
To verify a user you open a chat you share with the user and click their name in the user side bar.
Click on the verify link in the sidebar…
and click on the "Start Verification" button.
The user you want to verify will see the request as a popup on the left and in the chat.
You will then be presented with the verification options. Currently the only option is comparing a string of emojis. When both users have agreed on a verification method the verification process begins.
If the user you are verifying with is shown the same string of emojis as you are, you can both click on "They match" to complete the verification.
Sometimes it happens. Your computer and phone die at the same time and those were the only clients you were logged in at and you didn't save your passwordmanager database (hopefully you are using one) where you store your recovery keys or recovery passphrase to any other device. What now?
Well, all your encrypted messages, i.e. messages in rooms or private discussions were encryption was enabled, are gone and you won't get them back, but you can make yourself new recovery keys for the future (and hopefully you will safe them redundantly). To this, just click Use Security Key or Phrase
on the verification dialog after login and instead of entering your security phrase or key, which you've lost, click the Reset all link on the bottom, next to *Forgotten or lost all recovery methods?*
You will then be asked to confirm
And clicking Reset will sign out of all your old sessions and delete all keys, followed by guiding you through the procedure to generate new ones described above.