Skip to content

How to configure an LDAP server on the Windows version of the Sametime 12 chat server

KB0118573

Applicable version

  • HCL Sametime 12.0.2 FP2
  • Sametime 12.0.2 FP2 now includes a dedicated chat server for Windows.

Introduction

This technical document describes how to configure LDAP in this version.

Explanation

To configure the LDAP server, modify the following files:

  • \StCommunityConfig.xml
  • \UserInfoConfig.xml

StCommunityConfig.xml

Before editing, please back up the existing files to another folder. Then, open the StCommunityConfig.xml file with a text editor such as Notepad.

LDAP settings are configured using the attributes within the tag, which is located within the LDAP tag.

Reference:

For a description of the attributes, please refer to the following product documentation: Configuring LDAP

Eexample:

LDAP Connection BaseMembership="" BindEntryDn="CN=Administrator,CN=Users,DC=lab,DC=hcl,DC=com" BindEntryPwd="password" DescAttribute="" EmailAttribute="mail" GroupDescAttribute="" GroupMemberAttribute="member" GroupMembership="(&(objectclass=group)(member=%s))" GroupNameAttribute="cn" GroupObjectClass="group" GroupResolveBase="CN=Users,DC=lab,DC=hcl,DC=com" GroupResolveFilter="(&(objectclass=group)(cn=%s))" GroupResolveScope="recursive" HomeServerAttribute="" HostName="ldap.lab.hcl.com" NameAttribute="cn" OrganizationName="" PersonObjectClass="organizationalPerson" PersonResolveBase="CN=Users,DC=lab,DC=hcl,DC=com" PersonResolveFilter="(&(objectclass=organizationalPerson)(|(cn=%s)(givenname=%s)(sn=%s)(mail=%s*)))" PersonResolveScope="recursive" Port="389" SSLEnabled="0" SSLPort="636" SearchOrder="1" UserDnSearchFilter="(&(objectclass=organizationalPerson)(|(cn=%s)(givenname=%s)(sn=%s)(mail=%s)))" UserIdAttribute="dn"/> /LDAP

Attribute description:

  • HostName: Hostname of the LDAP server
  • Port: Port number of the LDAP server
  • BindEntryDn: Username to connect to the LDAP server
  • BindEntryPwd: Password of the user to connect to the LDAP server
  • NameAttribute: Username
  • PersonObjectClass: Object class to which the user belongs
  • PersonResolveBase: Base DN when searching for users
  • PersonResolveFilter: Filter setting used to search for usernames
  • EmailAttribute: Attribute where the user's email address is stored
  • GroupNameAttribute: Name of the group
  • GroupObjectClass: Object class to which the group belongs
  • GroupMemberAttribute: Attribute where members in the group entry are stored
  • GroupMembership: Filter setting used to search for group members
  • GroupResolveFilter: Filter setting used to search for group names
  • GroupResolveBase: Base DN when searching for groups

UserInfoConfig.xml

This file configures the business card settings used by Sametime. Since business card information is also retrieved from an LDAP server, this file also includes the LDAP server settings.

Before editing, please back up the existing files to another folder. Then, open the UserInfoConfig.xml file with a text editor such as Notepad.

LDAP settings are configured using the attributes within the tag.

  • example: StorageDetails BaseDN="" HostName="ldap.lab.hcl.com" Password="password" Port="389" Scope="2" SearchFilter="(&(objectclass=organizationalPerson)(|(cn=%s)(givenname=%s)(sn=%s)(mail=%s)))" SslEnabled="false" SslPort="636" UserName="CN=Administrator,CN=Users,DC=lab,DC=hcl,DC=com"/

  • Attribute description:

    • HostName: Hostname of the LDAP server
    • Port: Port number of the LDAP server
    • SearchFilter: Filter settings used to search for users
    • UserName: Username to connect to the LDAP server
    • Password: Password of the user to connect to the LDAP server

After saving each setting, restart the Sametime server.

Reference Information

Installation instructions for the Windows version of the Sametime 12.0.2 FP2 chat server