CentraPoint

Administration

Two-factor authentication

Every CentraPoint dashboard user signs in with a second factor: an authenticator app or e-mailed codes, plus backup codes. Set-up, sign-in and resets.

On this page

Overview#

Two-factor authentication (2FA) adds a second step to dashboard sign-in: after your password you enter a 6-digit code. It is required for every CentraPoint user, in every organisation and role. You choose how you get your codes:

  • An authenticator app (recommended), such as Google Authenticator, Microsoft Authenticator, 1Password or Authy. Codes are standard time-based one-time passwords (TOTP, RFC 6238): 6 digits, a new code every 30 seconds. A code is accepted for the current 30-second period and one period either side, to allow for small clock differences, and works only once. The app works without signal.
  • E-mailed codes: each time you sign in, a 6-digit code is sent to your account's e-mail address. A code works for 10 minutes and only once. Anyone who can read your mailbox could use these codes, so keep your e-mail account secure (ideally with its own two-factor).

Either way you also get backup codes for when neither is at hand. No SMS or phone number is involved. Your Profile page and Settings → Security show which method you use.

Setting up two-factor#

You set it up on the Set up two-factor sign-in page shown after you sign in (or, later, with Set up again). Choose Authenticator app or E-mailed codes; both start by confirming your current password.

With an authenticator app#

  1. In your authenticator app add an account (usually a + button) and scan the QR code shown. If you cannot scan, type the setup key (time-based) instead; it is shown in groups of four characters. The account appears in your app as CentraPoint with your email address.
  2. Enter the 6-digit code the app shows and click Turn on two-factor.
  3. Save the 10 backup codes that appear, using Copy codes or Download .txt (centrapoint-backup-codes.txt), then continue. They are shown only once.

With e-mailed codes#

  1. After your password, CentraPoint e-mails a 6-digit code to your account's address. Check your spam folder if it doesn't arrive; Send a new code sends another (the previous one then stops working).
  2. Enter the code and click Turn on two-factor.
  3. Save the 10 backup codes, as above.

Either way, CentraPoint e-mails you a short notice that two-factor was set up on your account. If you get that notice without having done it, contact CentraPoint support straight away.

Signing in#

  1. Enter your email and password as usual.
  2. If the password is correct you are asked for a code. The second step is only shown after the password has been verified.
    • Authenticator app users enter the 6-digit code from the app.
    • E-mail users get their code by e-mail straight away.
  3. Without your usual method, choose E-mail me a code instead (authenticator app users) or Use a backup code. For 24 hours after a password reset with an e-mailed link, e-mailed codes don't work for authenticator app users (whoever reset the password through your mailbox can't also use it as your second factor): use the app or a backup code.

A password alone never signs anyone in. If a code is not accepted you can try again with a new code; if the sign-in fails for another reason (for example your password was changed meanwhile), you are sent back to the first step.

Backup codes#

  • You get 10 codes when you set up two-factor.
  • Each code is 10 characters shown as two groups of five, e.g. k7m2p-x9qrt, using lower-case letters and digits (without easily confused characters such as 0, 1, i, l and o). Capitals, spaces and dashes are ignored when you type one.
  • Each code works once, at sign-in or to confirm Set up again.
  • Settings → Security shows how many codes you have left, with a warning when two or fewer remain.
  • Codes are stored hashed; CentraPoint cannot show them to you again.

Creating new backup codes#

Under Settings → Security → New backup codes, enter a current code from your authenticator app, or click E-mail me a code and enter the code from the e-mail (a backup code is not accepted here). You get 10 new codes and all your old backup codes stop working.

New phone or another method: Set up again#

Two-factor can't be turned off. To move it to a new phone, or to switch between the authenticator app and e-mailed codes, use Settings → Security → Set up again: enter your current password and a current code (from the app, an e-mailed code via E-mail me a code, or a backup code).

  • Your current authenticator secret and backup codes stop working.
  • You are signed out on every other device.
  • This browser goes straight to the set-up page, where you choose a method again and get new backup codes.

Locked out: support reset#

If you have lost your authenticator app (or access to your mailbox) and your backup codes, contact CentraPoint support. Only CentraPoint support can reset two-factor; organisation admins can't. Support first checks that you are who you say you are, and records how. After a reset:

  • your two-factor and backup codes are removed and you are signed out everywhere;
  • you receive an e-mail saying your two-factor was reset;
  • you sign in with your password and set two-factor up again straight away.

Rate limits#

Two-factor rate limits
WhatLimitWhen exceeded
Sign-in attempts per email address (password and code steps, and asking for an e-mailed code, all count)10 per 15 minutesSign-in fails and you are sent back to the first step.
Two-factor code attempts at sign-in6 per 10 minutes per user and IP address, and 30 per hour per user"Too many attempts. Please wait a few minutes and try again."
Guesses of one e-mailed code5That code stops working: send a new one.
E-mailed codes sent1 every 30 seconds and 5 per hour per user"A code was sent a moment ago..." (the last code still works)
Two-factor settings actions (set-up, confirm, Set up again, new backup codes)10 per 15 minutes per user"Too many attempts. Please wait a few minutes and try again."

Limits use fixed time windows, so access returns when the window ends. There is no permanent account lockout; failed code attempts are recorded in the audit log.

Audit log entries#

Two-factor audit events
EventRecorded when
auth.loginA sign-in completed (records the second factor used, or that set-up is still needed).
user.2fa_enrolment_startedA user confirmed their password and received a new QR code.
user.2fa_email_code_sentA code was e-mailed (records what for: sign-in, set-up or confirming a change).
user.2fa_email_code_rate_limitedA user asked for e-mailed codes too often.
user.2fa_enabledTwo-factor was set up (records the method).
user.2fa_restartedA user chose Set up again (records the code type used to confirm).
user.2fa_backup_codes_regeneratedNew backup codes were created.
user.2fa_backup_code_usedA backup code was used (records how many are left).
user.2fa_login_failedA sign-in code was rejected (records the method and IP address).

The audit log is under Settings → Audit log on plans that include it. Support resets are recorded by CentraPoint.

API keys are not affected#

Two-factor applies to signing in to the dashboard only. Requests to the REST API are authenticated with API keys and are not asked for a second factor; see Authentication. Keep API keys secret and revoke any that may have been exposed. Your customers' portal sign-in (an e-mailed code) is unchanged.