summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorDeAndre Harris <dharris@gitlab.com>2019-02-15 11:30:54 +0000
committerMarcia Ramos <marcia@gitlab.com>2019-02-15 11:30:54 +0000
commit89431a9f96469f0fd70f882995b44d38e36cfd3f (patch)
tree1ecc1f69759fce6f3f010574e2033e9e796ca7ca
parent88c3358be22923c9e302383d8a3ac8fd2b957d45 (diff)
downloadgitlab-ce-89431a9f96469f0fd70f882995b44d38e36cfd3f.tar.gz
Add troubleshooting steps for "local issuer certificate" error
-rw-r--r--doc/user/project/integrations/webhooks.md9
1 files changed, 9 insertions, 0 deletions
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