Note: This applies to DocuShare 7.5 and higher versions
Note: If DocuShare has been upgraded in place on a server that has valid certificates installed into the dstruststore before the upgrade then they should be auto merged into the cacerts during the upgrade process.
DocuShare 7.5 and higher versions come with over 200 well known public certificates.
The only times when the SSL certificate needs to be imported into cacerts are these 2 limited cases:
1. A self-signed certificate that does not have a trusted root certificate and trust authority (this is not recommended)
2. A site that requires clients to use a Client certificate (and not a Server Certificate) to connect to their mail server, or other services like LDAP, EmailAgent that are not issued by Corretto11 trusted root CA.
To import a certificate into the DocuShare cacerts keystore:
1. Place a copy of the certificate (.cer) into the \jdk\conf\security directory.
2. Open a command prompt window and select Run as Administrator. This is done by right clicking the CMD application and choosing Run as Administrator.
3. From the command prompt window, type \jdk\bin\keytool -import -keystore \jdk\lib\security\cacerts -alias ldaps -file \jdk\conf\security\
Note: If you are prompted to enter a password you can leave blank and press enter or try the word changeit and press enter. Either one should work.
Example:
C:\Xerox\Docushare\jdk\bin\keytool -import -keystore C:\Xerox\Docushare\jdk\lib\security\cacerts -alias ldaps -file C:\Xerox\Docushare\jdk\conf\security\file.cer
4. Verify that the certificate imported correctly type the following command
\jdk\binkeytool -list -v -keystore \jdk\lib\security\cacerts
Example:
C:\Xerox\Docushare\jdk\binkeytool -list -v -keystore C:\Xerox\Docushare\jdk\lib\security\cacerts
You should see the certificate listed if it has been imported correctly.
Note: You can redirect the output to a file that can be reviewed use the following command:
\jdk\binkeytool -list -v -keystore \jdk\lib\security\cacerts cacertsoutput.txt
5. Restart DocuShare.