Turn on two-step verification (2FA)
Require a code from your authenticator app or by SMS in addition to your password. Setup, sign-in, recovery codes and what to do if you lose your phone.
Last updated:
With two-step verification on, signing in to Polpo Desk requires your password and a one-time code. Even if someone gets hold of your password, they can't sign in without your phone.
You can get the code in two ways:
| Method | How you get the code | Plans |
|---|---|---|
| Authenticator app | A 6-digit code generated by an app on your phone | Free on every plan |
| Code by SMS | A code sent by text message to your verified mobile number | Team and Business |
The feature is off by default; turning it on is your choice. Each user turns it on for their own account. You can turn on one method or both. If both are on, you choose which one to use each time you sign in. The recovery codes are shared by both methods.
What you need
- For the authenticator app: Google Authenticator, Microsoft Authenticator, Authy or any app that generates standard (TOTP) codes. The app generates codes even without an internet connection.
- For SMS: a verified mobile number on your account and a plan that includes Two-step verification by SMS. The plan cards show which plans include it; see Plans and limits.
Where to find the setting
The setting is in three places: in the Panel under Settings in the user menu at the top right, in Polpo Desk (Windows, Linux) under Settings → Profile, and in the mobile app under Settings. The steps are the same everywhere.
The Two-step verification (2FA) card shows whether verification is On or Off and shows your Mobile number. When it's on, the card also shows the status of each method (Authenticator app, Code by SMS) and how many recovery codes you have left. To add or change your mobile number, see Profile settings.
Turn on the authenticator app
- On the Two-step verification (2FA) card, click Set up authenticator.
- Enter your account password and click Continue.
- Add a new account in your authenticator app and scan the QR code on screen. If you can't scan it, enter the key shown below it manually.
- Enter the 6-digit code shown in the app and click Turn on.
- Your recovery codes appear. Save them with Copy or Download (.txt), then click I've saved them.
If SMS verification was already on, setting up the app creates new recovery codes and the old ones stop working.
Turn on SMS verification
- Make sure the Mobile number on the card is marked verified. If no number is shown, click Add phone first.
- Click Turn on SMS.
- Enter your account password and click Turn on SMS again.
- If two-step verification wasn't on before, Your recovery codes appear. Save them and click I've saved them. If the authenticator app is already on, your existing recovery codes stay valid.
If the Turn on SMS button isn't shown, the card tells you why: either your plan doesn't include SMS verification, or you need to add your mobile number first.
Signing in
After you enter your email and password (or sign in with Google or Microsoft), the Two-step verification window opens. This step applies to the sign-in screens of the Panel, Polpo Desk, the operator apps and the mobile app.
With the authenticator app: type the current code from the app; it's sent automatically once all 6 digits are entered.
- The code changes every 30 seconds. Make sure your phone's clock is set automatically; if it drifts too far, codes won't match.
- A code can't be used twice. If you're signing in on another device right after, wait for the app to show a new code.
With SMS: if SMS is your only method, the code is texted to you as soon as the window opens, and the window shows the masked number it was sent to. If both methods are on, click Get the code by SMS (or Use the code from the app to switch back). Enter the code from the text message.
- An SMS code is valid for 10 minutes. After 5 wrong attempts, request a new code.
- You can request a new code with Resend after 60 seconds.
If you don't enter a code within 5 minutes, you'll be asked for your password again.
Can't access your phone? Use a recovery code
In the sign-in window, click Can't access my phone — use a recovery code and enter one of your recovery codes (e.g. ABCDE-23456). Each code works only once; after signing in you're told how many are left.
When you're running low (3 or fewer), the settings card shows a warning. To create new codes, click New recovery codes and enter the code from the app. If SMS is on, you can click Text me a code below the code field instead. Once new codes are created, all the old ones stop working.
Lost your phone or your mobile number?
- You can still sign in (with the app, a recovery code or your new phone): click Change next to your mobile number on the card. You need your account password and the code sent to the new number.
- You've lost your phone and your recovery codes: an admin of your organization clicks Reset 2FA on your row on the Users page of the Panel. This turns off both methods. At your next sign-in only your password is required; you can then set up two-step verification again.
- If you're the only admin of your organization, or you can't reach your admin, contact our support team. After verifying your identity, support can reset your two-step verification and remove the lost number from your account. You then verify a new number the next time you sign in.
Turn it off
- Turn off only SMS (when the app is also on): click Turn off SMS, then enter your password and a verification code. The authenticator app stays on.
- Turn off completely: click Turn off, then enter your password and the code from the app, an SMS code (click Text me a code) or a recovery code. Both methods are turned off and the key and recovery codes are deleted. If you turn it on again, you add a new account in the app.
If your organization moves to a plan without SMS verification, SMS stays on so that you aren't locked out. Once you turn it off, though, you can't turn it back on with that plan.
I didn't receive the SMS
- Wait at least 60 seconds before pressing Resend; text messages can take a moment to arrive.
- Check the number and the country you chose. Enter a mobile number; landlines can't receive codes.
- For your security, the number of codes is limited: at most 5 per hour and 10 per day for the same number. If you see Too many codes requested, try again later.
- If you're told that text messages can't be sent to your country right now, use the authenticator app or a recovery code instead.
- If the problem continues, contact our support team.
Security details
- The authenticator key and your mobile number are stored encrypted on the server; for recovery codes only a one-way hash is kept.
- After 5 wrong codes in a row, verification is locked for 15 minutes.
- Turning it on or off, regenerating recovery codes, resets and mobile number changes are recorded in the audit log. You receive an email whenever two-step verification is turned on or off.
For other security measures, see How does Polpo Desk keep you secure?