Download as
Browse Code »

Commit 58dbcbd5b1b66fd31292618c57c61aeb56b9d299

Authored by Jacob Vosmaer
1 parent 6993194a
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

Add LDAP setup instructions

Showing 1 changed file with 24 additions and 0 deletions   Show diff stats
README.md
  Diff comments   View file @58dbcbd
... ... @@ -144,6 +144,30 @@ git_data_dir "/mnt/nas/git-data"
144 144  
145 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 171 ## Building your own package
148 172  
149 173 See [the separate build documentation](doc/build.md).
... ...