gitlab-org--gitlab-foss/doc/integration
Valery Sizov 70de5114fb Merge branch 'auth-icons-labels' into 'master'
Allow custom label to be set for authentication providers.

Addresses internal issue https://dev.gitlab.org/gitlab/gitlabhq/issues/2341

Beside the above, I've:
- Refactored `OauthHelper` to have clearer method names and behaviour
- Moved some of `OauthHelper` behaviour to `Gitlab::OAuth::Provider`
- Renamed `OauthHelper` to `AuthHelper` since LDAP, SAML, Kerberos aren't OAuth
- Updated the icons for GitHub and GitLab

In the examples below, "OurAuth" is a SAML provider with a custom label.

![Screen_Shot_2015-07-02_at_16.29.52](https://gitlab.com/gitlab-org/gitlab-ce/uploads/7d425bde69dc34e1667ebd5375d0266d/Screen_Shot_2015-07-02_at_16.29.52.png)

![Screen_Shot_2015-07-02_at_16.31.40](https://gitlab.com/gitlab-org/gitlab-ce/uploads/cbb273321ecdf4cab3d3ef0dc35553e7/Screen_Shot_2015-07-02_at_16.31.40.png)

![Screen_Shot_2015-07-02_at_16.32.39](https://gitlab.com/gitlab-org/gitlab-ce/uploads/d8dd6e1d0dc45a788e869cdcdc99e178/Screen_Shot_2015-07-02_at_16.32.39.png)

![Screen_Shot_2015-07-02_at_16.33.18](https://gitlab.com/gitlab-org/gitlab-ce/uploads/7dbfe8b0ae229c32a08d6c7442976d83/Screen_Shot_2015-07-02_at_16.33.18.png)


See merge request !927
2015-07-24 11:28:55 +00:00
..
oauth_provider OAuth2 provider documentation 2015-02-13 19:27:50 +02:00
bitbucket.md Improve BitBucket integration documentation [ci skip] 2015-05-15 18:37:15 +02:00
external-issue-tracker.md Improve documentation of configuring external issue trackers 2015-05-04 07:33:25 -07:00
github.md remove duplicate right braces ('}') in configuration examples of GitHub, 2015-03-09 23:20:44 +08:00
github_app.png update documentation regarding github_importer 2015-01-19 12:55:44 -08:00
gitlab.md remove duplicate right braces ('}') in configuration examples of GitHub, 2015-03-09 23:20:44 +08:00
gitlab_app.png Improve GitLab.com integration documentation 2015-02-18 22:06:49 -08:00
google.md remove duplicate right braces ('}') in configuration examples of GitHub, 2015-03-09 23:20:44 +08:00
google_app.png More info about GitLab integrations with OAuth 2014-04-08 10:32:00 +03:00
jira-integration-points.png
ldap.md LDAP users should not control their LDAP email 2015-06-03 13:40:47 +02:00
oauth_provider.md Improve the explanation and linking of the Oauth docs. 2015-02-18 20:49:19 -08:00
omniauth.md Allow custom label to be set for authentication providers. 2015-07-23 15:20:12 +02:00
README.md Link to SAML docs from doc index 2015-06-29 11:32:40 +02:00
redmine_configuration.png Explained in the integration documentation how to enable external issue tracker 2015-02-12 17:06:55 -08:00
redmine_service_template.png Explained in the integration documentation how to enable external issue tracker 2015-02-12 17:06:55 -08:00
saml.md Add Troubleshooting section to SAML doc. 2015-07-01 14:25:22 +02:00
shibboleth.md Update oauth documenatation with examples for omnibus package and installations from source. 2015-02-13 14:49:19 -08:00
slack.md Updated the Slack documentation 2015-04-21 12:25:37 -05:00
twitter.md Add Bitbucket integration docs. 2015-02-24 15:07:25 +01:00
twitter_app_api_keys.png Add twitter documentation. 2014-04-07 11:53:48 +02:00
twitter_app_details.png More info about GitLab integrations with OAuth 2014-04-08 10:32:00 +03:00

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.

  • External issue tracker Redmine, JIRA, etc.
  • LDAP Set up sign in via LDAP
  • OmniAuth Sign in via Twitter, GitHub, GitLab, and Google via OAuth.
  • SAML Configure GitLab as a SAML 2.0 Service Provider
  • Slack Integrate with the Slack chat service
  • OAuth2 provider OAuth2 application creation
  • Gmail Adds GitLab actions to messages

GitLab Enterprise Edition contains advanced JIRA support and 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. You can find these within GitLab in the Services page under Project Settings if you are at least a master on the project. Project Services are a bit like plugins in that they allow a lot of freedom in adding functionality to GitLab, for example there is also a service that can send an email every time someone pushes new commits. Because GitLab is open source we can ship with the code and tests for all plugins. This allows the community to keep the plugins up to date so that they always work in newer GitLab versions. For an overview of what projects services are available without logging in please see the project_services directory.