Skip to content
This repository has been archived by the owner on Jan 2, 2020. It is now read-only.

Account Recovery Feature

Anike Arni edited this page Apr 26, 2017 · 5 revisions

The Pixelated team started an implementation of account recovery based on various usability tests, target personas, and technical and security feasibility. Collaboration with both users and Leap members led us to design the approach detailed below.

Account Recovery Feature

Account Recovery Milestone: https://github.com/pixelated/pixelated-user-agent/milestone/4

Feature

In high level, the idea is that the user will set up a backup account, to which half of a recovery code will be sent to. The other half will be sent to the system administrators, with whom the user will have to contact to recover that account. These two codes will then function as a password, but the only possible action the user can complete with this process is to change the password.

Why did we choose to follow this approach?

  • Splitting the code and sending it to different "trusted contacts" ensures the recovery code is not our weakest security breach
  • We don't have to persist any other information from the user, since the backup email will be sent again every time the user asks for a new recovery code
  • Though eventually this approach can be generalised for other users' setting up their own "trusted contacts", the system admin was an already existing trusted contact that we could count on for Pixelated installations

Flows

We separated this feature in two different flows: setting a backup account and recovering the account.

Set up backup account flow

Set up backup account flow diagram

Steps:

  1. User adds backup email
  2. Soledad generates recovery code and encrypts the secret with the recovery code
  3. Pix User Agent sends this code to Bonafide to be saved in the Leap Webapp
  4. In case of success, User Agent send the recovery code to the user and admin accounts
  5. If the whole process is successful, we can now delete the old recovery code

Recover the account flow

Forgot password flow diagram

Steps:

  1. User submits the parts of the recovery codes and the new password
  2. User Agent calls Leap Webapp through Bonafide to change password
  3. Soledad decrypts secret with recovery code and encrypts again with new password
  4. If successful, the User Agent logs in the user with the new password so the user can go to the their inbox