Frustrated by the lack of documentation by Adventnet on this topic, I decided to dig into and discover the proper procedure on installing an SSL certificate that would work for their ADManagerPlus application. Having some previous experience with Java certificate stores, I used that knowledge to complete the task. If you are like me, I tried to use Adventnet’s documentation but kept getting stuck on how to embed the Root CA correctly (knowing this from the fact that https revealed an untrusted certificate!). This is the process I followed to get ADManagerPlus working with our private Root CA…
- Shutdown ADMangerPlus if it is currently running
- Open a command prompt and navigate to C:\AdventNet\ADManagerPlus\jre\bin
- Execute the following command:keytool -genkey -alias tomcat -keyalg RSA -keystore admp.keystore
- Enter a keystore password. Instead of “your name”, use the FQDN of the server that ADManagerPlus runs on. If a typo is entered just hit CTRL+C to kill the process and the keystore will not be created (until the very end). If at the end and the keystore is fubar’d just delete and start over.
- Execute the following command:
keytool -certreq -keyalg RSA -alias tomcat -file certkey.txt -keystore admp.keystore
- Enter the keystore password from step 4.
- In steps 8-13, access the private CA with domain admin credentials or higher in order to view server-based certificates, otherwise only user based certificates will be available (user, basic EFS).
- Open Internet Explorer (using domain admin privileges) and select the private CA address (http://mycertserver/certsrv where mycertserver is the Windows server hosting Certificate Services).
- Next, get a copy of the Root CA and save it to the same path as seen in the command prompt: Select the link “Download a CA certificate, certificate chain, or CRL” then select “Download CA certificate” and save it (certnew.cer) to C:\AdventNet\ADManagerPlus\jre\bin.
- Next, request a certificate from the CA. The easiest way to do this is to just hit the “back” button in Internet Explorer. Select “Request a certificate” and then “advanced certificate request”.
- Now select “ Submit a certificate request by using a base-64-encoded CMC or PKCS #10 file, or submit a renewal request by using a base-64-encoded PKCS #7 file.”
- Now open the certkey.txt file (from step 5) and copy and paste the contents into the first text box. Next, under ” Certificate Template” select “Web Server” and then click the Submit button at the bottom.
- The page will now present download links to the certificate. Select the “Download certificate chain” link and save the file (certnew.p7b) to C:\AdventNet\ADManagerPlus\jre\bin.
- Now go back to the command prompt and execute the following command:keytool -import -alias tomcat -keystore admp.keystore -trustcacerts -file certnew.p7b
- It is requisite that the private CA’s root certificate is added to the list of trusted CAs in the Java cacerts file. The Java cacerts file uses the standard changeit password for access. Type the following command (selecting any desired alias name):keytool -import -alias admpcacert -keystore ..\lib\security\cacerts -file certnew.cer
- Verify the certificate signing by entering the following command:
keytool -list -v -keystore admp.keystore -storepass password (password from step 4)
Two certificates should be listed, the first being the ADManagerPlus web server certificate and the second being the Root CA certificate. Syntax will be as follows:
Entry type: keyEntry
Certificate chain length: 2
If the certificate chain length is 1, go back through the steps to determine potential errors. Do not proceed with these final four steps or the ADManagerPluse server service will hang (and lock) at startup.
- Once the certificate signing is verified, open Windows Explorer and rename both the server.xml (to serverxml.old) file and the server.keystore (to serverkeystore.old) file in the C:\AdventNet\ADManagerPlus\conf directory.
- Now copy the admp.keystore file from C:\AdventNet\ADManagerPlus\jre\bin in to C:\AdventNet\ADManagerPlus\conf directory.
- Edit the server.xml file from C:\AdventNet\ADManagerPlus\conf using any text editor. Scroll to the bottom of the file and look for the line that begins with “<Connector acceptCount”.
- Scroll to the section of the line that says “keystoreFile=”./conf/server.keystore” keystorePass=”adventnet” . Change the server.keystore to admp.keystore and change the password to match the one set in step 4. Save and close the file.
That completes both the Root CA installation and the certificate keystore installation. Re-start ADManagerPlus service and access the FQDN of the ADManagerPlus server via web browser.