diff options
Diffstat (limited to 'doc/integration/ldap.md')
-rw-r--r-- | doc/integration/ldap.md | 27 |
1 files changed, 27 insertions, 0 deletions
diff --git a/doc/integration/ldap.md b/doc/integration/ldap.md index f256477196b..ac15a2cdffc 100644 --- a/doc/integration/ldap.md +++ b/doc/integration/ldap.md @@ -204,3 +204,30 @@ When setting `method: ssl`, the underlying authentication method used by `omniauth-ldap` is `simple_tls`. This method establishes TLS encryption with the LDAP server before any LDAP-protocol data is exchanged but no validation of the LDAP server's SSL certificate is performed. + +## Troubleshooting + +### Common problems + +**Invalid credentials when logging in** + +Make sure the user you are binding with has enough permissions to read the user's +tree and traverse it. + +Also make sure that the `user_filter` is not blocking otherwise valid users. + +To make sure that the LDAP settings are correct and GitLab can see your users, +execute the following command: + +For Omnibus installations: + +```bash +sudo gitlab-rake gitlab:ldap:check +``` + +For installations from source: + +```bash +sudo -u git -H bundle exec rake gitlab:ldap:check RAILS_ENV=production +``` + |