OdooWiki OCA HUB

LDAPS authentication

auth_ldaps folder_open OCA/server-auth open_in_new
Tools License: AGPL-3

This module allows to authenticate using a LDAP over SSL system.

auto_awesome What this module does

AI-generated from the code · Odoo 17.0

Adds LDAPS (LDAP over SSL) support to Odoo's LDAP authentication, with two new options on the LDAP server configuration: 'Use LDAPS' and 'Skip certificate validation'.

This module extends the existing LDAP authentication feature so that Odoo can connect to directory servers over SSL instead of a plain connection.

Where it appears: - On the LDAP server configuration form (the same screen used to set up LDAP authentication), two new checkboxes are added after the existing TLS option: 'Use LDAPS' and 'Skip certificate validation'.

What it does: - When 'Use LDAPS' is enabled for a server, Odoo connects using the secure ldaps:// protocol on the configured server address and port. - If 'Skip certificate validation' is also enabled, the SSL certificate presented by the server is accepted without validation, which is useful for test or self-signed setups. - If the existing TLS option is enabled together with LDAPS, a secure TLS session is started on the connection. - If 'Use LDAPS' is not enabled, the module leaves the standard LDAP behaviour untouched.

Business rules and behaviour: - Both new options default to off, so nothing changes until an administrator turns them on. - The settings are read from the LDAP server record each time a connection is prepared, so changes take effect on the next authentication attempt.

It touches the LDAP server configuration model res.company.ldap and the LDAP authentication flow, and requires the python-ldap library to be installed on the server.

Depends on

auth_ldap
Models and fields (1)
  • res.company.ldap · extends an existing modelis_ssl (Use LDAPS), skip_cert_validation (Skip certificate validation)

Text generated by AI (DeepSeek) from reading the Odoo 17.0 code on GitHub; it may contain mistakes, so check the code before deciding. View the code on GitHub

Availability by version

Reviewed: 2026-11-03
Confirmed (verified in repository and branch) Estimated (unverified) No information

Confirmation status: 6 confirmed, 3 with no information of 9 versions.

Sources · Odoo 17.0

Confirmed on 2026-11-03 in branch 17.0 of OCA/server-auth.

terminal Installation and usage

OCA documentation · Odoo 17.0

To verify LDAPS server certificate, you need to:

  • Add the CA certificate of the LDAPS on your server as a trusted certificate
  • Check the Verify certificate flag in configuration

To configure this module, you need to:

  • Access Settings / General Settings / LDAP Authentication / LDAP Server
  • Check the Use LDAPS flag

No verified information in OCA: Usage.

info

Data imported from GitHub: this sheet reflects the latest catalog review, not a live lookup. Always check the module documentation and staging before installing in production.