BigW Consortium Gitlab

README.md 2.41 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](../project_services/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
- [Slack](slack.md) Integrate with the Slack chat service
15
- [OAuth2 provider](oauth_provider.md) OAuth2 application creation
16
- [Gmail actions buttons](gmail_action_buttons_for_gitlab.md) Adds GitLab actions to messages
17
- [reCAPTCHA](recaptcha.md) Configure GitLab to use Google reCAPTCHA for new users
18
- [Akismet](akismet.md) Configure Akismet to stop spam
dosire committed
19

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

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


25 26
## Project services

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

[Project Service]: ../project_services/project_services.md
31 32 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

## SSL certificate errors

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
```