1. Vahty
  2. Security

How Vahty protects your files

The short version first, in plain words. The exact algorithms are further down for anyone who wants to check our work.

The short version

What Vahty protects you from

What Vahty cannot protect you from

No vault app can do everything, and it is better that you hear it here.

What happens when you draw your pattern

Your patternOnly in your head. Never stored.
Your iPhone's Secure EnclaveA chip whose key cannot be copied out.
The vault keyExists only while the vault is open. Erased the moment it locks.
Photoown key
Documentown key
Passwordown key
Cardown key
Opening the vault needs your pattern and your own iPhone, together. That makes the vault key, and the vault key opens the separate key of each file. Take away either one and the files stay scrambled.
The four steps, in words
  1. The shape you draw is turned into a key by a deliberately slow calculation (600,000 rounds), so each guess costs real time.
  2. That key is useless alone. The vault's master key is wrapped twice: once by your pattern, once by the Secure Enclave in your iPhone.
  3. When both agree, the master key is held in memory, and it unlocks the individual key of each file as you open it.
  4. When you leave the app, the master key is erased from memory. Locking is not a screen being drawn over your files; the key is gone.

Recovery words and backups

At setup Vahty shows 12 words, once. They are a second, independent key to the same vault. Type them in and you can draw a new pattern, on this phone or a new one. Write them on paper. Do not keep them in a screenshot or a notes app.

  1. 1

    Turn on iCloud backup

    One tap when you set Vahty up. It writes everything into one sealed file in your own iCloud and keeps it up to date by itself. Apple stores the file but cannot open it.

  2. 2

    Keep your 12 words

    Vahty shows you 12 recovery words when you set it up. Write them on paper. They open the backup, and they reset a forgotten pattern.

  3. 3

    Open it on a new iPhone

    Install Vahty and choose "Restore from a backup". It finds the file in your iCloud by itself. Type the 12 words, draw a new pattern, and everything is back.

How the backup works, in detail

A backup is a single encrypted file holding every vault. With one tap it goes to Vahty's own folder in your iCloud Drive and keeps itself up to date: right after you add files while the vault is under 500 MB, daily for larger ones. It uses your own iCloud storage, and Vahty tells you when iCloud has not taken the newest backup. For an extra copy on a computer, "Back up vault" writes the file once. Backup is off until you turn it on. Whoever holds the file but not the 12 words holds nothing readable.

The details, for people who check
  • File encryption: AES-256-GCM, in chunks, each file with its own random 256-bit key stored wrapped by the master key. File names and thumbnails are encrypted as well.
  • Pattern to key: PBKDF2-HMAC-SHA512, 600,000 iterations, over the pattern and a random 32-byte salt.
  • Device binding: a non-exportable P-256 key generated in the Secure Enclave takes part in every unlock attempt.
  • Recovery: 128 bits of randomness shown as 12 BIP39 words; the recovery key is derived with HKDF.
  • On disk: everything is stored under iOS's strongest file protection class. Decrypted temporary files are wiped on lock and at launch, and are excluded from device backups.
  • Lockout: 5 free attempts, then 30 s, 1 min, 5 min, 30 min, 1 h. The counter is kept in the Keychain and survives reinstalling the app.
  • Clipboard: anything copied from the vault stays on this iPhone only and clears after two minutes.
  • Code: the encryption layer is built only on Apple's CryptoKit, CommonCrypto and Security frameworks, with no third-party libraries, and is tested against published test vectors for PBKDF2, HKDF and AES-GCM.

Questions

Can Vahty or Apple read my files?

No. The keys exist only on your iPhone, and Vahty has no server to send anything to. The iCloud backup, if you turn it on, is already encrypted when it is written, so Apple stores a file it cannot read.

Can someone copy the vault off my phone and crack it on a computer?

They can copy the encrypted files, but not open them. The key that your pattern unlocks is wrapped a second time by the Secure Enclave, a chip in your iPhone whose key cannot be exported. Guessing has to happen on your phone, where the waits apply.

Has Vahty been audited?

Not yet by an outside firm. The encryption code has been reviewed internally and is tested against published test vectors. An independent review is planned, and the report will be linked on this page when it exists.

What encryption does Vahty use?

AES-256-GCM for files, PBKDF2-HMAC-SHA512 with 600,000 rounds to turn your pattern into a key, a P-256 key in the Secure Enclave to bind that key to your phone, and a standard 12-word BIP39 phrase for recovery. All of it comes from Apple's own cryptography libraries; the encryption layer uses no third-party code.

Found a problem? Write to hello@vahty.com. We read every report.