Account AccessLog In & Unlock

Understand Log In vs. Unlock

In order to understand why unlocking and logging in are not the same, it's important to remember that Bitwarden

on its servers. When your vault is neither unlocked nor logged in, your vault data only exists on the server in its
encrypted form
.

Logging in

Logging in to Bitwarden retrieves the encrypted vault data and decrypts the vault data locally on your device. In practice, that means two things:

  1. Logging in will always require you to use your master password or

    to gain access to the
    account encryption key
    that will be needed to decrypt vault data.

    This stage is also where
    any enabled two-step login methods
    will be required.

  2. Logging in will always require you to be connected to the internet (or, if you are self-hosting, connected to the server) to download the encrypted vault to disk, which will subsequently be decrypted in your device's memory.

Unlocking

Unlocking can only be done when you are already logged in. This means, according to the above section, your device has encrypted vault data stored on disk. In practice, this means two things:

  1. You don't specifically need your master password. While your master password can be used to unlock your vault, so can other methods like

    codes and
    biometrics
    .

    note

    When you setup a PIN or biometrics, a new encryption key derived from the PIN or biometric factor is used to encrypt the

    , which you will have access to by virtue of being logged in, and stored on diskª.

    Unlocking your vault causes the PIN or biometric key to decrypt the account encryption key in memory. The decrypted account encryption key is then used to decrypt all vault data in memory.

    Locking your vault causes all decrypted vault data, including the decrypted account encryption key, to be deleted.

    ª - If you use the Require master password on browser restart option, this key is only stored in memory rather than on disk.

  2. You don't need to be connected to the internet (or, if you are self-hosting, connected to the server).