diff options
author | Yi EungJun <eungjun.yi@navercorp.com> | 2015-12-03 18:04:07 +0900 |
---|---|---|
committer | Yi EungJun <eungjun.yi@navercorp.com> | 2015-12-03 18:19:22 +0900 |
commit | 4aef32d998ffcf7d8c59c1dcfe1ff5eb923feb45 (patch) | |
tree | 9c560f67440c04b14fec2bc0a0a219f025a03dd9 /doc/integrations/Single-Sign-On/GitHub-Enterprise.md | |
parent | b8940eee716668f8b4f140abab419130cf494239 (diff) | |
download | chat-4aef32d998ffcf7d8c59c1dcfe1ff5eb923feb45.tar.gz chat-4aef32d998ffcf7d8c59c1dcfe1ff5eb923feb45.tar.bz2 chat-4aef32d998ffcf7d8c59c1dcfe1ff5eb923feb45.zip |
Add unofficial guide for GitHub SSO
SSO for Github Enterprise was added at 6d63f57, but it seemed not to work with
GitHub.
The curlpits were:
* The url to get the authenticate user is /user, not /api/v3/user.
* Users should set their public email for GitHub.
Describe the detail in GitHub.md and rename the original Github.md to
GitHub-Enterprise.md.
Diffstat (limited to 'doc/integrations/Single-Sign-On/GitHub-Enterprise.md')
-rw-r--r-- | doc/integrations/Single-Sign-On/GitHub-Enterprise.md | 20 |
1 files changed, 20 insertions, 0 deletions
diff --git a/doc/integrations/Single-Sign-On/GitHub-Enterprise.md b/doc/integrations/Single-Sign-On/GitHub-Enterprise.md new file mode 100644 index 000000000..6f6633846 --- /dev/null +++ b/doc/integrations/Single-Sign-On/GitHub-Enterprise.md @@ -0,0 +1,20 @@ +## Configuring GitHub Enterprise Single-Sign-On (unofficial) + +Note: Because the authentication interface of GitHub Enterprise is similar to that of GitLab, the GitLab SSO feature can be used to unofficially also support GitHub Enterprise SSO. + +Follow these steps to configure Mattermost to use Github Enterprise as a single-sign-on (SSO) service for team creation, account creation and sign-in using the GitLab SSO interface. + +1. Login to your GitHub Enterprise account and go to the Applications section in Profile Settings. +2. Add a new application called "Mattermost" with the following as Authorization callback URL: + * `<your-mattermost-url>` (example: http://localhost:8065) + +3. Submit the application and copy the given _Id_ and _Secret_ into the appropriate _GitLabSettings_ fields in config/config.json + +4. Also in config/config.json, set _Enable_ to `true` for the _gitlab_ section, leave _Scope_ blank and use the following for the endpoints: + * _AuthEndpoint_: `https://<your-github-enterprise-url>/oauth/authorize` (example https://github.com/oauth/authorize) + * _TokenEndpoint_: `https://<your-github-enterprise-url>/oauth/access_token` + * _UserApiEndpoint_: `https://<your-github-enterprise-url>/api/v3/user` + +5. (Optional) If you would like to force all users to sign-up with GitHub Enterprise only, in the _ServiceSettings_ section of config/config.json set _DisableEmailSignUp_ to `true`. + +6. Restart your Mattermost server to see the changes take effect. |