/doc/integration/README.md
Markdown | 63 lines | 43 code | 20 blank | 0 comment | 0 complexity | baa6736fe1f0f80af280c54c976fa20d MD5 | raw file
- # GitLab Integration
- GitLab integrates with multiple third-party services to allow external issue
- trackers and external authentication.
- See the documentation below for details on how to configure these services.
- - [Jira](../project_services/jira.md) Integrate with the JIRA issue tracker
- - [External issue tracker](external-issue-tracker.md) Redmine, JIRA, etc.
- - [LDAP](ldap.md) Set up sign in via LDAP
- - [Jenkins](jenkins.md) Integrate with the Jenkins CI
- - [OmniAuth](omniauth.md) Sign in via Twitter, GitHub, GitLab.com, Google, Bitbucket, Facebook, Shibboleth, SAML, Crowd and Azure
- - [SAML](saml.md) Configure GitLab as a SAML 2.0 Service Provider
- - [CAS](cas.md) Configure GitLab to sign in using CAS
- - [Slack](slack.md) Integrate with the Slack chat service
- - [Kerberos](kerberos.md) Integrate with Kerberos
- - [OAuth2 provider](oauth_provider.md) OAuth2 application creation
- - [Gmail actions buttons](gmail_action_buttons_for_gitlab.md) Adds GitLab actions to messages
- - [reCAPTCHA](recaptcha.md) Configure GitLab to use Google reCAPTCHA for new users
- - [Akismet](akismet.md) Configure Akismet to stop spam
- GitLab Enterprise Edition contains [advanced Jenkins support][jenkins].
- [jenkins]: http://doc.gitlab.com/ee/integration/jenkins.html
- ## Project services
- 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
- ## 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
- ```