gitlab-org--gitlab-foss/doc/integration
Mike Lewis 07a9bdbfb4 Merge branch 'add_video_to_jira_int' into 'master'
Added links to Jira/Jenkins videos to supplement docs

See merge request gitlab-org/gitlab-ce!29516
2019-06-12 16:53:54 +00:00
..
img Docs: Remove all remaining orphaned images. 2019-05-17 19:21:48 +00:00
akismet.md Remove consecutive blank lines from markdown files 2019-02-18 09:36:13 +00:00
auth0.md Ensure all lists are surrounded by new lines 2019-02-22 13:17:10 +00:00
azure.md Fix most instances of bare URLs in markdown 2019-01-24 06:52:33 +00:00
bitbucket.md Alias GitHub and BitBucket OAuth2 callback URLs 2019-01-31 16:52:48 +01:00
cas.md Remove consecutive blank lines from markdown files 2019-02-18 09:36:13 +00:00
chat_commands.md Docs: Add automatic redirects to many moved files 2019-03-11 05:54:25 +00:00
crowd.md Docs: Add automatic redirects to many moved files 2019-03-11 05:54:25 +00:00
elasticsearch.md Remove docs for a removed ES rake task 2019-06-11 19:42:50 +01:00
external-issue-tracker.md Improve Youtrack documentation for style 2019-03-22 03:54:08 +00:00
facebook.md Ensure all lists are surrounded by new lines 2019-02-22 13:17:10 +00:00
github.md Revert "Merge branch 'patch-43' into 'master'" 2019-06-06 00:24:56 +00:00
gitlab.md Update/help integration screenshot 2018-06-06 16:43:36 +00:00
gmail_action_buttons_for_gitlab.md Make unordered lists conform to styleguide 2019-01-08 12:21:09 +10:00
google.md Remove documentation requiring activation of Google+ API 2018-12-29 00:19:16 -08:00
jenkins.md Streamline and edit video references 2019-06-12 15:58:38 +00:00
jenkins_deprecated.md Docs: Merge EE doc/​integration to CE 2019-05-05 12:04:54 +00:00
jira.md Docs: Add automatic redirects to many moved files 2019-03-11 05:54:25 +00:00
jira_development_panel.md Docs: Merge EE doc/​integration to CE 2019-05-05 12:04:54 +00:00
kerberos.md Docs: Merge EE doc/​integration to CE 2019-05-05 12:04:54 +00:00
ldap.md Docs: Add automatic redirects to many moved files 2019-03-11 05:54:25 +00:00
oauth2_generic.md Resolve "CE documentation is not CommonMark compliant" 2018-09-06 16:52:18 +00:00
oauth_provider.md Add more information and refactor format of topic 2019-01-11 15:38:15 +00:00
omniauth.md Remove from providers with icon 2019-05-07 13:51:34 +00:00
openid_connect_provider.md Don't hash user ID in OIDC subject claim 2018-06-28 15:31:47 +02:00
README.md Docs: Merge EE doc/​integration to CE 2019-05-05 12:04:54 +00:00
recaptcha.md Update recaptcha docs for clarity 2018-12-07 21:47:34 +00:00
salesforce.md Docs: Make wording familiar to Salesforce admins 2019-05-24 19:19:18 +00:00
saml.md Docs: Convert links in various docs to relative 2019-05-31 11:29:58 +00:00
shibboleth.md Fix markdown to render correctly 2018-11-20 16:41:01 +10:00
slack.md Docs: Add automatic redirects to many moved files 2019-03-11 05:54:25 +00:00
slash_commands.md Docs: Convert links in various docs to relative 2019-05-31 11:29:58 +00:00
trello_power_up.md Simple docs fixes 2017-10-23 14:11:51 +00:00
twitter.md Fix most instances of bare URLs in markdown 2019-01-24 06:52:33 +00:00
ultra_auth.md #57815 Omniauth UltraAuth strategy 2019-04-17 16:28:12 +05:30

comments
false

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.

  • Akismet Configure Akismet to stop spam
  • Auth0 OmniAuth Enable the Auth0 OmniAuth provider
  • Bitbucket Import projects from Bitbucket.org and login to your GitLab instance with your Bitbucket.org account
  • CAS Configure GitLab to sign in using CAS
  • External issue tracker Redmine, JIRA, etc.
  • Gmail actions buttons Adds GitLab actions to messages
  • Jenkins Integrate with the Jenkins CI
  • JIRA Integrate with the JIRA issue tracker
  • Kerberos Integrate with Kerberos
  • LDAP Set up sign in via LDAP
  • OAuth2 provider OAuth2 application creation
  • OmniAuth Sign in via Twitter, GitHub, GitLab.com, Google, Bitbucket, Facebook, Shibboleth, SAML, Crowd, Azure and Authentiq ID
  • OpenID Connect Use GitLab as an identity provider
  • PlantUML Configure PlantUML to use diagrams in AsciiDoc documents.
  • reCAPTCHA Configure GitLab to use Google reCAPTCHA for new users
  • SAML Configure GitLab as a SAML 2.0 Service Provider
  • Trello Integrate Trello with GitLab

GitLab Enterprise Edition contains advanced Jenkins support.

Project services

Integration with services such as Campfire, Flowdock, HipChat, Pivotal Tracker, and Slack are available in the form of a Project Service.

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.
  2. If using Omnibus, you can add the certificate to GitLab's trusted certificates.

OS main trusted chain

This resource has all the information you need to add a certificate to the main trusted chain.

This answer at Super User also has relevant information.

Omnibus Trusted Chain

Install the 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:

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

After that restart GitLab with:

sudo gitlab-ctl restart