Skip to main content
Contiem Connect

Resolving Unknown Certificate Check Failure

This troubleshooting topic guides you through resolving the “unknown certificate check failure” error when connecting to a Git source control provider.

Symptoms

When a user tries to connect to a Git repository as a source control provider, the following message appears in the Source Control Server Connection dialog:

unknown certificate check failure

This error occurs during the certificate validation process.

Cause

The HelpStudio does not trust the SSL certificate provided by the Git server. This occurs when the Git server's SSL certificate is not added to the system's Trusted Root Certification Authorities store.

Resolution

To resolve this issue, add the Git server's SSL certificate to the Trusted Root Certification Authorities on your system. Follow these steps:

  1. Test the Source control Connection:
    1. Open the HelpStudio application.
    2. On the Source Control tab, select Integration Preferences.
    3. Select the Source control option.
    4. Select Git as the Source Control Provider.
    5. Enter your Git server connection details in the Server field. For example, https://xxx.xxx.xxx.xxx/root/hss-gitrepo.git.
    6. Select Test Source Control Connection.
         The Source Control Server Connection dialog appears with the “unknown certificate check failure” message.
    7. Select OK.
  1. Export the certificate:
    1. Open a browser and navigate to your Git repository URL. For example, https://xxx.xxx.xxx.xxx/root/hss-gitrepo.git.
    2. Select Not secure next to the URL to view the site information.
    3. Select Certificate details.
    4. In the Certificate Viewer dialog, select the Details tab.
    5. Select Export.
    6. Save the certificate file (For example, xxx.xxx.x.xxx.crt) to your local system.
  1. Import the certificate:
    1. Open Manage user certificates.
          The Certmgr - [Certificates - Current User] window opens.
    2. Expand Trusted Root Certification Authorities.
    3. Select Certificates.
    4. Select Action > All Tasks > Import.
      Certmgr

      Certmgr


         The Certificate Import Wizard dialog opens.
    5. Select Next.
    6. Select Browse.
    7. Select the certificate file you saved earlier and select Open.
    8. Select Next.
      Ensure that the Certificate store is selected as Trusted Root Certification Authorities.
    9. Select Finish.
    10. On the Security Warning dialog, select Yes.
         The message “Import was successful” appears once the import is complete.
  1. Retest the Source Control connection:
    1. Open the HelpStudio application.
    2. On the Source Control tab, select Integration Preferences.
    3. Select Source control option.
    4. Select Git as the Source Control Provider.
    5. Enter your Git server connection details in the Server field.
    6. Select Test Source Control Connection.

Conclusion

Following these steps resolves the issue and allows you to connect to the Git repository successfully without the certificate error.

Top of page