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

Products

• CA Automic Workload Automation - Automation Engine

Issue/Introduction

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;