skip to navigation
skip to content

tiddlywebplugins.ldapauth 0.1.1

Allows TiddlyWeb users to Authenticate against an LDAP server.

[![Build Status](](
[![Coverage Status](](
[![Latest Release](](

Allows TiddlyWeb users to Authenticate against an LDAP server.

It has been tested with OpenLDAP but other LDAP-compliant servers could be used (e.g. Active Directory).


* [Python](
* [pip](
* make.
* A working TiddlyWeb instance to test against.
* [py.test]( to run the tests.
* An LDAP server (e.g. [OpenLDAP]( with some users that have passwords.


The best way to figure out how to work with this project is to look at the `.travis.yml` file.

`` is used to package up the plugin, install and distribute.

Plugin code lives in the `tiddlywebplugins` directory.

Tests live in the `test` directory.

* `make test` runs the tests.
* `make test_with_coverage` runs the tests with code coverage reporting from `pytest-cov`
* `make pep8` runs pep8 over the code to check for style compliance.
* `make install` installs the plugin as a package on your system
(you may need sudo for this.)
* `make release` packages and uploads the plugin to [PyPI]( for distribution.

Setting up LDAP

See [this guide](

Plugin Installation

Requires the following OS packages:

apt-get install libldap2-dev libsasl2-dev

On Redhat-based systems this is:

yum install openldap-devel

Then install tiddlywebplugins.ldapauth:

pip install -U tiddlywebplugins.ldapauth

TiddlyWeb Configuration

Reference the plugin from your TiddlyWeb configuration as an auth system plugin e.g:

`'auth_systems': ['tiddlywebplugins.ldapauth']`

Configure an LDAP server to communicate with. If this is not specified then `` is the default connection.

'ldapauth': {
'ldap_host': '',
'ldap_port': '3890',
'ldap_base_dn': 'dc=my,dc=domain'
'ldap_tiddlyspace_mode': True

If `ldap_base_dn` is not specified then `dc=localhost` is assumed.

`'ldap_tiddlyspace_mode': True` is only needed for TiddlySpace installations where a CSRF token is required.


The URL to authenticate with will end in:

File Type Py Version Uploaded on Size
tiddlywebplugins.ldapauth-0.1.1.tar.gz (md5) Source 2013-06-06 5KB