From 341d270c2d8b750556d9735a9a8edd8b6fab2530 Mon Sep 17 00:00:00 2001 From: Christopher Speller Date: Fri, 2 Oct 2015 14:48:50 -0400 Subject: Adding doc system to build. Updated docs, fixed links. --- doc/integrations/Single-Sign-On/Gitlab.md | 19 +++++++++++++++++++ 1 file changed, 19 insertions(+) create mode 100644 doc/integrations/Single-Sign-On/Gitlab.md (limited to 'doc/integrations/Single-Sign-On/Gitlab.md') diff --git a/doc/integrations/Single-Sign-On/Gitlab.md b/doc/integrations/Single-Sign-On/Gitlab.md new file mode 100644 index 000000000..6110db504 --- /dev/null +++ b/doc/integrations/Single-Sign-On/Gitlab.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: + * `/login/gitlab/complete` (example: http://localhost:8065/login/gitlab/complete) + * `/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_: `/oauth/authorize` (example http://localhost:3000/oauth/authorize) + * _TokenEndpoint_: `/oauth/token` + * _UserApiEndpoint_: `/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 _DisableEmailSignUp_ to `true`. + +7. Restart your Mattermost server to see the changes take effect. -- cgit v1.2.3-1-g7c22