Files
mostlymatter/doc/integrations/Single-Sign-On/Github.md
Yi EungJun ff664e44ec Note that the Github Enterprise SSO is unofficial
Since the GitLab SSO UI is used for GitHub Enterprise SSO, it's potentially
confusing.

Suggested-by: it33 <iantien@gmail.com>
2015-12-02 13:24:38 +09:00

1.4 KiB

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:
  1. Submit the application and copy the given Id and Secret into the appropriate GitLabSettings fields in config/config.json

  2. 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
  1. (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.

  2. Restart your Mattermost server to see the changes take effect.