Password And Recovery Key

Each Cryptomator vault is secured by a password. The security of your vault depends directly on the strength of its password, so we choosing a strong password is key.

Additionally for each vault exists a unique recovery key. This key ensures that if you forget your password, you are able to create a new one. For more information about the difference of the password and the recovery key, see TODO.

This section explains how to change a password for a vault, show its recovery key and reset the password to a new one. All actions are done in the Password tab of the vault options. You can access it over the main window by selecting the vault in question, lock it if necessary and then open its Vault Options.

Vault options allowing you to enter a recovery key

Change Password

You can change the password of an already existing vault. The only thing you need is to remember the current one.

To do so, click on the Change Password button in the Password tab of the vault options. In the opened window, you see three text input fields:

Todo

TODO add image to for change password dialog)

  1. In the first you need to enter the current password of the vault.
  2. The second one takes the new password in and as already said, we suggest to follow the creation rules for good passwords.
  3. In the third for confirmation you need to enter the new password again.

In order to proceed, you need to confirm what you are doing by selecting the checkbox.

To finish the workflow and really change the password, click now on the Change button.

Note

Only if the second and third text input fields match and the checkbox is selected, the Change button is activated.

Note

The password is used to derive a KEK, which is then used to encrypt further keys. The KEK changes, but the keys encrypted with the KEK will stay the same. The actual files will not get re-encrypted, meaning you can not upgrade a weak passphrase to a stronger one once the data has been synced to a service that allows recovery of older versions of the masterkey file.

If you like to encrypt your vault files with a new, stronger password, you need to create a new vault and drag the data from the old to the new one. Make sure to wipe all backups of the old vault afterwards.

Show Recovery Key

Regardless of wether you chose to show the recovery key during vault creation or not, it always exists. Hence, you can view it at a later point in time.

Warning

Bear in mind that due to the ability of the recovery key to reset the current password, it is highly confidential. Ensure that only trusted persons have access to it and keep it a safe spot.

To do so, click on the Display Recovery Key in the Password tab of the Vault Options. The open window shows inside a text field a sequence of words, the recovery key of the vault.

Todo

add image show recovery key dialog

You can copy it to your clipboard or print it to paper. If you are finished, close the window with the Done button.

Reset Password

If you forgot the password for a vault, saved the recovery key somewhere external, you are able to define a new password and have access to the vault again.

Again, navigate to the Password tab in the vault options and click the Recover Password button. A new prompt is opened, asking to insert your recovery key into the shown text box. Enter it there by copying it from a file or typing.

Note

If you printed your recovery key on paper or stored it somewhere where you cannot copy it, Cryptomator offers you an auto completion feature for insertion. Type a letter and see if the shown word matches your key part. If so, you can press tab or right arrow key to auto complete the word. Otherwise enter more letters, the suggestion will change accordingly.

Autocompletion during recovery key entry

If the recovery key is valid, Cryptomator indicates this by a small message and activates the Next button

A valid recovery key has been entered

In the last step you need to assign a new password to your vault. It is the same as during vault creation except that no new recovery key is generated. As already noted there, read the suggestion for choosing a good password.

Warning

Even thou you have a new password for the vault afterwards, the recovery key stays the same. So keep it!

Finish the dialog by entering the same password again and clicking the Done button. You can unlock your vault now with the new password.