Addition/OpenLDAP/Personal LDAP Address Book - Revision history

ZhangHuangbin: /* Note to iRedAdmin-Pro-LDAP customers */

ZhangHuangbin — Sun, 13 Feb 2011 18:44:13 GMT

Note to iRedAdmin-Pro-LDAP customers

← Older revision		Revision as of 18:44, 13 February 2011
Line 103:		Line 103:

	= Note to iRedAdmin-Pro-LDAP customers =		= Note to iRedAdmin-Pro-LDAP customers =
-	If you're using iRedAdmin-Pro-LDAP-1.4.0 with ~~this~~ personal LDAP address book, you can't delete users who has contacts stored in LDAP. Please follow below steps to fix it.	+	If you're using iRedAdmin-Pro-LDAP-1.4.0 with personal LDAP address book, you can't delete users who has contacts stored in LDAP. Please follow below steps to fix it.

	* Save below content as file '''personal_addr_book.patch''' and upload or copy it to directory '''/tmp''' on your server which has iRedAdmin-Pro-LDAP running.		* Save below content as file '''personal_addr_book.patch''' and upload or copy it to directory '''/tmp''' on your server which has iRedAdmin-Pro-LDAP running.

ZhangHuangbin: /* Note to iRedAdmin-Pro-LDAP customers */

ZhangHuangbin — Sun, 13 Feb 2011 18:43:50 GMT

Note to iRedAdmin-Pro-LDAP customers

← Older revision		Revision as of 18:43, 13 February 2011
Line 103:		Line 103:

	= Note to iRedAdmin-Pro-LDAP customers =		= Note to iRedAdmin-Pro-LDAP customers =
		+	If you're using iRedAdmin-Pro-LDAP-1.4.0 with this personal LDAP address book, you can't delete users who has contacts stored in LDAP. Please follow below steps to fix it.
		+
		+	* Save below content as file '''personal_addr_book.patch''' and upload or copy it to directory '''/tmp''' on your server which has iRedAdmin-Pro-LDAP running.
		+	{{cfg\|personal_addr_book.patch\|<pre>
		+	diff -r 6ef8322a6f16 admin/1.4.x/libs/ldaplib/user.py
		+	--- a/admin/1.4.x/libs/ldaplib/user.py Sun Feb 13 13:02:03 2011 +0800
		+	+++ b/admin/1.4.x/libs/ldaplib/user.py Mon Feb 14 02:37:14 2011 +0800
		+	@@ -6,7 +6,7 @@
		+	import ldap.filter
		+	import web
		+	from libs import iredutils
		+	-from libs.ldaplib import core, domain as domainlib, attrs, ldaputils, iredldif, connUtils, decorators
		+	+from libs.ldaplib import core, domain as domainlib, attrs, ldaputils, iredldif, connUtils, decorators, deltree
		+
		+	# Policyd integration.
		+	from libs.policyd import throttle
		+	@@ -311,8 +311,8 @@
		+
		+	# Delete user object.
		+	try:
		+	- #deltree.DelTree(self.conn, self.dnUser, ldap.SCOPE_SUBTREE)
		+	- self.conn.delete_s(self.dnUser)
		+	+ deltree.DelTree(self.conn, self.dnUser, ldap.SCOPE_SUBTREE)
		+	+ #self.conn.delete_s(self.dnUser)
		+
		+	if deleteFromGroups:
		+	self.deleteSingleUserFromGroups(self.mail)
		+	</pre>}}
		+
		+	* Change working directory to root directory of iRedAdmin-Pro-LDAP-1.4.0 in terminal with command '''cd''', it should be one of below:
		+	** RHEL/CentOS: /var/www/iRedAdmin-Pro-LDAP-1.4.0/
		+	** Debian/Ubuntu: /usr/share/apache2/iRedAdmin-Pro-LDAP-1.4.0/
		+	** OpenSuSE: /srv/www/iRedAdmin-Pro-LDAP-1.4.0/
		+	** FreeBSD: /usr/local/www/iRedAdmin-Pro-LDAP-1.4.0/
		+
		+	* Try to patch it with command '''patch''':
		+	{{cmd\|<pre>
		+	# patch -p3 --dry-run < /tmp/personal_addr_book.patch
		+	patching file libs/ldaplib/user.py
		+	</pre>}}
		+
		+	* If you get same output message as above, it's safe to patch it now:
		+	{{cmd\|<pre>
		+	# patch -p3 < /tmp/personal_addr_book.patch
		+	patching file libs/ldaplib/user.py
		+	</pre>}}
		+
		+	* Restarting Apache web server is optional but strongly recommended.

ZhangHuangbin: /* Test */

ZhangHuangbin — Sun, 13 Feb 2011 18:33:14 GMT

Test

← Older revision		Revision as of 18:33, 13 February 2011
Line 100:		Line 100:

	= Test =		= Test =
		+	After restaring OpenLDAP server and Apache web server, you can now log into Roundcube webmail, click "'''Address Book'''" on the top-right cornor, select '''Personal LDAP Address Book''', then try to add and update new contacts.

	= Note to iRedAdmin-Pro-LDAP customers =		= Note to iRedAdmin-Pro-LDAP customers =

ZhangHuangbin: /* Configure Roundcube Webmail */

ZhangHuangbin — Sun, 13 Feb 2011 18:30:45 GMT

Configure Roundcube Webmail

← Older revision		Revision as of 18:30, 13 February 2011
Line 61:		Line 61:
	* FreeBSD: /usr/local/www/roundcubemail/main.inc.php		* FreeBSD: /usr/local/www/roundcubemail/main.inc.php

-	Add below lines before the last line '''?>''' ('''NOTE''': You must replace '''dc=iredmail,dc=org''' by your own LDAP suffix below):	+	Add below lines before the last line "'''?>'''" ('''NOTE''': You must replace '''dc=iredmail,dc=org''' by your own LDAP suffix below):
	{{cfg\|main.inc.php\|<pre>		{{cfg\|main.inc.php\|<pre>
	$rcmail_config['ldap_public']['ldap_personal'] = array(		$rcmail_config['ldap_public']['ldap_personal'] = array(

ZhangHuangbin: /* Configure Roundcube Webmail */

ZhangHuangbin — Sun, 13 Feb 2011 18:30:07 GMT

Configure Roundcube Webmail

← Older revision		Revision as of 18:30, 13 February 2011
Line 73:		Line 73:
	'writable' => true,		'writable' => true,
	'LDAP_Object_Classes' => array('top', 'inetOrgPerson'),		'LDAP_Object_Classes' => array('top', 'inetOrgPerson'),
-	'required_fields' => array('cn~~', 'sn', 'givenName~~', 'mail'),	+	'required_fields' => array('cn', 'mail'),
	'LDAP_rdn' => 'cn',		'LDAP_rdn' => 'cn',
	'ldap_version' => '3',		'ldap_version' => '3',

ZhangHuangbin: /* Summary */

ZhangHuangbin — Sun, 13 Feb 2011 18:29:43 GMT

Summary

← Older revision		Revision as of 18:29, 13 February 2011
Line 5:		Line 5:

	Contact will have 4 LDAP attributes:		Contact will have 4 LDAP attributes:
-	* cn: ~~Command~~ name.	+	* cn: Common name.
	* givenName: First name.		* givenName: First name.
	* sn: Last name.		* sn: Last name.

ZhangHuangbin: /* Configure OpenLDAP */

ZhangHuangbin — Sun, 13 Feb 2011 18:28:42 GMT

Configure OpenLDAP

← Older revision		Revision as of 18:28, 13 February 2011
Line 13:		Line 13:

	= Configure OpenLDAP =		= Configure OpenLDAP =
		+
		+	We need to modify OpenLDAP server setting, add a new access control to allow user add or update their personal contacts.

	Open OpenLDAP config file '''slapd.conf''', it could be one of below:		Open OpenLDAP config file '''slapd.conf''', it could be one of below:

ZhangHuangbin: /* Summary */

ZhangHuangbin — Sun, 13 Feb 2011 18:27:35 GMT

Summary

← Older revision		Revision as of 18:27, 13 February 2011
Line 3:		Line 3:
	= Summary =		= Summary =
	Per-user personal LDAP address book allow user to store their personal contacts in LDAP instead of MySQL.		Per-user personal LDAP address book allow user to store their personal contacts in LDAP instead of MySQL.
		+
		+	Contact will have 4 LDAP attributes:
		+	* cn: Command name.
		+	* givenName: First name.
		+	* sn: Last name.
		+	* mail: Email address.
		+
		+	Only '''cn''' and '''mail''' are required.

	= Configure OpenLDAP =		= Configure OpenLDAP =

ZhangHuangbin: /* Configure Roundcube Webmail */

ZhangHuangbin — Sun, 13 Feb 2011 18:25:16 GMT

Configure Roundcube Webmail

← Older revision		Revision as of 18:25, 13 February 2011
Line 87:		Line 87:
	</pre>}}		</pre>}}

-	Restarting apache ~~to make it work~~.	+	Restarting apache is optional but strongly recommended.

	= Test =		= Test =

	= Note to iRedAdmin-Pro-LDAP customers =		= Note to iRedAdmin-Pro-LDAP customers =

ZhangHuangbin: /* Configure Roundcube Webmail */

ZhangHuangbin — Sun, 13 Feb 2011 18:24:48 GMT

Configure Roundcube Webmail

← Older revision		Revision as of 18:24, 13 February 2011
Line 44:		Line 44:

	= Configure Roundcube Webmail =		= Configure Roundcube Webmail =
		+
		+	Open Roundcube webmail config file '''main.inc.php''', it could be one of below:
		+	* RHEL/CentOS: /var/www/roundcubemail/config/main.inc.php
		+	* Debian/Ubuntu: /usr/share/apache2/roundcubemail/config/main.inc.php
		+	* OpenSuSE: /srv/www/roundcubemail/config/main.inc.php
		+	* FreeBSD: /usr/local/www/roundcubemail/main.inc.php
		+
		+	Add below lines before the last line '''?>''' ('''NOTE''': You must replace '''dc=iredmail,dc=org''' by your own LDAP suffix below):
		+	{{cfg\|main.inc.php\|<pre>
		+	$rcmail_config['ldap_public']['ldap_personal'] = array(
		+	'name' => 'Personal LDAP Address Book',
		+	'hosts' => array('127.0.0.1'),
		+	'port' => 389,
		+	'use_tls' => false,
		+	'user_specific' => true,
		+	'base_dn' => 'mail=%u@%d,ou=Users,domainName=%d,o=domains,dc=iredmail,dc=org',
		+	'bind_dn' => 'mail=%u@%d,ou=Users,domainName=%d,o=domains,dc=iredmail,dc=org',
		+	'writable' => true,
		+	'LDAP_Object_Classes' => array('top', 'inetOrgPerson'),
		+	'required_fields' => array('cn', 'sn', 'givenName', 'mail'),
		+	'LDAP_rdn' => 'cn',
		+	'ldap_version' => '3',
		+	'search_fields' => array('mail', 'cn', 'givenName', 'sn'),
		+	'name_field' => 'cn',
		+	'email_field' => 'mail',
		+	'surname_field' => 'sn',
		+	'firstname_field' => 'givenName',
		+	'sort' => 'cn',
		+	'scope' => 'list',
		+	'filter' => '(objectClass=inetOrgPerson)',
		+	'fuzzy_search' => true);
		+	</pre>}}
		+
		+	Change default personal address book from sql to ldap in same file '''main.inc.php''':
		+	{{cfg\|main.inc.php\|<pre>
		+	$rcmail_config['address_book_type'] = 'ldap';
		+	</pre>}}
		+
		+	Append '''ldap_personal''' in setting '''autocomplete_addressbooks''', and remove '''sql''':
		+	{{cfg\|main.inc.php\|<pre>
		+	$rcmail_config['autocomplete_addressbooks'] = array(..., 'ldap_personal');
		+	</pre>}}
		+
		+	Restarting apache to make it work.

	= Test =		= Test =

	= Note to iRedAdmin-Pro-LDAP customers =		= Note to iRedAdmin-Pro-LDAP customers =