Skip to content

docs(ldap): clarify startTLS and insecureNoSSL behavior - #218

Open
Retr0-XD wants to merge 1 commit into
dexidp:mainfrom
Retr0-XD:fix-ldap-tls-docs
Open

Retr0-XD wants to merge 1 commit into
dexidp:mainfrom
Retr0-XD:fix-ldap-tls-docs

Conversation

@Retr0-XD

Copy link
Copy Markdown

This change documents the TLS behavior of the LDAP connector so users can see which scheme, default port, and TLS mode result from every combination of the startTLS and insecureNoSSL flags.

What changed:

  • Added a table covering all four combinations of startTLS / insecureNoSSL.
  • Added warning callouts for two common misconfigurations:
    • insecureNoSSL: true takes precedence over startTLS: true, producing a plaintext connection instead of StartTLS.
    • startTLS and implicit TLS (ldaps://) cannot be combined; with startTLS: true the connector always uses ldap://.
  • Updated the inline host comment in the example config to match the actual default-port logic.

Fixes dexidp/dex#2351

Add a table that documents the resulting connection scheme, default
port, and TLS mode for every combination of the startTLS and
insecureNoSSL flags. Also add warning callouts about the two common
misconfigurations: using insecureNoSSL + startTLS, and using startTLS
with the implicit-TLS default port 636.

Fixes dexidp/dex#2351

Signed-off-by: Sakthi Harish <sakthi.harish@edgeverve.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[LDAP] Docs unclear about the behavior of startTLS and insecureNoSSL

1 participant