Sitecore install local SSL certificate for shared xConnect SOLR server

In Sitecore 9, the SOLR connection is secure by default. The effect is that if your development environment includes a shared SOLR server, your local IIS requires a SSL certificate issued for that server, even when your local site does not run HTTPS.

This makes installing a local dev environment a little but more complicated, which is why my colleague Kristian Gansted made this guide for me:

STEP 1: GET THE SSL CERTIFICATE FOR THE SOLR SSL SERVER

DevOps should provide you with the appropriate .pfx file.
Double click the file and follow the guide:

STEP 2: USE THE CERTIFICATE IMPORT WIZARD TO INSTALL THE CERTIFICATE

Select the Local Machine and click next:

Certificate Import Wizard

Certificate Import Wizard – Select the Local Machine

On the “File to Import“, the file name is already chosen so just click next, and go the “Private key protection“. Do not select a password, just click “Next”:

No Password

Do not select a password. Just click Next

In the Certificate Store, click “Browse…” and select the “Personal” store:

Certificate Store

Select “Personal” store

Click “Next” and click “Finish”. The certificate is now installed.

The import was successful

The import was successful

STEP 3: ALLOW AppPool ACCESS TO THE CERTIFICATE

Find the “Manage computer certificates” control panel:

Manage Computer Certificates

Manage Computer Certificates

Find the certificate under the “Personal” certificates, right click and find the “Manage Private Keys…” under “All Tasks“:

Certificates

Find the certificate, right click and find Manage Private Keys under “All tasks”

Press “Add” (1) to add a new user.
Press “Locations” (2) and select the machine to search in the correct location.

Select the correct location

Select the correct location

Then type “IIS APPPOOL/[name of IIS site]”:

Select User

Select IIS APPPOOL\[name of iis site]

Give the user full control.

Your IIS site is now ready to access the SOLR server.

MORE TO READ:

About briancaos

Developer at Pentia A/S since 2003. Have developed Web Applications using Sitecore Since Sitecore 4.1.
This entry was posted in Sitecore 9 and tagged , , , . Bookmark the permalink.

Leave a comment

This site uses Akismet to reduce spam. Learn how your comment data is processed.