BigW Consortium Gitlab

README.md 2.43 KB
Newer Older
1 2
# GitLab Integration

3 4
GitLab integrates with multiple third-party services to allow external issue
trackers and external authentication.
5

6 7
See the documentation below for details on how to configure these services.

8
- [JIRA](jira.md) Integrate with the JIRA issue tracker
9 10
- [External issue tracker](external-issue-tracker.md) Redmine, JIRA, etc.
- [LDAP](ldap.md) Set up sign in via LDAP
11
- [OmniAuth](omniauth.md) Sign in via Twitter, GitHub, GitLab.com, Google, Bitbucket, Facebook, Shibboleth, SAML, Crowd and Azure
12
- [SAML](saml.md) Configure GitLab as a SAML 2.0 Service Provider
Douwe Maan committed
13
- [CAS](cas.md) Configure GitLab to sign in using CAS
14
- [OAuth2 provider](oauth_provider.md) OAuth2 application creation
15
- [Gmail actions buttons](gmail_action_buttons_for_gitlab.md) Adds GitLab actions to messages
16
- [reCAPTCHA](recaptcha.md) Configure GitLab to use Google reCAPTCHA for new users
17 18
- [Akismet](akismet.md) Configure Akismet to stop spam
- [Koding](../administration/integration/koding.md) Configure Koding to use IDE integration
dosire committed
19

20
GitLab Enterprise Edition contains [advanced Jenkins support][jenkins].
21

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


25 26
## Project services

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

30
[Project Service]: ../project_services/project_services.md
31

32
## SSL certificate errors
33

34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61
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)
at SuperUser also has relevant information.

**Omnibus Trusted Chain**

It is enough to concatenate the certificate to the main trusted certificate:

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

After that restart GitLab with:

```bash
sudo gitlab-ctl restart
```