Authentication Troubleshooting
Authentication
Common sign in situations with the likely cause and the recommended resolution. The related guide is named on the left.
Five Checks to Make First
- Is the email or extension correct? A typo is the most common reason a sign in fails.
- Is the right method selected? Password, 3CX and AD each use their own form and their own password.
- Is the user active? Open the User Details panel and check Active and Status.
- Is the person blocked? Too many wrong one time passwords block a person for the block time.
- Is the invitation still valid? Links stop working after the Invitation Expiry Window.
Symptoms, Causes and Resolutions
| Topic | Symptom | Likely Cause | Resolution |
|---|---|---|---|
| User Sign In | A sign in button is missing on the Login page. | The method is not enabled. | Ask an administrator to enable it. See Configuration. |
| User Sign In | The Login page offers an old account. | The Recent Login card from Remember me. | Sign in with another account, and clear Remember me on shared devices. |
| Email Login | The invitation link does not work. | The Invitation Expiry Window has passed. | Ask an administrator to use Resend Invite. |
| Email Login | The new password is rejected. | It does not meet the rules. | Use eight or more characters with uppercase, lowercase, a number and a special character. |
| Forgot Password | No reset email arrives. | A wrong address or a spam filter. | Check the spam folder, confirm the address and try again. |
| 3CX Login | Login with 3CX is not shown. | Enable 3CX Login is not Yes. | Set it to Yes in the 3CX plugin and save. See 3CX Login. |
| 3CX Login | A new extension cannot sign in. | The next sync has not run. | Wait for the Data Sync Interval and check that the person is active. |
| LDAP Login | Login with AD fails for everyone. | A wrong server URL, Base DN or service account password. | Correct the LDAP Configuration and save. See LDAP Login. |
| LDAP Login | A person is missing after a sync. | The person is outside the Base DN. | Widen the Base DN or move the person in the directory. |
| Single Sign On | The provider signs in but the platform refuses. | No platform user matches the provider account. | Create the user with the same email. See Single Sign On Options. |
| Two Factor | The code is not accepted. | The code expired or an older code was used. | Click Resend OTP when the countdown ends and use the newest code. |
| Two Factor | The person cannot try again. | The OTP Attempt Limit was reached. | Wait for the OTP Attempt Block Time, or ask an administrator to review the limits. |
| User Sign In | The message Session expired. Please log in again. appears. | The saved Recent Login or the session is no longer valid. | Sign in again with your details. The old card is removed automatically. |
| User Sign In | Red messages appear under the fields and nothing is sent. | A field is empty or the email is not valid. | Complete the fields. See User Sign In. |
| Email Login | The Link Expired page opens from an email link. | The link expired, was already used or is not valid. | Ask for a new invitation, or use Forgot password? on the Login page. |
| Email Login | The message The two passwords do not match! appears. | The two password entries differ. | Retype both entries carefully. |
| Email Login | The Sign Up address opens the Login page. | The platform already has users, so Sign Up is closed. | Ask an administrator to invite you. |
| Two Factor | No code arrives. | The Phone field of the user is empty or wrong. | Ask an administrator to correct the phone number, then use Resend OTP. |
| Two Factor | The message OTP must be 6 digits! appears. | The code is shorter or longer than expected. | Type every digit of the code, using numbers only. |
| Two Factor | Resend OTP is greyed out. | The countdown is still running. | Wait until Resend OTP available in reaches zero. |
| Sessions | A person is missing from Active Sessions. | The Active Session scope hides them, or they are signed out. | Check the scope of your role. See Managing Sessions. |
| Permissions | The Users or Plugins page does not open. | The role lacks the permission. | Ask an administrator to update the role. See Permissions. |