From cf232411ae37b68c9d6ab20deac3fc8d99b44124 Mon Sep 17 00:00:00 2001 From: Patricio Cano Date: Thu, 3 Mar 2016 11:21:32 -0500 Subject: Added Troubleshooting information for most used services. --- doc/integration/ldap.md | 27 +++++++++++++++++++++++++++ 1 file changed, 27 insertions(+) (limited to 'doc/integration/ldap.md') 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 +``` + -- cgit v1.2.1