architecture docs
Concepts

Owners and verification

A new device stays locked until its owner proves who they are and that they're standing next to it.

First unlock

  1. The device checks in The owner opens the link for their device. The page waits until the device has reported in.
  2. Phone sign-in The owner enters their phone number and the code sent by SMS. If the device already belongs to someone else, it stops here.
  3. Location check The phone’s position is compared with the device’s latest position, at most 30 minutes old. It passes within 500 m, plus the accuracy of both positions.
  4. Face check Persona checks the owner’s ID and face, and confirms their age.
  5. Register and unlock The device is assigned to the owner and an unlock is queued, in one step. If the owner gives up earlier, nothing is half-saved.
  6. The device confirms The unlock reaches the device in about a second, and the page waits for the device to report it.

Verifying again

When the trust ladder asks for it, the owner gets an SMS with a link. The checks depend on how locked the device is:

Device state What the owner must do
Temp lock Pass a location check.
Hard lock Pass a location check and a new face check, both after the lock.
Not built yet

The re-verification SMS isn’t sent yet, and its text doesn’t include the device’s link. Sign-in codes already go out by SMS.