Home CMS Documentation Home Cartella Using Cartella Settings Configuration User Group Sync Configuring Synchronizers Syncing to LDAP

Syncing to LDAP

Prerequisites: Users require site administrator permissions to complete this task.

Use the User Group Configuration Tool view to integrate LDAP user stores. Syncing to LDAP imports membership data used to populate groups in Cartella. All of the contacts for a given company are converted to Cartella users and associated with the appropriate customer group.

Note

Choose whether or not to sync LDAP in the Cartella user interface or in Cartella.config. See Advanced Setup: Syncing to LDAP to configure the LDAP synchronizer via Cartella.config.

Important

Contact your organization's system administrator to obtain LDAP values.

To sync to LDAP:

Log in to Cartella.
Navigate to Settings > Configuration Management > User Group Sync.
Click LDAP to expand the section.
Clear or select the Add Seat on Creation checkbox.
Note
Selecting this option adds LDAP users to the Cartella seat count on creation.

Enter the following fields in the Connection Info section:

Field	Description
domain	LDAP domain.
server	LDAP server. Example: `server.domain.com`
userName	LDAP account username.
password	LDAP account password.
distinguishedName	String that uniquely identifies an entry in the Directory Information tree. Example: `OU=Groups,DC=domain,DC=com`
query	LDAP query that specifies what information you are seeking. Example: `(&(objectClass=group))`
authenticationType	Type of LDAP authentication. Example: `Secure` Note Verify the validity of the authentication type for System.DirectoryServices.AuthenticationTypes enum.
groupUserKey	Group user key for LDAP. Member name of users for a group record in LDAP. Example: `member`

Enter the following fields in the Group Mapping Info section:
Field Description
Name Key Name key for LDAP.
Example: sAMAccountName
Group Format String LDAP group format string.
Example: ingeniux-{0}

Field	Description
Name Key	Name key for LDAP. Example: `sAMAccountName`
Group Format String	LDAP group format string. Example: `ingeniux-{0}`

Enter the following fields in the User Mapping Info section:

Field	Description
External ID Key	ID of the external key. Example: `sAMAccountName`
Login Name Key	Email for the login name key. Example: `sAMAccountName`
Login Name Format String	Format string for the login name. Example: `domain\{0}`
First Name Key	First name. Example: `givenName`
Last Name Key	Last name. Example: `sn`
Email Key	Email for LDAP. Example: `mail`
Phone Key	Phone number.
Company Key	Company.

Optional: Enter the following fields in the User Mapping Info section:
Field Description
Store Key Key for store.
Example: homeDirectory
Cartella Key Key for Cartella.
Example: share
Note
Click Add Field to add additional Store Key and Cartella Key fields as needed.
Note
Click Remove to remove each field set.
Click Save Changes.
Cartella saves and syncs the LDAP configuration changes.

Field	Description
Store Key	Key for store. Example: `homeDirectory`
Cartella Key	Key for Cartella. Example: `share`