Use the ILST with multiple connections

While running the ILST with only one LDAP connection is possible, multiple LDAP connections within the same ILST configuration may sometimes be necessary. For instance, if your LDAP directory has several disparate OUs to be connected to. 

Sections in this article:

Who can do this?

  • An administrator or a qualified IT team member of your LDAP-supported data sources
  • Digital workplace enterprise administrator
  • Digital workplace workplace administrator

Use the ILST with multiple connections

Each connection must have the following:

    • A <Connection> element with information for connecting to the LDAP Directory.
      • Requirements: There must be a unique integer <Id> value, which will be referenced in <UserAccount> and <Group> elements.
    • A <UserAccount> element that handles the <SearchString> and <Attribute> elements for your connection.
      • Requirements: There must be a <ConnectionId> element that matches the <Id> element of the relevant <Connection>.
    • (Optional) One or more <Group> elements that are specific to the connection.
      • Requirements: There must be a <ConnectionId> element that matches the <Id> element of the relevant <Connection> element.
<Connections>
   <Connection>
      <Id>1</Id>
      <Title>Connection One</Title>
      ...
   </Connection>
<Connection>
<Id>2</Id>
<Title>Connection Two</Title>
...
</Connection> </Connections>
<UserAccounts>
<UserAccount>
<Title>Connection One</Title>
<ConnectionId>1</ConnectionId>
...
</UserAccount>
<UserAccount>
<Title>Connection Two</Title>
<ConnectionId>2</ConnectionId>
...
</UserAccount>
</UserAccounts>
<Groups>
<Group>
<Title>ExampleGroupA</Title>
<ConnectionId>1</ConnectionId>
...
</Group>
<Group>
<Title>ExampleGroupB<Title>
<ConnectionId>2</ConnectionID>
</Group>
</Groups>
...

For additional information about elements in the ILST file, see ILST configuration reference guide.

You can run the ILST in test mode before running it against the live digital workplace; see Running the ILST in test mode.

Troubleshooting

Groups not syncing or incorrectly

Ensure the following:

  • All <ConnectionId> elements have a unique integer ID 
  • All <Group> elements have the correct <ConnectionId> value associated with them.
  • When syncing users from multiple connections into the same Igloo group, you have a <Group> element for each connection.

Managers and users are not syncing correctly

When using the Manager sync, ensure the user and manager are in the same <Connection> element.