This article will teach you how to configure the ILST to sync users from one or more LDAP-supported data sources (e.g.,  Microsoft Active Directory, Azure AD) to your digital workplace. If you don't know what the ILST is, please see the Igloo LDAP Sync Tool (ILST) article to learn more about the ILST's purpose and functions.

For more information about the ILST config.xml file, see ILST configuration reference guide.

Sections in this article: 

• Set up requirements
• How to configure the ILST
• ILST command-line arguments
• Submitting ILST tickets
• Additional resources

Set up requirements

To set up the ILST, you will need:

• The latest version of the ILST (Download the ILST).  
• An administrator, or a qualified member of your IT team, of your LDAP-supported data sources.
• The administrator of your digital workplace.

How to configure the ILST

To configure the ILST, you will be editing the config.xml file found in the same directory as the ILST.

The ILST configuration process has 3 phases:

• Phase 1: Configure the LDAP supported data source(s) and Igloo connections
• Phase 2: Configure the <UserAccount> section to query for users and sync profile attributes
• Phase 3: Configure the <Group> sections to sync groups of users from your LDAP supported data source(s) to your digital workplace

You do not need to complete all three phases at once and can pause between phases. For example, you don't need to have all of your groups mapped out (Phase 3) before setting up your LDAP-supported data sources and Igloo connections (Phase 1). Work with your digital workplace administrators and business owners to determine what information to sync from your LDAP-supported data sources to your digital workplace in each phase.

Phase 1: Configure the LDAP-supported data sources and Igloo connections

Prerequisites:

• Administrator access to your digital workplace or the assistance of someone with administrator access.
• Download the ILST

Phase 2: Configure the <UserAccount> section to query for users and sync profile attributes

Prerequisites:

• Consult your digital workplace administrator and business owners to identify which users and profile fields to sync to your digital workplace. 
• If your digital workplace uses Premium Profiles, the Premium Profiles need to be applied to your digital workplace.

Phase 3: Configure the <Group> sections to sync groups of users from your LDAP-supported data sources to your digital workplace

Prerequisites:

• Consult your digital workplace administrator and business owners to identify which user groups need to be set up in your digital workplace.
• It is helpful to sync a couple of groups initially for testing and then sync the rest once those few are working.

ILST command-line arguments

You can use the following command-line arguments when running the ILST:

Submitting ILST tickets

Only the most recent version of the ILST is supported. Please ensure that you are running the latest version (4.0.1.0) before reporting any issues to Igloo Support.

Include the following information in your ticket:

• Indicate that you are working on configuring ILST
• Attach your ILST.log file. Ensure that your log level is set to Trace. For more information, see Changing how the ILST logs events.
• Include the email addresses and CNs of any users you have questions about
• Attach screenshots of any command-line console errors you are seeing.

To troubleshoot ILST issues, refer to the following:

• Running the ILST in test mode
• Solving ILST errors

Additional resources

For additional ILST documentation, refer to the following:

• Common LDAP Search Strings used with the ILST
• Revoking Users with the ILST
• Finding group GUIDs for ILST group mapping
• Using Task Scheduler to run the ILST
• Updating the ILST