PageRenderTime 40ms CodeModel.GetById 15ms RepoModel.GetById 0ms app.codeStats 0ms

/doc/integration/README.md

https://gitlab.com/jastkand/gitlab-ce
Markdown | 66 lines | 45 code | 21 blank | 0 comment | 0 complexity | 62b1ab7892d0f0480ca5698f8519cee2 MD5 | raw file
    

  1. # GitLab Integration
    2. 

  2. 

  3. GitLab integrates with multiple third-party services to allow external issue
    4. 

  4. trackers and external authentication.
    5. 

  5. 

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

  7. 

  8. - [JIRA](../project_services/jira.md) Integrate with the JIRA issue tracker
    9. 

  9. - [External issue tracker](external-issue-tracker.md) Redmine, JIRA, etc.
    10. 

  10. - [LDAP](ldap.md) Set up sign in via LDAP
    11. 

  11. - [OmniAuth](omniauth.md) Sign in via Twitter, GitHub, GitLab.com, Google, Bitbucket, Facebook, Shibboleth, SAML, Crowd, Azure and Authentiq ID
    12. 

  12. - [SAML](saml.md) Configure GitLab as a SAML 2.0 Service Provider
    13. 

  13. - [CAS](cas.md) Configure GitLab to sign in using CAS
    14. 

  14. - [OAuth2 provider](oauth_provider.md) OAuth2 application creation
    15. 

  15. - [Gmail actions buttons](gmail_action_buttons_for_gitlab.md) Adds GitLab actions to messages
    16. 

  16. - [reCAPTCHA](recaptcha.md) Configure GitLab to use Google reCAPTCHA for new users
    17. 

  17. - [Akismet](akismet.md) Configure Akismet to stop spam
    18. 

  18. - [Koding](../administration/integration/koding.md) Configure Koding to use IDE integration
    19. 

  19. - [PlantUML](../administration/integration/plantuml.md) Configure PlantUML to use diagrams in AsciiDoc documents.
    20. 

  20. 

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

  22. 

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

  24. 

  25. 

  26. ## Project services
    27. 

  27. 

  28. Integration with services such as Campfire, Flowdock, Gemnasium, HipChat,
    29. 

  29. Pivotal Tracker, and Slack are available in the form of a [Project Service][].
    30. 

  30. 

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

  32. 

  33. ## SSL certificate errors
    34. 

  34. 

  35. When trying to integrate GitLab with services that are using self-signed certificates,
    36. 

  36. it is very likely that SSL certificate errors will occur on different parts of the
    37. 

  37. application, most likely Sidekiq. There are 2 approaches you can take to solve this:
    38. 

  38. 

  39. 1. Add the root certificate to the trusted chain of the OS.
    40. 

  40. 1. If using Omnibus, you can add the certificate to GitLab's trusted certificates.
    41. 

    42. 

  42. **OS main trusted chain**
    43. 

  43. 

  44. This [resource](http://kb.kerio.com/product/kerio-connect/server-configuration/ssl-certificates/adding-trusted-root-certificates-to-the-server-1605.html)
    45. 

  45. has all the information you need to add a certificate to the main trusted chain.
    46. 

  46. 

  47. This [answer](http://superuser.com/questions/437330/how-do-you-add-a-certificate-authority-ca-to-ubuntu)
    48. 

  48. at Super User also has relevant information.
    49. 

  49. 

  50. **Omnibus Trusted Chain**
    51. 

  51. 

  52. [Install the self signed certificate or custom certificate authorities](http://docs.gitlab.com/omnibus/common_installation_problems/README.html#using-self-signed-certificate-or-custom-certificate-authorities)
    53. 

  53. in to GitLab Omnibus.
    54. 

  54. 

  55. It is enough to concatenate the certificate to the main trusted certificate
    56. 

  56. however it may be overwritten during upgrades:
    57. 

  57. 

  58. ```bash
    59. 

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

  60. ```
    61. 

  61. 

  62. After that restart GitLab with:
    63. 

  63. 

  64. ```bash
    65. 

  65. sudo gitlab-ctl restart
    66. 

  66. ```
    67. 

  67.