Skip to main content

Account Recovery

The Account Recovery is a feature introduced with passbolt v3.6.0 that helps users to recover their accounts in case of a recovery kit or passphrase loss.

info

If you are looking for how to set up your account on another machine,
you can check this documentation.

To know more about how to configure account recovery, check out administrator documentation.

caution

This feature needs to be activated by your administrator first.

However, with passbolt 5.8, we are introducing the ability to create additional roles (Organisation settings -> Role-Based Access Control). Upon being given a role with access to the account recovery requests management, non-admins will be able to view, index, and review account recovery requests.

Requirements

You can follow this procedure if you are meeting the following requirements:

  • You are in possession of a valid user account (you have completed the setup, and you are not suspended),
  • Your organisation is running Passbolt Pro v3.6.0 or higher, or Passbolt Cloud.

How does it work?

Depending on the organisation's policy, all users will be able to deposit an encrypted backup of their private keys in passbolt. Backups which can only be unlocked cryptographically by the organisation's administrators.

The possible organisation's policies:

  • Prompt: new users will be forced to accept when registering for the first time, while existing users will be prompted to accept or ignore after signing in to the application. When ignored, this prompt will be displayed after each connection, but its goal is mainly to inform the users about the private key transfer that is going to happen. It is especially useful if they prefer not to use their personal private key.
  • Opt-out: users have the choice to accept or reject the option, and the account recovery is enabled by default as per the organisation's preferences. Users will be able to set their preferences when registering for the first time while existing users will be prompted to accept or reject after signing in to the application.
  • Opt-in: users have the choice to accept or reject the option, but the account recovery is disabled by default as per the organisation's preferences. Users will be able to set their preferences when registering for the first time while existing users will be prompted to accept or reject after signing in to the application.
  • Disable: the option is disabled and nobody will be able to use it. This is the default policy before enabling account recovery.

As a new user, how to allow this option during the setup process?

If the account recovery is enabled for the organisation (by an admin), all new users will be prompted to accept the account recovery option during the setup process.
Depending on the organisation's policy, the prompt presents different options as shown above.

Account recovery acceptance for browser extension setup process (Opt-out policy)
fig. Account recovery acceptance for browser extension setup process (Opt-out policy)

As a registered user, how to allow this option?

If the account recovery is enabled for the organisation, all users can access their account recovery preferences from the account recovery section of the user settings workspace.

Account recovery enrollment prompt for registered users
fig. Account recovery enrollment prompt for registered users

If the organisation's account recovery policy is set to prompt or opt-out, users will be prompted to accept immediately after signing in into passbolt. If they postpone the decision, they could follow the attention crumbs (❗) displayed in the interface to go to the account recovery section in the settings later.

Account recovery section in user's settings
fig. Account recovery section in user's settings

Users will then be able to accept the option by clicking the review button. Similarly to the setup process, the settings screen presents different options depending on the organisation's policy (e.g. The possible organisation's policies).

Account recovery acceptance dialog
fig. Account recovery acceptance dialog

Users will notice additional information relative to the administrator who enabled the account recovery option.

danger

For safety reasons, it is highly recommended to verify carefully these information:

  • Is the administrator known?
  • Is the fingerprint matching the administrator's public key?