Download as
Browse Code »

Commit 07b6fdb140e7319c4343e6be0e755c31b065e380

Authored by Job van der Voort
2 parents 6993194a 58dbcbd5
Exists in master and in 15 other branches 6-7-stable, 6-7-stable-ee, 6-8-stable, 6-8-stable-ee, 6-9-stable, 6-9-stable-ee, 7-0-stable, 7-0-stable-ee, 7-0-stable-spb, 7-1-stable, 7-1-stable-ee, 7-2-stable, 7-2-stable-ee, branch_test, nginx_ssl_tweaks

Merge branch 'ldap_instructions' into 'master' 

Ldap Instructions
Showing 1 changed file with 24 additions and 0 deletions   Show diff stats
@@ -144,6 +144,30 @@ git_data_dir "/mnt/nas/git-data" @@ -144,6 +144,30 @@ git_data_dir "/mnt/nas/git-data"
144 144
145 Run `sudo gitlab-ctl reconfigure` for the change to take effect. 145 Run `sudo gitlab-ctl reconfigure` for the change to take effect.
146 146
  147 +### Setting up LDAP sign-in
  148 +
  149 +If you have an LDAP directory service such as Active Directory, you can configure
  150 +GitLab so that your users can sign in with their LDAP credentials. Add the following
  151 +to `/etc/gitlab/gitlab.rb`, edited for your server.
  152 +
  153 +```ruby
  154 +# These settings are documented in more detail at
  155 +# https://gitlab.com/gitlab-org/gitlab-ce/blob/master/config/gitlab.yml.example#L118
  156 +gitlab_rails['ldap_enabled'] = true
  157 +gitlab_rails['ldap_host'] = 'hostname of LDAP server'
  158 +gitlab_rails['ldap_port'] = 389
  159 +gitlab_rails['ldap_uid'] = 'sAMAccountName'
  160 +gitlab_rails['ldap_method'] = 'plain' # 'ssl' or 'plain'
  161 +gitlab_rails['ldap_bind_dn'] = 'CN=query user,CN=Users,DC=mycorp,DC=com'
  162 +gitlab_rails['ldap_password'] = 'query user password'
  163 +gitlab_rails['ldap_allow_username_or_email_login'] = true
  164 +gitlab_rails['ldap_base'] = 'DC=mycorp,DC=com'
  165 +
  166 +# GitLab Enterprise Edition only
  167 +gitlab_rails['ldap_group_base'] = '' # Example: 'OU=groups,DC=mycorp,DC=com'
  168 +gitlab_rails['ldap_user_filter'] = '' # Example: '(memberOf=CN=my department,OU=groups,DC=mycorp,DC=com)'
  169 +```
  170 +
147 ## Building your own package 171 ## Building your own package
148 172
149 See [the separate build documentation](doc/build.md). 173 See [the separate build documentation](doc/build.md).