Integrate with GitLab All tiers All offerings
You can integrate GitLab with external services for enhanced functionality.
Services
Services such as Campfire, Jira, Pivotal Tracker, and Slack are available as integrations.
Issue trackers
You can use an external issue tracker with the GitLab issue tracker or use an external issue tracker only.
Authentication sources
You can integrate GitLab with the following authentication sources:
- Enable the Auth0 OmniAuth provider.
- Enable sign-in with Bitbucket accounts.
- Authenticate with Kerberos.
- Enable sign-in with LDAP.
- Enable creating OAuth 2.0 applications.
- Use OmniAuth to enable sign-in through:
- Azure
- Bitbucket
- Crowd
- GitHub
- GitLab.com
- SAML
- Use GitLab as an OpenID Connect identity provider.
- Authenticate with Vault through GitLab OpenID Connect.
- Configure GitLab as a SAML 2.0 Service Provider.
Security enhancements
You can integrate GitLab with the following security enhancements:
GitLab also provides features to improve the security of your own application. For more details, see Secure your application.
Security partners
You can integrate GitLab with the following security partners:
- Anchore
- Bridgecrew
- Checkmarx
- Deepfactor
- Fortify
- GrammaTech
- Indeni
- Jscrambler
- Mend
- Semgrep
- StackHawk
- Tenable
- Venafi
- Veracode
Continuous integration
You can integrate GitLab with the following external services for continuous integration:
Feature enhancements
You can integrate GitLab with the following feature enhancements:
- Add GitLab actions to Gmail actions buttons.
- Configure PlantUML or Kroki to use diagrams in AsciiDoc and Markdown documents.
- Attach merge requests to Trello cards.
- Enable integrated code intelligence powered by Sourcegraph.
- Add Elasticsearch for advanced search.
Troubleshooting
SSL certificate errors
When integrating GitLab with services using a self-signed certificate, you might encounter SSL certificate errors in different parts of the application.
As a workaround, you can do one of the following:
- Add the certificate to the OS trusted chain. See:
- In Omnibus GitLab, add the certificate to the Omnibus trusted chain:
- Install the self-signed certificate.
-
Concatenate the self-signed certificate with the GitLab trusted certificate. The self-signed certificate might be overwritten during upgrades.
cat jira.pem >> /opt/gitlab/embedded/ssl/certs/cacert.pem
-
Restart GitLab.
sudo gitlab-ctl restart
Search Sidekiq logs in Kibana
To locate a specific integration in Kibana, use the following KQL search string:
`json.integration_class.keyword : "Integrations::Jira" and json.project_path : "path/to/project"`
You can find information in:
json.exception.backtrace
json.exception.class
json.exception.message
json.message