Appearance
Using Snipe-IT's LDAP sync with Tote
Part of the Tote Help Center — setup guides for the Snipe-IT instance Tote syncs devices into.
Who this page is for
This page is for Snipe-IT admins whose people live in LDAP or Active Directory rather than Entra ID, Google Workspace or Okta.
Tote does not connect to LDAP or on-premises Active Directory directly, because an on-premises directory is not reachable from Tote's cloud-hosted sync. Instead, Snipe-IT's built-in LDAP sync keeps your users in Snipe-IT, and Tote uses those Snipe-IT users when it assigns devices.
Tote's directory connectors exist for Entra ID (via the Intune connector), Google Workspace and Okta.
How Tote finds the person for a device
Tote takes the owner email reported by your device source (MDM) and looks that person up in Snipe-IT by email. It asks Snipe-IT's users endpoint to search for that email and accepts only a result whose email field equals the address exactly, ignoring upper and lower case. It does not match on username, employee number or name.
Each device source reports a different address:
- Intune reports the user's user principal name (UPN).
- Jamf reports the email on the computer's user-and-location record.
- Kandji reports the device user's email.
- Addigy reports the email fact.
If a device has no owner email, Tote skips assignment for it.
What to set up in Snipe-IT
- Turn on and configure Snipe-IT's LDAP integration, and run its LDAP sync so your people exist as Snipe-IT users. The LDAP settings are in Snipe-IT's admin settings (Admin > Settings, LDAP section). The setting that decides which LDAP attribute becomes the Snipe-IT user's email is LDAP Email Field (commonly
mail). The sync is run from People > LDAP, or on a schedule with Snipe-IT's LDAP sync command-line tool. See Snipe-IT's LDAP documentation for the full list of settings. - Make sure every imported user has an email in Snipe-IT, and that it is the same address your device source reports for that person (see the previous section). For Intune this is the UPN, which can differ from a person's mail attribute in LDAP. If they differ, devices will not be assigned.
- Run (or schedule) the LDAP sync so new hires exist in Snipe-IT before their device first reaches Tote. Tote does not wait for a user to appear; it tries again on later syncs (see "What goes wrong if it is not set up").
- The Snipe-IT user that owns Tote's API token needs the View Users permission. Users: Create is not needed for this setup unless you also turn on Tote user sync (see the next section). See Connecting Snipe-IT to Tote.
What Tote does and does not do with users
Tote only creates or deactivates Snipe-IT users when a user directory is configured in Tote (Entra ID via the Intune connector, Google Workspace, or Okta) and that connector has user sync domains set. With no user directory configured, or with no user sync domains, Tote creates no users and deactivates no users.
When user sync is on, Tote creates only users it cannot find by email. It also deactivates in-scope Snipe-IT users who are no longer active in that directory, checking their assets in first. Tote-created accounts are created inactive with a random password.
Recommendation: if LDAP is where your users are managed, leave user sync domains empty in Tote so that only one system creates and deactivates accounts.
What goes wrong if it is not set up
The cases below affect assignment only.
- No Snipe-IT user has that exact email. The device is not assigned. It appears on the Tote dashboard under Couldn't check out with the message "No Snipe-IT user matches this email, so there was nobody to check it out to." Fix the user's email in Snipe-IT (or in LDAP, then re-run the LDAP sync). Tote looks the user up again the next time it processes the device.
- The sync is in enrich-only write mode. Tote never assigns devices in that mode. Assignment happens only in full sync mode.
- The asset is already checked out to someone else in Snipe-IT. By default Tote treats your device source as correct. It checks the asset in from the current holder and checks it out to the person your device source reports.
- Snipe-IT refuses the checkout. The dashboard shows "Snipe-IT refused the checkout." plus Snipe-IT's error text.
- The asset's Snipe-IT status is not deployable. The checkout is not attempted. The dashboard offers a Set to Ready to Deploy & check out button.
Checking that it works
- Run an LDAP sync in Snipe-IT.
- In Tote, press Refresh now, or wait for the next sync.
- Open the dashboard and look for a Couldn't check out group. An empty or absent group means every device with an owner email was assigned.
- For any device listed, compare the "Intune user" email shown on its card with the email on the Snipe-IT user. The card label says "Intune user" for all device sources.