We have renewed our Adapt Desktop Agent certificates that are due to expire in April. Please follow the instructions in this article to add the new certificates and ensure every Adapt user accepts the new certificate when logging in.
What is this Certificate for?
This ensures a secure connection for the Adapt Desktop Agent which enables users to open/download documents via Adapt.
Why is it being renewed?
Every certificate has an expiry date, ours is due in April. We want to ensure there is no user impact.
As a system administrator, what do I need to do?
Contact Adapt Support on 01903 707007 or email AdaptUKSupport@Bullhorn.com for copies of the new certificates if you don't already have them.
Remove old ADA certificates for the Adapt application server:
The first step will be to remove the old certificates from the following location on your Adapt application server: **AdaptFolder**\ADAPTV11-JBOSS\DEPLOY\adaptv11.ear\adaptv11.war\Resources\ADAInstallers
The 2 files we want to remove from that location and temporarily place elsewhere (as backup copies) are ca.cer and localhost.pfx. For now please don’t delete these files. Place them in a secondary folder on the desktop so we may revert the changes if required.
Add the new certificates:
Now that the old certificates are removed we can place the new CA and localhost certificates into the same location we removed the old ones from. **AdaptFolder**\ADAPTV11-JBOSS\DEPLOY\adaptv11.ear\adaptv11.war\Resources\ADAInstallers
Actions users need to take:
We would recommend you communicate these steps to all Adapt users so they are aware of this update and how to activate it.
Follow the below steps:
Upon the first login after the certificates have been applied to your application server, you will receive the following message:
Please ensure you click Yes to accept the new certificate.
All done, ADA should now continue to work as normal.
If a user selects No, what do I need to do?
If a user were to click No on the prompt above, then ADA would not be able to connect. In order to get the prompt to reappear, the user will have to log out of Adapt and log back in. If this does not work then we recommend they clear their browser cache using the instructions below:
Clear cookies and cache:
Open browser settings or use shortcut Ctrl+Shft+Delete
Go back to the Privacy and Security section
Click "Clear browsing data"
In the drop-down, select "All Time"
Make sure the boxes are checked on "Cached images and files" and "Cookies and other site data" (Some boxes are checked by default; only these two need to be checked. Users can uncheck the others if they wish)
Click "Clear browsing data"
Closeout of all Chrome windows/tabs
Restart the browser.
Once this is done the same Certificate prompt will reappear, the user will then need to click Yes to install the certificate.
Firefox users
Unlike Chrome, Firefox uses its own certificate store and will require the new certificates to be manually updated.
To do this open Firefox and click the 3 horizontal lines in the top right and then head to settings:
When in Firefox Settings head to “Privacy and Security” then scroll down to “View Certificates”:
You can also type “cert” into the “find in setting box” and this will do a highlighted search in settings:
Within the Certificates pop-up, ensure you select the “Authorities” tab and press Import:
Navigate to the ADA certificate location, and ensure the file type selected is “Certificate Files”.
Find the “ca.cer” file and select Open:
In the popup, ensure you tick both of the “trust” boxes and press OK.
Then press the Import button again and this time change the file type to “All Files''.
Find the Localhost.pfx. file and select Open:
This process will apply the certificates to Firefox at which point you should be able to restart Firefox and Log into Adapt.
To test the connection, try opening a CV from a Candidate record and this should open the files on the corresponding application.
Still having issues?
Please contact Bullhorn for Adapt Support on 01903 707007 or email AdaptUKSupport@Bullhorn.com