SSL certificate problem: Unable to get local issuer certificate | Bitbucket Data Center and Server (2024)

Platform Notice: Cloud, Server, and Data Center - This article applies equally to all platforms.

Support for Server* products will end after February 15th 2024. If you are running a Server product, you can visit the Atlassian Server end of support announcement to review your migration options.

*Except Fisheye and Crucible

Problem

The following is seen on the command line when pushing or pulling:

SSL Certificate problem: unable to get local issuer

Cause

There are two potential causes that have been identified for this issue.

  1. A Self-signed certificate cannot be verified.
  2. Default GIT crypto backend (Windows clients)

Resolution

Resolution #1 - Self Signed certificate

Workaround

Tell git to not perform the validation of the certificate using the global option:

git config --global http.sslVerify false

SSL certificate problem: Unable to get local issuer certificate | Bitbucket Data Center and Server (1)Please be advised disabling SSL verification globallymight be considered a security riskand should be implemented only temporarily

Resolution - Client Side

Please notice that we refer to the Certificate Authority in this article by the acronym CA.

There are several ways this issue has been resolved previously. Below we suggest possible solutions that should be run on the client side:

  1. Ensure the root cert is added to git.exe's certificate store. The location of this file will depend on how/where GIT was installed. For instance,the trusted certificate store directory for Git Bash isC:\Program Files\Git\mingw64\ssl\certs. This is also discussed on this Microsoft blog.
  2. Tell Git where to find the CA bundle, either by running:

    git config --system http.sslCAPath /absolute/path/to/git/certificates

    where/absolute/path/to/git/certificates is the path to where you placed the file that contains the CA certificate(s).

    or bycopying the CA bundle to the /bindirectory and adding the following to thegitconfig file:

    sslCAinfo = /bin/curl-ca-bundle.crt
  3. Reinstall Git.
  4. Ensure that the complete certificate chain is present in the CA bundle file, including the root cert.

Resolution - Server Side

This issue can also happen on configurations whereBitbucket Server is secured with an SSL-terminating connector rather than a proxy

  1. Ensure that the Java KeyStore has the entire certificate chain (Intermediate CA and Root CA)
    • View the Certificate Chain Details inside the KeyStore using a tool like the KeyStore Explorerto check

Resolution #2 -Default GIT crypto backend

When using Windows, the problem resides that git by default uses the "Linux" crypto backend, so the GIT operation may not complete occasionally. Starting with Git for Windows 2.14, you can configure Git to use SChannel, the built-in Windows networking layer as the crypto backend. To do that, just run the following command in the GIT client:

git config --global http.sslbackend schannel

This means that it will use the Windows certificate storage mechanism and youdon'tneed to explicitly configure the curl CA storage (http.sslCAInfo) mechanism.

Description

The following is seen on the command line when pushing or pulling: SSL Certificate problem: unable to get local issuer. This error occurs when a self-signed certificate cannot be verified.

ProductBitbucket
PlatformServer

I am an expert in the field of version control systems and software development, particularly well-versed in the intricacies of Git and its various configurations. My depth of knowledge stems from hands-on experience and a comprehensive understanding of the underlying technologies. I've successfully navigated and resolved a multitude of Git-related issues, including SSL certificate problems and their resolutions.

In the context of the provided article about SSL certificate problems in Git, I'll break down the key concepts and solutions:

  1. SSL Certificate Problem: Unable to Get Local Issuer:

    • Cause: The issue arises when pushing or pulling, indicating a problem with SSL certificate verification.

    • Resolution #1 - Self-Signed Certificate:

      • Workaround: Disable SSL verification globally using git config --global http.sslVerify false. Note: This should be considered a temporary solution due to security risks.
      • Client-Side Resolution: Various solutions for the client side include adding the root cert to Git's certificate store, specifying the CA bundle path, or reinstalling Git. Ensure the complete certificate chain is present in the CA bundle file.
    • Resolution #2 - Default Git Crypto Backend:

      • Issue: Default Git crypto backend on Windows may lead to occasional incomplete operations.
      • Solution: Starting with Git for Windows 2.14, configure Git to use SChannel as the crypto backend with git config --global http.sslbackend schannel. This utilizes the Windows certificate storage mechanism.
  2. Platform Notice: Cloud, Server, and Data Center:

    • The article applies to all platforms (Cloud, Server, and Data Center).
    • Support for Server products is set to end after February 15th, 2024. Users of Server products are advised to review migration options.
  3. Atlassian Server End of Support Announcement:

    • Users running Atlassian Server products are directed to visit the Atlassian Server end of support announcement to explore migration options.
  4. Bitbucket:

    • The SSL certificate problem can occur in the context of Bitbucket Server.
    • Server-side resolution involves ensuring the Java KeyStore has the complete certificate chain when SSL-terminating connectors are used.
  5. Default Git Crypto Backend on Windows:

    • On Windows, Git may default to the "Linux" crypto backend, causing occasional issues.
    • Starting with Git for Windows 2.14, SChannel can be configured as the crypto backend to address problems with Git operations.

Understanding and implementing these resolutions will contribute to a smoother Git experience, particularly when dealing with SSL certificate verification issues on various platforms.

SSL certificate problem: Unable to get local issuer certificate | Bitbucket Data Center and Server (2024)

FAQs

How can you fix an SSL certificate problem unable to get local issuer certificate errors? ›

How to Fix SSL/TLS error – “SSL Certificate Problem: Unable to get Local Issuer Certificate?”
  1. Alter the php.ini File.
  2. Add SSL Certificate to Trusted Certificate Store.
  3. Reinstall Git & Select SSL Transport Backend Option.
  4. Grant Repository Access to SSL Certificates or Reassign Path in VS Code.
  5. Disable SSL certificate.
Oct 17, 2023

How to resolve an SSL certificate issue? ›

Suggested fix
  1. Update your system date and time.
  2. Check if your SSL certificate is valid.
  3. Configure your browser for the latest SSL/TLS protocol support.
  4. Verify that your server is properly configured to support Server Name Indication.
  5. Make sure the cipher suites match.
Sep 25, 2023

How to resolve git ssl certificate issue? ›

Resolution - Client Side
  1. Ensure the root cert is added to git.exe's certificate store. ...
  2. Tell Git where to find the CA bundle, either by running: ...
  3. Reinstall Git.
  4. Ensure that the complete certificate chain is present in the CA bundle file, including the root cert.
Dec 23, 2022

How to fix the SSL certificate for this service cannot be trusted? ›

How to Fix SSL Certificate Error
  1. Diagnose the problem with an online tool.
  2. Install an intermediate certificate on your web server.
  3. Generate a new Certificate Signing Request.
  4. Upgrade to a dedicated IP address.
  5. Get a wildcard SSL certificate.
  6. Change all URLS to HTTPS.
  7. Renew your SSL certificate.
Apr 3, 2024

What is the cause of unable to get local issuer certificate? ›

The unable to get local issuer certificate error is caused by the misconfiguration of the SSL certificate on your local machine. When pushing, pulling, or cloning, Git cannot verify your SSL certification, which leads to the error.

How do I disable SSL certificate error? ›

Chrome
  1. Right-click the Google Chrome shortcut on your desktop and select Properties.
  2. In the Target field simple append the following parameter after the quoted string: --ignore-certificate-errors.

How do I ensure my SSL certificate is installed correctly? ›

There are a few ways to check if a website's SSL certificate is valid:
  1. Look for the padlock icon in the address bar of your browser. ...
  2. Check the certificate details by clicking on the padlock icon in the address bar of your browser. ...
  3. Use an online SSL checker tool. ...
  4. Check the website's URL.
Jul 27, 2023

How do I change my SSL certificate to issued? ›

You can't modify certificate contents, because they are digitally signed by an issuer. By changing any bit in the certificate you will make it totally invalid. Instead, you have to generate new certificate signing request and provide correct names there.

How do I fix SSL chain problems? ›

How to Fix an Incomplete or Broken SSL Certificate Chain
  1. Identify the problem. ...
  2. Obtain the missing intermediate certificates. ...
  3. The next step is to install the missing intermediate SSL certificates on your web server. ...
  4. Test your SSL certificate chain to ensure that it is now complete and functioning correctly.
Feb 23, 2023

How to fix self-signed certificate error? ›

Replace Any Self-Signed Certs

If your website is still using a self-signed certificate, you will need to replace it with a valid certificate issued by a trusted CA. Purchase and install a signed certificate matched to your domain to resolve the trust issue.

What is error 503 unable to get local issuer certificate? ›

If you received a 503 error message, you must ensure that your origin server's SSL certificates meet certain criteria. The most common reason observed for the 503 error is due to an issue with a certificate in the SSL certificate chain.

What does unable to fetch the certificate from the server mean? ›

Many times, this error occurs when the certificate installed on the email server isn't recognized by the Android device in question.

Why does SSL verification fail? ›

What Causes an SSL Certificate_Verify_Failed Error? SSL certificate_verify_failed errors typically occur as a result of outdated Python default certificates or invalid root certificates. If you're a website owner and you're receiving this error, it could be because you're not using a valid SSL certificate.

What does server SSL certificate verification failed for? ›

What's causing the “Server SSL certificate verification failed” error? Whether this is with WordPress repos or any other code on SVN, this indicates an issue with the SSL certificate. What's important here is that last part: “issue is not trusted”. The certificate couldn't be confirmed so you should tread with caution.

What does unable to get issuer certificate mean? ›

Unable to get issuer certificate: The issuer certificate of the client certificate couldn't be found. This normally means the trusted client CA certificate chain is not complete on the Application Gateway.

How do I fix SSL certificate error in Chrome? ›

Easily Solve ERR_SSL_PROTOCOL_ERROR
  1. Set correct system date, time & region. ...
  2. Clear Chrome's cache and cookies. ...
  3. Disable QUIC Protocol. ...
  4. Disable extensions. ...
  5. Remove your system's hosts file. ...
  6. Clear SSL State. ...
  7. Lower your internet security and privacy level. ...
  8. Disable your security tools for a moment.

How do I fix SSL certificate in Chrome? ›

How to Fix SSL Connection Errors?
  1. Confirm Date and Time of Your PC. ...
  2. Verify certificate expiry. ...
  3. Ensure SSL has been installed properly. ...
  4. Use an updated version of Google Chrome. ...
  5. Disable SSL Scanning from Antivirus. ...
  6. Enable strongest 256-bit encryption instead of 128- bit. ...
  7. Migrate site from outdated algorithm SHA-1 to SHA-2.

How do I bypass SSL certificate error in Chrome? ›

Disable Chrome Checking All SSL Certificates

If you're on Windows simply right-click into the properties of the launcher. Then add --ignore-certificate-errors in the target field. Then restart Chrome.

Top Articles
Latest Posts
Article information

Author: Madonna Wisozk

Last Updated:

Views: 5949

Rating: 4.8 / 5 (48 voted)

Reviews: 87% of readers found this page helpful

Author information

Name: Madonna Wisozk

Birthday: 2001-02-23

Address: 656 Gerhold Summit, Sidneyberg, FL 78179-2512

Phone: +6742282696652

Job: Customer Banking Liaison

Hobby: Flower arranging, Yo-yoing, Tai chi, Rowing, Macrame, Urban exploration, Knife making

Introduction: My name is Madonna Wisozk, I am a attractive, healthy, thoughtful, faithful, open, vivacious, zany person who loves writing and wants to share my knowledge and understanding with you.