Commit 2952b5d3 authored by Christiaan Conover's avatar Christiaan Conover Committed by Evan Read

Document GitLab's behavior during LDAP outage

Based on a question from a customer regarding how GitLab handles LDAP
outages, document GitLab's behavior when the configured LDAP endpoint is
unreachable.
parent 2b6abff0
...@@ -563,3 +563,15 @@ If you are getting 'Connection Refused' errors when trying to connect to the ...@@ -563,3 +563,15 @@ If you are getting 'Connection Refused' errors when trying to connect to the
LDAP server please double-check the LDAP `port` and `encryption` settings used by LDAP server please double-check the LDAP `port` and `encryption` settings used by
GitLab. Common combinations are `encryption: 'plain'` and `port: 389`, OR GitLab. Common combinations are `encryption: 'plain'` and `port: 389`, OR
`encryption: 'simple_tls'` and `port: 636`. `encryption: 'simple_tls'` and `port: 636`.
### Connection times out
If GitLab cannot reach your LDAP endpoint, you will see a message like this:
```
Could not authenticate you from Ldapmain because "Connection timed out - user specified timeout".
```
If your configured LDAP provider and/or endpoint is offline or otherwise unreachable by GitLab, no LDAP user will be able to authenticate and log in. GitLab does not cache or store credentials for LDAP users to provide authentication during an LDAP outage.
Contact your LDAP provider or administrator if you are seeing this error.
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment