ARN Smart Support
Language: English

Two-factor authentication and password reset

Updated 9 Nov 2026 5 min read

Feedback saved.

Browse Ticketix articles

Ticketix protects accounts with two-factor authentication and lets users reset a forgotten password with a one-time email link.

AccountTwo-factor authentication
Administrators and agentsRequired; set up at the first sign-in
CustomersOptional; turned on under Account security in the portal

Set up two-factor authentication

You need an authenticator app on your phone, for example Google Authenticator, Microsoft Authenticator or 1Password.

  1. Open the setup page. For staff, it opens automatically at the first sign-in; later, it is under Two-factor authentication in the user menu. Customers click Account security in the portal menu or at the bottom of a portal page.
  2. Under 1. Scan the QR code, add an account in your authenticator app and scan the code. If you cannot scan it, open Cannot scan? Enter the setup key and type the key (time based, 6 digits, 30 seconds).
  3. Under 2. Confirm, enter the Six-digit code from the app and your Current password.
  4. Click Turn on two-factor authentication.
  5. Save the ten codes under Save your backup codes in your password manager. Each code works once. They are shown only now.

The setup code is valid for ten minutes. If it expires, click Create a new setup code. The QR code is drawn in your browser; the setup key is not sent to any other service.

Staff cannot open any other admin screen until two-factor authentication is set up.

Sign in with a code

  1. Enter your email (staff can also use their display name) and password as usual.
  2. On Two-factor authentication, enter the six-digit code from your app, or one of your backup codes, under Authenticator or backup code.
  3. Click Verify.

Each code works once. You can try up to five codes in five minutes; after that, wait a few minutes. The code step must be completed within five minutes of entering the password.

Manage your second factor

On the same page (Two-factor authentication for staff, Account security for customers) you see when it was Turned on and how many Unused backup codes are left.

  • New backup codes: enter an authenticator or backup code and your current password, then click Create new backup codes. The old codes stop working.
  • Turn off (customers only): enter a code and your current password, then click Turn off two-factor authentication. Staff accounts must keep two-factor authentication.

Forgot password

The customer portal and the staff sign-in both have a Forgot password? link.

  1. Click Forgot password?, enter the email address of your account and click Send reset link.
  2. Ticketix answers in the same way for every address, so the form does not reveal which addresses have accounts. If an account exists, it receives the Password reset link email.
  3. Open the link. It works once and is valid for 60 minutes.
  4. On Set a new password, enter the New password (at least 8 characters) and Repeat the new password, then click Save password.
  5. Sign in with the new password. You receive a Password changed email.

Good to know:

  • Two-factor authentication stays on after a password reset. The next sign-in still asks for your code.
  • A new reset link replaces older unused links.
  • Requests are limited: five per IP address in 15 minutes and three per email address per hour.
  • Guest records created from a guest ticket have no password to reset; a guest sets one from the ticket link.
  • Changing or resetting a password, or changing the second factor, signs the account out everywhere else.

Recover a locked-out account

SituationWhat to do
An agent lost their phone and backup codesAn administrator opens Setup → Team → Agents and roles, opens the agent and clicks Reset two-factor authentication
A customer lost their phone and backup codesAn administrator opens Work → Customers, opens the customer and clicks Reset two-factor authentication, after confirming the customer's identity
A staff member forgot their password and the email does not arriveAn administrator opens the user under Setup → Team → Agents and roles, clicks Reset password and gives them the temporary password
The only administrator is locked outUse the recovery script on the server (below)

After a reset, the person sets up two-factor authentication again at the next sign-in.

The recovery script

scripts/account-recovery.php runs on the server from the application folder. It needs neither the web server, the licence nor SMTP.

php scripts/account-recovery.php reset-2fa admin@example.com
php scripts/account-recovery.php reset-link admin@example.com
  • reset-2fa removes the second factor of the account; it is set up again at the next sign-in.
  • reset-link prints a one-time password reset link, valid for 60 minutes. Open it on the public address of the installation. Two-factor authentication stays on.

Important: storage/ai-secret.key protects the authenticator secrets and backup codes. Keep it with your storage backups. If it is lost, authenticator and backup codes stop working, and two-factor authentication must be reset for each account with the recovery script or by an administrator.

On this page

Submit a ticket

Create a new support request without needing a portal account.

Priority
Attachments
Only you and our staff see a ticket. Never send passwords or licence codes.

Track a ticket

Use the ticket number and password from your confirmation email.

The number and the password are in your confirmation email.

Sign in

Access your support portal account.

New here?

Create account

Create your support portal account.

Already have an account?

Forgot password?

We email you a link to choose a new password.

Conversation

Was this helpful?
Open full article
↑ ↓ to moveEnter to openEsc to close