All Collections
Onboard your team with Cheqroom
Troubleshooting issues with User Sync
Troubleshooting issues with User Sync
Vincent avatar
Written by Vincent
Updated over a week ago

Setting up User Sync to automatically synchronize the right set of users from your LDAP compatible server to Cheqroom can sometimes be complex.

View logs

  • Go to your Settings in the bottom left corner of your screen

  • Click Add-ons 

  • Scroll down until you reach the 'sync remote users' section and choose Settings

  • If your User Sync has issues, you'll see an error icon

  • Next, click Actions, View logs

Typical problems

Username containing illegal characters

Skipping user with illegal characters in login 'john.doe@acme.com' (userPrincipalName) 

Often indicates you're trying to use an email field as the Cheqroom username  which is not supported at this time. 

💡A possible solution is to use uid  or sAMAccountName instead.

Username being too short

Skipping user login ab is too short (sAMAccountName)

Usernames have to be between 3 and 128 characters long.

💡A possible solution is to use another unique id from your directory and have your users login with email address and password instead

Username or email address already in use

Skipping user, login john.doe or email john.doe@acme.com already exists elsewhere

Indicates that a user with the same login or email address is already part of Cheqroom, but under another account. The main causes are:

  • The username being too generic e.g. john  which is already in use by someone else in Cheqroom. Probably even in another account, unrelated to your organization.

  • Sometimes that person already set up a new trial by accident. If you think that is the case, contact us so we can investigate.

💡A possible solution is to use another unique id from your directory and have your users login with email address and password instead.

For example; you can map Login  to employeeId  or studentId .

Trying to overwrite the username

Cannot overwrite username from john_doe to john.doe

Once a username exists, it can no longer be changed manually, or via user sync.

Trying to overwrite the account owner

Cannot overwrite account owner john.doe (john.doe@acme.com)

To avoid lock-outs when there are connection or configuration problems, the owner of an account cannot be a synced user.

Different User Syncs have overlapping queries

A single user should never be part of the results of multiple User Sync. You'll have to design your LDAP queries to exclude one group from the other. 

Related articles: 

Did this answer your question?