448c19aab1
Update github.md
Hi, I ran into a few pitfalls while I enabled OmniAuth to be able to migrate repos from github to my omnibus-gitlab instance today, so here are my findings:
These docs state thate the default authorization callback URL is `'${YOUR_DOMAIN}/import/github/callback'`, but the screenshot only shows `'${YOUR_DOMAIN}'`, which works, so I removed the ambiguity.
When editing `gitlab_rails['omniauth_providers']` for github.com, you have to omit the `"url" => "https://github.com/",` part, otherwise it won't work (OmniAuth will stay deactivated). This is backed by the configuration details of the "from-source-installation" which also omits the url in the `yml` file.
After changing the `gitlab.rb` file, `sudo gitlab-ctl reconfigure` needs to be run, which is missing in the docs.
Following the updated version of this documentation I was able to enable OmniAuth.
If anything I edited is wrong, please correct me, as I don't know how the "from-source-installations" would react to my changes.
Best regards,
Florian
See merge request !4072
|
||
|---|---|---|
| .. | ||
| img | ||
| akismet.md | ||
| auth0.md | ||
| azure.md | ||
| bitbucket.md | ||
| cas.md | ||
| crowd.md | ||
| external-issue-tracker.md | ||
| facebook.md | ||
| github.md | ||
| gitlab.md | ||
| gmail_action_buttons_for_gitlab.md | ||
| google.md | ||
| ldap.md | ||
| oauth_provider.md | ||
| omniauth.md | ||
| README.md | ||
| recaptcha.md | ||
| saml.md | ||
| shibboleth.md | ||
| slack.md | ||
| twitter.md | ||
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.
- JIRA Integrate with the JIRA issue tracker
- External issue tracker Redmine, JIRA, etc.
- LDAP Set up sign in via LDAP
- OmniAuth Sign in via Twitter, GitHub, GitLab.com, Google, Bitbucket, Facebook, Shibboleth, SAML, Crowd and Azure
- SAML Configure GitLab as a SAML 2.0 Service Provider
- CAS Configure GitLab to sign in using CAS
- OAuth2 provider OAuth2 application creation
- Gmail actions buttons Adds GitLab actions to messages
- reCAPTCHA Configure GitLab to use Google reCAPTCHA for new users
- Akismet Configure Akismet to stop spam
- Koding Configure Koding to use IDE integration
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:
- Add the root certificate to the trusted chain of the OS.
- 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