Correct page title

docs/content/advanced/auth-ldap.md

@@ -0,0 +1,101 @@
+### Introduction
+
+Getting started with ldap and this mailserver we need to take 3 parts in account:
+
+* POSTFIX
+* DOVECOT
+* SASLAUTHD (this can also be handled by dovecot above)
+
+### List with the variables to control the container provisioning
+
+__POSTFIX__:
+* `LDAP_QUERY_FILTER_USER`
+* `LDAP_QUERY_FILTER_GROUP`
+* `LDAP_QUERY_FILTER_ALIAS`
+* `LDAP_QUERY_FILTER_DOMAIN`
+
+__SASLAUTHD__:
+
+* `SASLAUTHD_LDAP_FILTER`
+
+__DOVECOT__:
+* `DOVECOT_USER_FILTER`
+* `DOVECOT_PASS_FILTER`
+
+
+**NOTE**: This page will provide several use cases like recipes to show, how this project can be used with it's LDAP Features.
+
+### Ldap Setup - Kopano/Zarafa
+```
+---
+version: '2'
+
+services:
+  mail:
+    image: tvial/docker-mailserver:latest
+    hostname: mail
+    domainname: domain.com
+    container_name: mail
+
+    ports:
+      - "25:25"
+      - "143:143"
+      - "587:587"
+      - "993:993"
+
+    volumes:
+      - maildata:/var/mail
+      - mailstate:/var/mail-state
+      - ./config/:/tmp/docker-mailserver/
+
+    environment:
+      # We are not using dovecot here
+      - SMTP_ONLY=1
+      - ENABLE_SPAMASSASSIN=1
+      - ENABLE_CLAMAV=1
+      - ENABLE_FAIL2BAN=1
+      - ENABLE_POSTGREY=1
+      - SASLAUTHD_PASSWD=      
+
+      # >>> SASL Authentication
+      - ENABLE_SASLAUTHD=1
+      - SASLAUTHD_LDAP_SERVER=<yourLdapContainer/yourLdapServer>
+      - SASLAUTHD_LDAP_PROTO=
+      - SASLAUTHD_LDAP_BIND_DN=cn=Administrator,cn=Users,dc=mydomain,dc=loc
+      - SASLAUTHD_LDAP_PASSWORD=mypassword
+      - SASLAUTHD_LDAP_SEARCH_BASE=dc=mydomain,dc=loc
+      - SASLAUTHD_LDAP_FILTER="(&(sAMAccountName=%U)(objectClass=person))"
+      - SASLAUTHD_MECHANISMS=ldap
+      # <<< SASL Authentication
+
+      # >>> Postfix Ldap Integration
+      - ENABLE_LDAP=1
+      - LDAP_SERVER_HOST=<yourLdapContainer/yourLdapServer>
+      - LDAP_SEARCH_BASE=dc=mydomain,dc=loc
+      - LDAP_BIND_DN=cn=Administrator,cn=Users,dc=mydomain,dc=loc
+      - LDAP_BIND_PW=mypassword
+      - LDAP_QUERY_FILTER_USER="(&(objectClass=user)(mail=%s))"
+      - LDAP_QUERY_FILTER_GROUP="(&(objectclass=group)(mail=%s))"
+      - LDAP_QUERY_FILTER_ALIAS="(&(objectClass=user)(otherMailbox=%s))"
+      - LDAP_QUERY_FILTER_DOMAIN="(&(|(mail=*@%s)(mailalias=*@%s)(mailGroupMember=*@%s))(mailEnabled=TRUE))"
+      # <<< Postfix Ldap Integration
+
+      # >>> Kopano Integration
+      - ENABLE_POSTFIX_VIRTUAL_TRANSPORT=1
+      - POSTFIX_DAGENT=lmtp:kopano:2003
+      # <<< Kopano Integration
+
+      - ONE_DIR=1
+      - DMS_DEBUG=0
+      - SSL_TYPE=letsencrypt
+      - PERMIT_DOCKER=host
+
+    cap_add:
+      - NET_ADMIN
+
+volumes:
+  maildata:
+    driver: local
+  mailstate:
+    driver: local
+```