From 32a4c7c9e3a5b00275c6ea2886d4db6982ec6052 Mon Sep 17 00:00:00 2001
From: Marco Huenseler <marcoh.huenseler+git@gmail.com>
Date: Sun, 25 Jun 2017 15:38:41 +0200
Subject: Add README

---
 README.md | 34 ++++++++++++++++++++++++++++++++++
 1 file changed, 34 insertions(+)
 create mode 100644 README.md

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
+```
-- 
cgit