From 89431a9f96469f0fd70f882995b44d38e36cfd3f Mon Sep 17 00:00:00 2001 From: DeAndre Harris Date: Fri, 15 Feb 2019 11:30:54 +0000 Subject: Add troubleshooting steps for "local issuer certificate" error --- doc/user/project/integrations/webhooks.md | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/doc/user/project/integrations/webhooks.md b/doc/user/project/integrations/webhooks.md index 60a4c6aaf64..5a827d8ae15 100644 --- a/doc/user/project/integrations/webhooks.md +++ b/doc/user/project/integrations/webhooks.md @@ -1228,6 +1228,15 @@ by uncommenting or adding the following setting to your `/etc/gitlab/gitlab.rb`: gitlab_rails['webhook_timeout'] = 10 ``` +### Troubleshooting: "Unable to get local issuer certificate" + +When SSL verification is enabled, this error indicates that GitLab isn't able to verify the SSL certificate of the webhook endpoint. +Typically, this is because the root certificate isn't issued by a trusted certification authority as +determined by [CAcert.org](http://www.cacert.org/). + +Should that not be the case, consider using [SSL Checker](https://www.sslshopper.com/ssl-checker.html) to identify faults. +Missing intermediate certificates are a commong point of verification failure. + ## Example webhook receiver If you want to see GitLab's webhooks in action for testing purposes you can use -- cgit v1.2.1