gitlab-org--gitlab-foss/doc/integration
James Lopez 140cb0c092 Merge branch 'fix/auth0-unsafe-login-10-6' into 'security-10-6'
[10.6] Fix GitLab Auth0 integration signs in the wrong user

See merge request gitlab/gitlabhq!2354
2018-03-21 14:43:47 +00:00
..
img add screenshots 2017-07-20 19:53:37 -03:00
README.md Exclude comments from specific docs 2017-11-01 15:56:40 +00:00
akismet.md Updated Akismet documentation 2016-08-16 17:13:01 -05:00
auth0.md Merge branch 'fix/auth0-unsafe-login-10-6' into 'security-10-6' 2018-03-21 14:43:47 +00:00
azure.md Update omniauth-azure-oauth2 to 0.0.9 (Support Office 365 Germany) 2017-09-26 12:30:48 +02:00
bitbucket.md Update Bitbucket callback URL documentation 2016-12-21 13:51:17 -08:00
cas.md Fix markdown link in Omniauth docs 2017-02-09 08:55:09 +01:00
chat_commands.md Rename "Slash commands" to "Quick actions" 2017-06-15 09:01:56 -05:00
crowd.md Move and update Crowd authentication documentation 2017-03-07 11:58:30 -06:00
external-issue-tracker.md Custom issue tracker 2017-11-21 15:21:50 +00:00
facebook.md Fix markdown link in Omniauth docs 2017-02-09 08:55:09 +01:00
github.md Add extra step in GHE import docs 2017-05-23 18:29:20 -05:00
gitlab.md Fix markdown link in Omniauth docs 2017-02-09 08:55:09 +01:00
gmail_action_buttons_for_gitlab.md Move all integration docs images in a single directory 2016-01-24 21:22:19 +01:00
google.md Update google.md to reflect changes in the new Google APIs Library 2017-11-28 17:16:04 +00:00
jira.md Move project services to new location under Integrations 2017-02-03 20:28:47 +01:00
ldap.md Change wording for LDAP doc that was moved to a new location 2017-02-20 14:15:35 +01:00
oauth2_generic.md Adjust doc formatting 2017-02-13 12:54:57 -06:00
oauth_provider.md Backport gitlab-ee!2456 2017-07-27 12:09:46 -04:00
omniauth.md Make sure user email is read only when synced with LDAP 2017-12-15 12:48:48 +01:00
openid_connect_provider.md Add groups to OpenID Connect claims 2018-02-08 13:22:41 +01:00
recaptcha.md reCAPTCHA is configurable through Admin Settings, no reload needed. 2015-12-28 18:50:29 -02:00
saml.md Change the wording to reduce confusion about whether you need to reconfigure or restart. 2018-02-28 16:20:02 +00:00
shibboleth.md Fix markdown link in Omniauth docs 2017-02-09 08:55:09 +01:00
slack.md Refactor Slack service documentation 2016-07-22 12:37:05 +03:00
slash_commands.md Add slash command for moving an issue 2018-03-15 13:09:11 +00:00
trello_power_up.md Simple docs fixes 2017-10-23 14:11:51 +00:00
twitter.md Fix markdown link in Omniauth docs 2017-02-09 08:55:09 +01:00

README.md

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
  • JIRA Integrate with the JIRA issue tracker
  • 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, Gemnasium, 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