diff options
| author | Christopher Speller <crspeller@gmail.com> | 2015-09-01 08:28:10 -0400 |
|---|---|---|
| committer | Christopher Speller <crspeller@gmail.com> | 2015-09-01 08:28:10 -0400 |
| commit | f83601f8b4b55ec84c66e10321096f01ece0c19f (patch) | |
| tree | 47947359670e447fc5d8c5383c11021151122ead /doc/integrations/sso | |
| parent | 1dddc304147c4e25abcd9d110b2c90fbcef7cc26 (diff) | |
| parent | 94ec606e570de16c418494210618594c5e47a8db (diff) | |
| download | chat-f83601f8b4b55ec84c66e10321096f01ece0c19f.tar.gz chat-f83601f8b4b55ec84c66e10321096f01ece0c19f.tar.bz2 chat-f83601f8b4b55ec84c66e10321096f01ece0c19f.zip | |
Merge pull request #534 from mattermost/it33-patch-7
Adding documentation on configuring GitLab SSO
Diffstat (limited to 'doc/integrations/sso')
| -rw-r--r-- | doc/integrations/sso/gitlab-sso.md | 19 |
1 files changed, 19 insertions, 0 deletions
diff --git a/doc/integrations/sso/gitlab-sso.md b/doc/integrations/sso/gitlab-sso.md new file mode 100644 index 000000000..c0cd6cb45 --- /dev/null +++ b/doc/integrations/sso/gitlab-sso.md @@ -0,0 +1,19 @@ +## Configuring GitLab Single-Sign-On + +The following steps can be used to configure Mattermost to use GitLab as a single-sign-on (SSO) service for team creation, account creation and sign-in. + +1. Login to your GitLab account and go to the Applications section either in Profile Settings or Admin Area. +2. Add a new application called "Mattermost" with the following as Redirect URIs: + * `<your-mattermost-url>/login/gitlab/complete` (example: http://localhost:8065/login/gitlab/complete) + * `<your-mattermost-url>/signup/gitlab/complete` + +3. Submit the application and copy the given _Id_ and _Secret_ into the appropriate _SSOSettings_ fields in config/config.json + +4. Also in config/config.json, set _Allow_ to `true` for the _gitlab_ section, leave _Scope_ blank and use the following for the endpoints: + * _AuthEndpoint_: `<your-gitlab-url>/oauth/authorize` (example http://localhost:3000/oauth/authorize) + * _TokenEndpoint_: `<your-gitlab-url>/oauth/token` + * _UserApiEndpoint_: `<your-gitlab-url>/api/v3/user` + +6. (Optional) If you would like to force all users to sign-up with GitLab only, in the _ServiceSettings_ section of config/config.json please set _AllowEmailSignUp_ to `false`. + +7. Restart your Mattermost server to see the changes take effect. |