Vault Help

Vault for Android

The Vault app keeps an encrypted copy of your passwords on your phone, so you can use them even without a data connection, and fills logins in apps and browsers.

The screenshots show a made-up demo vault for “Acme”; the test card number 4111 1111 1111 1111 and all the passwords are fake.

Set up Vault in the Chrome extension first. The app is set up from the extension, and some things (password groups, KeePass import and export, administration) are only in the extension.

A tour of the app

Open a password group, show a card number, start a new card and look through Settings. The sections below explain each step.

▶ Video (49 s): a tour of the phone app.

Setting up the app starts in the Chrome extension: see the short video under Phones in the Chrome help.

Installing the app

Vault isn't on Google Play: your organisation publishes it on its own Vault site.

  1. On a Samsung phone, first turn off Auto Blocker (Settings → Security and privacy → Auto Blocker). It blocks apps from outside the store.
  2. On your phone, open the download page (for example https://vault.saint.co.za/download/) and tap Download Vault.
  3. Open the downloaded file. Android asks to allow your browser to install apps: allow it, go back, and tap Install.
  4. Turn Auto Blocker back on.

After that, Vault updates itself (see Updating the app).

Setting up the app

Open Vault. On Set up Vault on this phone, choose one of three ways.

The Set up Vault on this phone screen with Scan QR code, Use a recovery kit file and Recover my account.
The three ways to set up.

With a QR code from the extension (easiest)

  1. On your computer, open the Vault extension's vault page, click your name at the top right, and under Phones click Set up a phone. A QR code appears for 5 minutes.
  2. On the phone, tap Scan QR code and allow the camera.
  3. Point the camera at the QR code. Your key travels encrypted, and only your phone can open it.
  4. Enter your Vault passphrase (the same one as in the extension), and your two-factor code if asked.

With your recovery kit

Tap Use a recovery kit file, enter the server address (for example vault.saint.co.za), check the server key fingerprint, choose your recovery kit file and enter your passphrase.

By recovering your account

If you've forgotten your passphrase, or have no computer to hand, tap Recover my account. See Forgot your passphrase.

Vault then downloads your passwords. The first time this takes a moment; after that it only fetches what changed. The phone appears in the extension under Phones.

Unlocking

The Unlock Vault screen with a passphrase box, an Unlock button and Forgot your passphrase?.
Unlocking (with fingerprint unlock on, there is also a Use fingerprint button).

Without a connection

Your passwords are kept on the phone in an encrypted database that only your passphrase opens. Without a connection you can unlock, search, view, copy and autofill as usual. Vault syncs when it's open and connected, and when you pull down on the list.

Finding passwords

The Vault list with search, All and Favourites, the Finance and Infrastructure groups and several logins.
The list.
Inside the Finance password group: a card, an API key and a login.
Inside a password group: 💳 cards and 🔑 API keys.

Viewing and copying

Tap an entry to open it.

A card with its number shown as 4111 1111 1111 1111, the expiry date and account number, and the CVV and PIN hidden.
A card, with the card number shown.

Adding, editing and sharing

These need a connection. Vault first checks the server for changes, then saves straight to the server.

The Add to Vault question with Login, API key and Card.
New asks what to add.
The New card form with name, bank, cardholder, the card number in groups of four and the expiry date.
Adding a card.

Autofill in apps and browsers

Turning it on

  1. In Vault, open Settings and tap Turn on autofill. Android shows its autofill service list: choose Vault.
  2. In Chrome, also open Chrome's Settings → Autofill services and choose Autofill using another service. (Samsung Internet, Firefox and others use Android's setting directly.)

Using it

Saving logins from autofill

When you sign in somewhere with a password Vault doesn't have, Android offers Save to Vault? after you submit the form. Tap Save: Vault opens with the website or app and what you typed filled in. Check the name and tap Save. If you already have a login for that username, Vault offers to update its password instead. Saving needs a connection.

Updating the app

Vault checks for a new version after it syncs. When there is one, the list shows Vault … is available. Tap to install.

  1. On a Samsung phone, turn off Auto Blocker.
  2. Open Settings → App updates and tap Install (or Check for updates first).
  3. The first time, Android asks to allow Vault to install apps: allow it, go back and tap Install again.
  4. Confirm in Android's installer. Your setup and passwords stay as they are.
  5. Turn Auto Blocker back on.

Vault checks the download before installing it, and Android only installs an update signed by your organisation.

Settings

Settings: account, last synced with Sync now, Unlock with fingerprint, and Autofill.
Settings (top).
Settings: key fingerprint, the app version with Check for updates, Help, Lock now and Remove Vault from this phone.
Settings (bottom).

Lost or new phone

Forgot your passphrase

  1. On the unlock screen, tap Forgot your passphrase? and confirm Remove from phone. (Your passwords are safe on the server.)
  2. On Set up Vault on this phone, tap Recover my account, enter the server address and your email, and tap Send recovery email.
  3. Paste the recovery link from the email (I already have a recovery link if you have it already), and check the server key fingerprint.
  4. Choose a new passphrase and tap Ask for recovery. Read the code on screen to your administrator, who approves the request.
  5. Keep the screen open: once approved, Vault finishes setting up with your new passphrase.

Each device keeps its own copy of your key, protected by the passphrase it was set up with. The new passphrase is for this phone; the extension still uses the old one. If you've forgotten that too, use Forgot your passphrase? in the extension as well.

Troubleshooting

“Could not reach the server.”
Check the phone's connection and the server address. Your passwords still work offline.
Installing is blocked.
On Samsung, turn off Auto Blocker. Otherwise allow your browser (or Vault, for updates) to install apps when Android asks.
No Vault suggestions under login fields.
Check that Vault is the autofill service (Settings → Autofill: on), and in Chrome that Autofill using another service is chosen. Suggestions under the field only appear for websites in known browsers; in apps use Choose a login from Vault.
The list says the server wants a two-factor code.
Tap the banner and enter the code from your authenticator app. Your passwords stay usable meanwhile.
Vault says it hasn't synced for too long.
Connect to the internet and tap Sync now. The same happens if the phone's clock was set back.
A login doesn't appear under login fields, though it matches.
Vault only fills logins whose details are signed. Older ones are signed when someone who can edit them opens Vault in Chrome; sync afterwards. You can still copy them.
Fingerprint unlock stopped working.
Adding a fingerprint or face to the phone turns it off. Unlock with your passphrase and turn it on again in Settings.