MasterSafe Authenticator logo

MasterSafe Authenticator manual

What each part of the app is for and how to use it, step by step. The pictures are the real app with made-up data; the app also speaks Spanish and Finnish (Settings, Language).

This manual describes version 1.8. Contents:

  1. Signing in and the help
  2. Preparing for a forgotten master password
  3. Restoring when you forgot the master password
  4. Going back to yesterday: daily copies
  5. Folders
  6. Password health and the security check-up
  7. More help

1. Signing in and the help

Each time MasterSafe starts it asks for your master password. Nobody can reset it, not even the app, because your vault is encrypted with it.

The Unlock your vault screen with Help (F1) at the bottom left and About at the bottom right
The sign-in screen. Help (F1) and About are at the bottom.
  • Help (F1) opens the help without unlocking. It holds no data from your vault. Press F1 again, or choose Back to sign in, to return.
  • About shows the version, the licence and the links to the project.
  • Forgot your master password? leads to restoring, see section 3.
The help opened from the sign-in screen, showing the topic about recovery
The help, opened with F1 before signing in. Type in the search box to find a topic.

2. Preparing for a forgotten master password

Do this once, on the Recovery page, while you still know your master password.

The Recovery page with a recovery key set up and the cards Recovery backup, Automatic recovery backup, Printed emergency sheet, Recovery key on paper and Recovery key in 3 parts
The Recovery page after the recovery key was set up.
  1. Create the recovery key. The easiest way is Create recovery key automatically...: MasterSafe chooses a strong passphrase, asks where to save the key file (.msrk) and shows the passphrase once. Write the passphrase on paper and keep it apart from the key file.
  2. Create a recovery backup. It holds your accounts, passwords, folders and attached files, locked so that only your recovery key can open it. It can be kept anywhere, even in the cloud.
  3. Turn on the automatic recovery backup and choose a folder, best on a USB stick or a cloud folder. A minute after each change MasterSafe writes a new backup there and keeps the newest five.
  4. Keep a second copy of the key. A USB stick can break or get lost. Choose one, or both:
    • Print the recovery key... saves a page with the key as QR codes and as text. Open it in a browser, print it and delete the file. The passphrase is not on the paper.
    • Split the recovery key... saves 3 part files. Any 2 parts rebuild the key; 1 part alone tells nothing about it. Keep them in three places, for example a USB stick, a family member and a safe. The passphrase is still needed.
    Both buttons first ask for the key file you saved in step 1. The window that opens is for choosing that file, not for saving a new one.

3. Restoring when you forgot the master password

You need a recovery backup (recovery-....sauth), the recovery key (the file, the printed page or 2 of the 3 parts) and the key's passphrase.

The Forgot your master password panel with the recovery backup chosen, the key rebuilt from its parts, the passphrase and a new master password filled in
Restoring with the key rebuilt from two of its parts.
  1. On the sign-in screen choose Forgot your master password?, then Restore from a recovery backup....
  2. Recovery backup file: choose Browse... and pick the newest recovery-....sauth.
  3. The key, in one of three ways:
    • the key file: Browse... next to Recovery key file;
    • the printed page: Read a printed key... and pick a photo or scan of each page. A code that cannot be read can be typed from the text pages;
    • the parts: Add a key part... twice, once for each part. The panel says when the key was rebuilt.
  4. Type the passphrase of the recovery key.
  5. Type a new master password twice and choose Restore my data.

The old vault is not deleted: it is moved to the archive. If the old password turns up, you can open it from the Vaults page. If something is missing, the message appears under the Restore my data button.

4. Going back to yesterday: daily copies

MasterSafe keeps a copy of the vault from each of the last 7 days it changed. If you deleted something by mistake, go back to an earlier day.

The Vaults page with the Daily copies card and a Restore button next to each copy
Vaults, Daily copies. Each copy has its own Restore button.
  1. Open Vaults and find Daily copies.
  2. Choose Restore... next to the day you want and confirm.
  3. The vault in use is first copied to the archive, then the copy replaces it and the vault locks.
  4. Sign in with the master password that the copy had.

Everything changed after that day is not in the restored vault; it is still in the archived copy. More in the article about daily copies.

5. Folders

On the Passwords page the folder list is on the left.

The Passwords page with the folder list: Work is open and its subfolder Archive is closed
Work is open; its subfolder Archive is closed.
  • New folder: type a name under the list and choose New folder. A folder selected first gets the new one inside it.
  • Open and close: the small arrow in front of a folder hides or shows its subfolders.
  • Hide removes the whole list so the passwords get the full width; Show folders above the search brings it back.
  • Drag passwords onto a folder to move them. Right-click a folder to rename it, change its icon or delete it.
  • Drag the edge of the list to make it wider; double-click the edge to fit it to the names again.

6. Password health and the security check-up

The Password health page: the security check-up with Good and Improve for each setting, and the password check
The check-up says which settings could be stronger and how.
  • Security check-up looks at your settings: automatic lock, clipboard clearing, recovery key, a second way to unlock and others. Each Improve says what to change and where.
  • Passwords are checked for being easy to guess, used more than once, old, or for addresses that are not encrypted.
  • The breach check is optional and off by default. When you allow it in Settings, only a short prefix of a hash of each password is sent.

Pages and cards grow with the window up to a comfortable reading width, so maximising the window gives them more room.

7. More help