Managing Digital Signature

Digital Signature

The digital signature feature allows a user to digitally sign the email and confirms the authenticity of the sender. Digital signature is available only for on premise customers.

To enable digital signature feature:

1. Open the networking.properties file available in {install_dir}/profiles/LJP/configuration/tomcat/conf/RN/networking.properties
2. Add the following configuration entries in the networking.properties file.

A. keystoreFile: specifies the certificate used to digitally sign the mails sent by AgileApps.

Value: keystoreFile=/{install_dir}/profiles/LJP/configuration/tomcat/conf/RN/thirdParty

B. keystorePass: specifies the password to access the keystore.

Value: keystorePass=<key_pass>

C. digiSignEmailKeyAlias: specifies the key alias in the digital signature certificate.

Value: digiSignEmailKeyAlias=<key_alias>

D. digitally_sign_email_enabled: used to enable digital signature for the emails which are sent by AgileApps.

Value: digitally_sign_email_enabled=1

E. digitally_sign_digest_algorithm: used to select a valid digest algorithm. Supported algorithms are DIGEST_SHA1, DIGEST_MD5, DIGEST_SHA256, DIGEST_SHA384, and DIGEST_SHA512. The default algorithm is DIGEST_SHA512.

Value: digitally_sign_digest_algorithm=DIGEST_SHA512

F. passmanConfigFile: specifies the file path of the configuration file that is used for securing keystore password of the certificate

Value: passmanConfigFile=/{install_dir}/profiles/LJP/configuration/tomcat/conf/RN/agileappsPassMan.config.xml

3. Copy the file agileappsPassMan.config.xml to /{install_dir}/profiles/LJP/configuration/tomcat/conf/RN.

4. Replace the JAR file com.softwareag.ljp.dbc.fragment_10.7.0.0000-702888.jar under /{install_dir}/common/runtime/bundles/ljp/eclipse/plugins with the new JAR provided for upgrade at ftp://ftp.longjump.com/patches/AAL-<patch_version> /AAL-<patch_version>.tar.gz. Back up the existing jar file before replacing.

5. Copy the JAR file bcprov_1.52.1.jar to /{install_dir}/common/runtime/bundles/platform/eclipse/plugins.

6. Open the file bundles.info located at /{install_dir}/profiles/LJP/configuration/org.eclipse.equinox.simpleconfigurator.

7. Edit the bcprov JAR version from 1.52.0 to 1.52.1 in the line:

bcprov,1.52.0,../../common/runtime/bundles/platform/eclipse/plugins/bcprov_1.52.0.jar,4, true

8. Copy the JAR file bcmail-jdk16-1.40.jar to /{install_dir}/AgileApps/lib.

9. Copy the JAR file wm-g11nutils.jar to /{install_dir}/AgileApps/lib.

Note: Steps 3 to 9 are applicable to the users or customers upgrading from an older version of AgileApps to 10.7.7 or higher.