The AXIGEN Mail Server provides routing options at SMTP In, POP3 Proxy and IMAP Proxy level through its integration with OpenLDAP. LDAP stands for Lightweight Directory Access Protocol. It is a model for Directory Services that provides a data/namespace model for both the directory and a specific protocol.

A directory is a specialized database with a hierarchical structure designed for frequent queries but infrequent updates. Unlike general databases they don't contain transaction support or roll-back functionality. Directories are easily replicated to increase availability and reliability.

In order to be configured for use within AXIGEN, OpenLDAP has to already be set up. OpenLDAP installations may very, depending on your preferred operating system. Integrating OpenLDAP with AXIGEN is a two-step process, as described below:

1. Configuring OpenLDAP for AXIGEN

Note: In this document the localdomain.test address is used as an example. Please remember to edit it accordingly.

• please run the following command and then place the following text:

# ldapadd -D "cn=admin,dc=localdomain,dc=test" -W

dn: dc=localdomain,dc=test
objectClass: dcObject
objectClass: organization
dc: localdomain
o: test

• In order to add users to the LDAP directory, add the following into a file. You may add as many users as you want in this file:

dn: cn=user1,dc=localdomain,dc=test
objectClass: inetOrgPerson
objectClass: inetLocalMailRecipient
cn: user1
sn: user1
mail: user1@localdomain
userPassword: user1
mailHost: 127.0.0.1

• Then run the following command:

# ldapadd -D "cn=admin,dc=localdomain,dc=test" -W -f file.txt

• You will be asked for the password you set up in the /etc/openldap/slapd.conf file (in our example, 'secret').

• You can test if the user was added using the following command (the second version of the command includes authentication:
  

# ldapsearch -b "dc=localdomain, dc=test"

# ldapsearch -b "dc=localdomain, dc=test" -D "cn=admin,dc=localdomain,dc=test" -W

• In order to delete an entry, use the command:

# ldapdelete -D "cn=admin,dc=localdomain,dc=test" -W
# cn=user7,dc=localdomain,dc=test

• To edit an LDAP entry, just use:

# ldapmodify -D "cn=admin,dc=localdomain,dc=test" -W
# dn: cn=user5,dc=localdomain,dc=test
# changetype:modify
# mailHost:10.10.247.5
#

Note that you must press another <Enter> after the modified field.

2. Configuring LDAP Connectors in AXIGEN

Login to WebAdmin using your preferred browser, press the 'UserDb' tab and go to the 'LDAP Connectors' section. Press 'Add new ldapconn' and fill in the fields:

• name - the name of this connector
• hosturl - the ldap host (e.g. 'ldap://localhost:389')
• bindDN - the DN of the admin account (e.g. 'cn=admin,dc=localdomain,dc=test')
• bindPass - the password set in your /etc/openldap/slapd.conf file (e.g. 'secret')
• searchBase - the search base (e.g. 'dc=localdomain,dc=test', but using '%s' is recommended, as it is the expanded domain name,
• for use in the 'dc' style LDAP base.)
• searchPattern - the search pattern (e.g. 'mail=%e')
• passwordField - the name of the field containing the password, defined in your user file created above (e.g. 'userPassword')
• axigenHostField - the name of the field containing the mail host, defined in your user file created above (e.g. 'mailHost')
• useFirst - should the first returned field be used if more are found ('yes' or 'no')

For more details on setting the above parameters in WebAdmin, see LDAP Connectors.

See subsections of current page for more details:

Configuring Mapping Parameters
POP3 Proxy Service
IMAP Proxy Service
Webmail Proxy Service