diff options
| author | Marco Huenseler <marcoh.huenseler+git@gmail.com> | 2017-06-25 15:38:41 +0200 |
|---|---|---|
| committer | Marco Huenseler <marcoh.huenseler+git@gmail.com> | 2017-06-25 15:38:41 +0200 |
| commit | 32a4c7c9e3a5b00275c6ea2886d4db6982ec6052 (patch) | |
| tree | 5a9cfadcfcd261bef3ef0b335e775c8ce55e899a | |
| parent | initial commit, just some small syntax sugar for Raoul Thill's LDAP plugin (diff) | |
| download | radicale_auth_ldap-32a4c7c9e3a5b00275c6ea2886d4db6982ec6052.tar.gz radicale_auth_ldap-32a4c7c9e3a5b00275c6ea2886d4db6982ec6052.tar.bz2 radicale_auth_ldap-32a4c7c9e3a5b00275c6ea2886d4db6982ec6052.zip | |
Add README
| -rw-r--r-- | README.md | 34 |
1 files changed, 34 insertions, 0 deletions
diff --git a/README.md b/README.md new file mode 100644 index 0000000..94ac7d2 --- /dev/null +++ b/README.md @@ -0,0 +1,34 @@ +# What is this? +This is an authentication plugin for Radicale 2. It adds an LDAP authentication backend which can be used for authenticating users against an LDAP server. + +# How to configure +You will need to set a few options inside your radicale config file. Example: + +``` +[auth] +type = radicale_auth_ldap + +# LDAP server URL, with protocol and port +ldap_url = ldap://ldap:389 + +# LDAP base path +ldap_base = ou=Users,dc=TESTDOMAIN + +# LDAP login attribute +ldap_attribute = uid + +# LDAP filter string +# placed as X in a query of the form (&(...)X) +# example: (objectCategory=Person)(objectClass=User)(memberOf=cn=calenderusers,ou=users,dc=example,dc=org) +ldap_filter = (objectClass=person) + +# LDAP dn for initial login, used if LDAP server does not allow anonymous searches +# Leave empty if searches are anonymous +ldap_binddn = cn=admin,dc=TESTDOMAIN + +# LDAP password for initial login, used with ldap_binddn +ldap_password = verysecurepassword + +# LDAP scope of the search +ldap_scope = LEVEL +``` |