Search documentation

Search across BlockBee docs, API endpoints, webhooks and guides.

How to set up two-factor authentication

View as Markdown

By default, BlockBee e-mails you a code when you sign in or confirm a sensitive action. You can make your account safer by adding recovery codes, an authenticator app and a security key such as a YubiKey, Touch ID or Face ID.

You set the methods up in this order. Each one unlocks the next:

  1. Recovery codes
  2. Authenticator App
  3. FIDO2 WebAuthn (security key)

Step 1: Open Security

Click your avatar in the top-right corner of the Dashboard. Under Settings, choose Security.

Step 2: Create your recovery codes

Next to Recovery codes, click Set up. If BlockBee asks for a code, enter the one it sent to your e-mail.

A window shows your codes. Each code works once. Use print, copy or Download to keep them, and store them away from your computer.

Step 3: Add an authenticator app

Next to Authenticator App, click Set up. Then:

  1. Install an authenticator app on your phone, such as Google Authenticator, Authy or Microsoft Authenticator.
  2. Scan the QR code with the app, or type the code shown below it.
  3. Type the 6-digit code from the app in TOTP Code and click Confirm.

From now on, BlockBee asks for a code from the app instead of an e-mail code.

Step 4: Add a security key (optional)

Next to FIDO2 WebAuthn, click Set up. Then:

  1. Type a Name that helps you tell the key apart, for example "Office YubiKey".
  2. Plug in your security key, or get ready to use Touch ID or Face ID.
  3. Click Read key and follow your device's prompts.

The key now shows under Registered devices. You can register up to 5 devices.

Check your active sessions

The Active sessions list on the same page shows every device signed in to your account.

  • To sign out one device, click Sign out on its row.
  • To sign out every device except the one you are using, click Sign out other sessions.

If you see a device you don't recognize, sign it out. Then change your password: open the avatar menu, choose Account settings and use Change Password.

Related Articles