LDAP Sync Utility fails if password used in LDAPSync.xml file contains XML special characters

Document ID : KB000087317
Last Modified Date : 14/04/2018
Show Technical Document Details
Issue:
Error Message :
[Fatal Error] LDAPSync.xml:3:75: The reference to entity "m6" must end with the ';' delimiter.

The LDAPSync utility will fail if the password being used in the LDAPSync.xml file contains XML special characters.

Example error message:
[Fatal Error] LDAPSync.xml:3:75: The reference to entity "m6" must end with the ';' delimiter.
2017-06-09 11:06:33.556 [main] c.a.s.l.LDAPSynchronizer ERROR
com.thoughtworks.xstream.io.StreamException:
Environment:
OS: Windows Server 2012
OS Version: N/A
Cause:
Cause type:
Defect
Root Cause: Password that contains non-escaped XML special characters will cause a XML reading exception.
Resolution:
Update to a fix version listed below or a newer version if available.

Fix Status: Released

Fix Version(s):
LDAPSync 2.1.0 – Available
LDAPSync 2.0.2 – Available
LDAPSync 1.0.8 – Available
Additional Information:
Workaround :
It is necessary to use XML escape characters in the LDAPSync.xml file.

Example:


If you need to include the character "&" then you need to use "&".  Following are additional XML escape characters and what should be defined  in the LDAPSync.xml file if you want to use them.
 
" Use " 
' Use ' 
< Use &lt; 
> Use &gt; 
& Use &amp;