Ticketix protects accounts with two-factor authentication and lets users reset a forgotten password with a one-time email link.
| Account | Two-factor authentication |
|---|---|
| Administrators and agents | Required; set up at the first sign-in |
| Customers | Optional; 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.
- 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.
- 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).
- Under 2. Confirm, enter the Six-digit code from the app and your Current password.
- Click Turn on two-factor authentication.
- 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
- Enter your email (staff can also use their display name) and password as usual.
- On Two-factor authentication, enter the six-digit code from your app, or one of your backup codes, under Authenticator or backup code.
- 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.
- Click Forgot password?, enter the email address of your account and click Send reset link.
- 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.
- Open the link. It works once and is valid for 60 minutes.
- On Set a new password, enter the New password (at least 8 characters) and Repeat the new password, then click Save password.
- 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
| Situation | What to do |
|---|---|
| An agent lost their phone and backup codes | An administrator opens Setup → Team → Agents and roles, opens the agent and clicks Reset two-factor authentication |
| A customer lost their phone and backup codes | An 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 arrive | An administrator opens the user under Setup → Team → Agents and roles, clicks Reset password and gives them the temporary password |
| The only administrator is locked out | Use 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-2faremoves the second factor of the account; it is set up again at the next sign-in.reset-linkprints 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.keyprotects the authenticator secrets and backup codes. Keep it with yourstoragebackups. 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.