udata-ldap 0.2.0

LDAP authentification for udata with optional Kerberos suppport.

udata-ldap

LDAP authentification for udata with optionnal Kerberos suppport.

Requirements

To use LDAP only authentication, you only need the udata-ldap extension.

To use SASL and SPNEGO, you need a functional kerberos client environment.

On debian, you can install the requirements using:

apt-get install krb5-config krb5-user libkrb5-dev

Usage

Install the plugin package in you udata environement:

pip install udata-ldap

Then activate it in your udata.cfg:

PLUGINS = ['ldap']

NB: if using Kerberos SASL and/or SPNEGO, install it with:

pip install udata-ldap[kerberos]

Configuration

udata-ldap makes use of flask-ldap3-login and so use the same parameters as described here.

Some extra parameters are available:

Parameter	Default value	Notes
LDAP_DEBUG	False	Enable verbose/debug logging
LDAP_KERBEROS_KEYTAB	None	Path to an optionnal Kerberos keytab for this service
LDAP_KERBEROS_SERVICE_NAME	'HTTP'	The service principal as configured in the keytab
LDAP_KERBEROS_SERVICE_HOSTNAME	socket.getfqdn()	The service hostname (ie. data.domain.com)
LDAP_KERBEROS_SPNEGO	False	Whether or not to enable passwordless authentication with SPNEGO
LDAP_USER_SPNEGO_ATTR	'uid'	The ldap attribute extracted from SPNEGO handshake to match the user

Testing configuration

udata-ldap provides two commands to help with the configuration:

• udata ldap config will display the LDAP configuration seen by udata
• udata ldap check will allow to quickly test your configuration.

Testing localy with docker

An example docker-compose.yml is provided to test localy wiht a freeipa server.

To use it, you need to copy the file ipa-server-install-options.example to ipa-server-install-options and edit it with your own parameters.

ex:

--unattended
--realm=DATA.XPS
--domain=data.xps
--ds-password=password
--admin-password=password

Changelog

Current (in progress)

Initial release