README.md 3.13 KB
Newer Older
1 2 3 4
---
comments: false
---

Drew Blessing's avatar
Drew Blessing committed
5 6
# GitLab Integration

7 8
GitLab integrates with multiple third-party services to allow external issue
trackers and external authentication.
9

Drew Blessing's avatar
Drew Blessing committed
10 11
See the documentation below for details on how to configure these services.

Marcia Ramos's avatar
Marcia Ramos committed
12 13 14 15 16
- [Akismet](akismet.md) Configure Akismet to stop spam
- [Auth0 OmniAuth](auth0.md) Enable the Auth0 OmniAuth provider
- [Bitbucket](bitbucket.md) Import projects from Bitbucket.org and login to your GitLab instance with your
Bitbucket.org account
- [CAS](cas.md) Configure GitLab to sign in using CAS
17
- [External issue tracker](external-issue-tracker.md) Redmine, JIRA, etc.
Marcia Ramos's avatar
Marcia Ramos committed
18 19
- [Gmail actions buttons](gmail_action_buttons_for_gitlab.md) Adds GitLab actions to messages
- [JIRA](../user/project/integrations/jira.md) Integrate with the JIRA issue tracker
20
- [LDAP](ldap.md) Set up sign in via LDAP
21
- [OAuth2 provider](oauth_provider.md) OAuth2 application creation
Marcia Ramos's avatar
Marcia Ramos committed
22
- [OmniAuth](omniauth.md) Sign in via Twitter, GitHub, GitLab.com, Google, Bitbucket, Facebook, Shibboleth, SAML, Crowd, Azure and Authentiq ID
23
- [OpenID Connect](openid_connect_provider.md) Use GitLab as an identity provider
24
- [PlantUML](../administration/integration/plantuml.md) Configure PlantUML to use diagrams in AsciiDoc documents.
Marcia Ramos's avatar
Marcia Ramos committed
25 26 27
- [reCAPTCHA](recaptcha.md) Configure GitLab to use Google reCAPTCHA for new users
- [SAML](saml.md) Configure GitLab as a SAML 2.0 Service Provider
- [Trello](trello_power_up.md) Integrate Trello with GitLab
dosire's avatar
dosire committed
28

29
> GitLab Enterprise Edition contains [advanced Jenkins support][jenkins].
30

Sytse Sijbrandij's avatar
Sytse Sijbrandij committed
31 32
## Project services

33 34 35
Integration with services such as Campfire, Flowdock, Gemnasium, HipChat,
Pivotal Tracker, and Slack are available in the form of a [Project Service][].

36
[Project Service]: ../user/project/integrations/project_services.md
37

38
## SSL certificate errors
39

40 41 42 43 44 45 46 47 48 49 50 51 52
When trying to integrate GitLab with services that are using self-signed certificates,
it is very likely that SSL certificate errors will occur on different parts of the
application, most likely Sidekiq. There are 2 approaches you can take to solve this:

1. Add the root certificate to the trusted chain of the OS.
1. If using Omnibus, you can add the certificate to GitLab's trusted certificates.

**OS main trusted chain**

This [resource](http://kb.kerio.com/product/kerio-connect/server-configuration/ssl-certificates/adding-trusted-root-certificates-to-the-server-1605.html)
has all the information you need to add a certificate to the main trusted chain.

This [answer](http://superuser.com/questions/437330/how-do-you-add-a-certificate-authority-ca-to-ubuntu)
Ben Bodenmiller's avatar
Ben Bodenmiller committed
53
at Super User also has relevant information.
54 55 56

**Omnibus Trusted Chain**

57 58 59 60 61
[Install the self signed certificate or custom certificate authorities](http://docs.gitlab.com/omnibus/common_installation_problems/README.html#using-self-signed-certificate-or-custom-certificate-authorities)
in to GitLab Omnibus.

It is enough to concatenate the certificate to the main trusted certificate
however it may be overwritten during upgrades:
62 63 64 65 66 67 68 69 70 71

```bash
cat jira.pem >> /opt/gitlab/embedded/ssl/certs/cacert.pem
```

After that restart GitLab with:

```bash
sudo gitlab-ctl restart
```
72 73

[jenkins]: http://docs.gitlab.com/ee/integration/jenkins.html