GitSwarm-EE 2017.1-1 Documentation

GitSwarm Integration

GitSwarm 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.

• JIRA Integrate with the JIRA issue tracker
• External issue tracker Redmine, JIRA, etc.
• LDAP Set up sign in via LDAP
• Jenkins Integrate with the Jenkins CI
• OmniAuth Sign in via Twitter, GitHub, GitLab.com, Google, Bitbucket, Facebook, Shibboleth, SAML, Crowd and Azure
• SAML Configure GitSwarm as a SAML 2.0 Service Provider
• CAS Configure GitSwarm to sign in using CAS
• Kerberos Integrate with Kerberos
• OAuth2 provider OAuth2 application creation
• Gmail actions buttons Adds GitSwarm actions to messages
• reCAPTCHA Configure GitSwarm to use Google reCAPTCHA for new users
• Akismet Configure Akismet to stop spam
• Koding Configure Koding to use IDE integration

GitSwarm 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 GitSwarm 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 the package installation, you can add the certificate to GitSwarm'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.

GitSwarm EE Trusted Chain

Install the self signed certificate or custom certificate authorities in to GitSwarm package installation.

It is enough to concatenate the certificate to the main trusted certificate however it may be overwritten during upgrades:

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

After that restart GitSwarm with:

sudo gitswarm-ctl restart