Getting back in after losing your two-factor device
What to do when you have lost the phone or inbox you use for verification codes, and how an administrator resets two-factor authentication.
What to do when you have lost the phone or inbox you use for verification codes, and how an administrator resets two-factor authentication.
This is for anyone who cannot get past the code step when signing in, and for System Admin and HR users who have to reset someone else. Which one applies depends on whether you still have your recovery codes.
If you lose your phone or your inbox
If you saved recovery codes during setup, use one. On the code screen select Use a recovery code, type one of the codes (they look like XXXXX-XXXXX) into Recovery code and select Verify. Each code works once. Recovery codes are not submitted automatically, so you always need to select Verify.
Once you are in, go to My Profile, add a new method and remove the old one, then regenerate your recovery codes. The steps are in Changing your two-factor methods and recovery codes.
If you have no recovery codes either
You cannot get past the code step yourself, so someone else has to reset your two-factor authentication.
- A System Admin can reset it for anyone in the organisation.
- An HR user can reset it only for people with the Member role.
- Nobody can reset their own from the Users page. A locked-out System Admin needs another System Admin to do it.
Anyone asked to reset a login should first check that the request really comes from that person.
How an administrator resets two-factor authentication
- Go to Settings, Team & Access, User Management and find the person's row.
- Select the Reset two-factor authentication icon (a shield with a line through it). It is not shown on your own row.
- Confirm. The message reads "Reset two-factor authentication for [name]? They will need to set it up again the next time they sign in."
This works for active users only. Deactivated users cannot be reset. If the reset fails you see "We couldn't reset two-factor authentication. Please try again."
A reset also ends every trusted device for that person, so their browsers ask for a code again as well. At their next sign-in, anyone whose role or organisation requires two-factor authentication is sent to the Set up two-factor authentication page and goes through the steps in Setting up two-factor authentication with a new method and new recovery codes. Everyone else can turn it on again from My Profile if they want it.
Error messages
| Message | What to do |
|---|---|
| Invalid code. Please try again. | The code was wrong or has timed out. Enter the one showing now, or request a new email code. |
| That code has expired. Select Send a new code to get a fresh one. | An emailed code lasts 5 minutes. Select Send a new code. |
| Too many attempts. Please wait a few minutes and try again. | Wait, then enter a fresh code. |
| We could not email your code. Please try again. | Recruit could not send the setup email. Wait a moment and retry. |
| We could not send your code. Please try again. | The same problem on the sign-in screen. Select Send a new code, or use a recovery code. |
| Two-factor authentication is required by your organisation. | You tried to remove a method you are not allowed to remove. |