How to Encrypt Server Configuration Passwords


Applicable Ephesoft versions: and above

This feature is used to generate encrypted username and password, and update in the properties file.



1. Download Server Password Encryptor

2. Before executing the Encryptor.bat file. Please configure the following properties:
set JAVA_HOME=C:\Program Files\Java\jdk1.6.0_18\ set EPHESOFT_LIBRARY_PATH=C:\dcma\WEB-INF\lib set JAR_NAME=ephesoft.jar set CLASS_NAME=com.ephesoft.dcma.encryption.core.PasswordEncryptor
3. After configuring the properties, now execute the “Encryptor.bat” file.




4. Now, enter the password to be encrypted:



5. Now press enter on the screen and the encrypted password will display as:



6. Now copy the generated encrypted password and paste in into the properties file.
You can follow the same method to generate encrypted username.


Following are the files that require encrypted password:

S.No. Property File Properties
1. Ephesoft\Application\WEB-INF\classes\META-INF\dcma-user-connectivity\ user.connectivity_password

If LDAP/AD is configured

2. Ephesoft\Application\WEB-INF\classes\META-INF\dcma-ftp\ ftp.server.password
3. Ephesoft\Application\WEB-INF\classes\META-INF\dcma-reporting\ ephesoft.loginusername



In, if encryption switch is set to ON then credentials must be encrypted. Use the credentials that have role which has access to the Ephesoft web services.

In server.xml, you can use plain text as well as encrypted passwords. You need to update:

NOTE: On setting {Ephesoft-application}\WEB-INF\classes\META-INF\dcma-encryption\ to password.use_encryption=true, the ftp.server.password also needs to be encrypted inside <Ephesoft>\Application\WEB-INF\classes\META-INF\dcma-ftp\ since password.use_encryption property is a global level check for encryption. You might encounter an error encrypted credentials are not used. For more information, see Decryption: Algorithm Parameter is Invalid – Error.


In order to enable encryption in the application, update the following property:

{Ephesoft-application}\WEB-INF\classes\META-INF\dcma-encryption\ to password.use_encryption=true


Frequently Asked Questions about Password Encryption