IRedMail/FAQ/Dovecot.Master.User - Revision history

ZhangHuangbin at 14:19, 13 March 2013

ZhangHuangbin — Wed, 13 Mar 2013 14:19:54 GMT

← Older revision		Revision as of 14:19, 13 March 2013
Line 5:		Line 5:
	* Dovecot-2: http://wiki2.dovecot.org/Authentication/MasterUsers		* Dovecot-2: http://wiki2.dovecot.org/Authentication/MasterUsers
	* Dovecot-1: http://wiki1.dovecot.org/Authentication/MasterUsers		* Dovecot-1: http://wiki1.dovecot.org/Authentication/MasterUsers
		+
		+	Important notes:
		+	* With below settings, Dovecot Master User works with Dovecot-2.0 with or without ACL plugin enabled.
		+	* Dovecot Master User works with Dovecot-1.2 '''without''' ACL plugin enabled.

	= Steps for Dovecot-2 =		= Steps for Dovecot-2 =

ZhangHuangbin: /* Steps for Dovecot-2 */

ZhangHuangbin — Wed, 13 Mar 2013 14:00:53 GMT

Steps for Dovecot-2

← Older revision		Revision as of 14:00, 13 March 2013
Line 23:		Line 23:

	* For different backends:		* For different backends:
-	** If you're running OpenLDAP backend, please update '''/etc/dovecot/dovecot-ldap.conf''' (Linux or OpenBSD) or '''/usr/local/etc/dovecot/dovecot-ldap.conf''', add '''~~'%u' AS~~ master_user''' in '''user_query''' like below:	+	** If you're running OpenLDAP backend, please update '''/etc/dovecot/dovecot-ldap.conf''' (Linux or OpenBSD) or '''/usr/local/etc/dovecot/dovecot-ldap.conf''', add '''mail=master_user,''' in '''user_query''' like below:
	{{cfg\|dovecot-ldap.conf\|<pre>		{{cfg\|dovecot-ldap.conf\|<pre>
		+	user_query = mail=master_user,...
	</pre>}}		</pre>}}

ZhangHuangbin: /* Steps for Dovecot-2 */

ZhangHuangbin — Wed, 13 Mar 2013 13:41:32 GMT

Steps for Dovecot-2

← Older revision		Revision as of 13:41, 13 March 2013
Line 20:		Line 20:
	master = yes		master = yes
	}		}
		+	</pre>}}
		+
		+	* For different backends:
		+	** If you're running OpenLDAP backend, please update '''/etc/dovecot/dovecot-ldap.conf''' (Linux or OpenBSD) or '''/usr/local/etc/dovecot/dovecot-ldap.conf''', add ''''%u' AS master_user''' in '''user_query''' like below:
		+	{{cfg\|dovecot-ldap.conf\|<pre>
		+	</pre>}}
		+
		+	** If you're running MySQL backend, please update '''/etc/dovecot/dovecot-mysql.conf''' (Linux or OpenBSD) or '''/usr/local/etc/dovecot/dovecot-mysql.conf''', add ''''%u' AS master_user''' in '''user_query''' like below:
		+	{{cfg\|dovecot-mysql.conf\|<pre>
		+	user_query = SELECT \
		+	'%u' AS master_user, \ # <-- Add this line
		+	...
		+	</pre>}}
		+	** If you're running PostgreSQL backend, please update '''/etc/dovecot/dovecot-pgsql.conf''' (Linux or OpenBSD) or '''/usr/local/etc/dovecot/dovecot-pgsql.conf''', add ''''%u' AS master_user''' in '''user_query''' like below:
		+	{{cfg\|dovecot-mysql.conf\|<pre>
		+	user_query = SELECT \
		+	'%u' AS master_user, \ # <-- Add this line
		+	...
	</pre>}}		</pre>}}

ZhangHuangbin: /* Steps for Dovecot-2 */

ZhangHuangbin — Wed, 13 Mar 2013 13:37:34 GMT

Steps for Dovecot-2

← Older revision		Revision as of 13:37, 13 March 2013
Line 7:		Line 7:

	= Steps for Dovecot-2 =		= Steps for Dovecot-2 =
-	*Please append below lines in your Dovecot config file: '''dovecot.conf'''. it should be '''/etc/dovecot/dovecot.conf''' or '''/usr/local/etc/dovecot/dovecot.conf''' (FreeBSD).	+	*Please append below lines in your Dovecot config file: '''dovecot.conf'''. it should be '''/etc/dovecot/dovecot.conf''' (Linux or OpenBSD) or '''/usr/local/etc/dovecot/dovecot.conf''' (FreeBSD).
	{{cfg\|dovecot.conf\|<pre>		{{cfg\|dovecot.conf\|<pre>
	# Master user.		# Master user.

ZhangHuangbin: /* Steps for Dovecot-1 */

ZhangHuangbin — Fri, 22 Feb 2013 14:15:14 GMT

Steps for Dovecot-1

← Older revision		Revision as of 14:15, 22 February 2013
Line 44:		Line 44:
	* Please append below line in your Dovecot config file: '''dovecot.conf'''. it should be '''/etc/dovecot.conf''' or '''/usr/local/etc/dovecot.conf''' (FreeBSD).		* Please append below line in your Dovecot config file: '''dovecot.conf'''. it should be '''/etc/dovecot.conf''' or '''/usr/local/etc/dovecot.conf''' (FreeBSD).
	{{cfg\|dovecot.conf\|<pre>		{{cfg\|dovecot.conf\|<pre>
		+	# Master user.
		+	# Master users are able to log in as other users. It's also possible to
		+	# directly log in as any user using a master password, although this isn't
		+	# recommended.
		+	# Reference: http://wiki1.dovecot.org/Authentication/MasterUsers
	auth_master_user_separator = *		auth_master_user_separator = *
	</pre>}}		</pre>}}

ZhangHuangbin at 14:07, 22 February 2013

ZhangHuangbin — Fri, 22 Feb 2013 14:07:55 GMT

← Older revision		Revision as of 14:07, 22 February 2013
Line 63:		Line 63:
	{{cmd\|<pre>		{{cmd\|<pre>
	# touch /etc/dovecot-master-user-password		# touch /etc/dovecot-master-user-password
-	# chown ~~dovecot~~:~~dovecot~~ /etc/dovecot-master-user-password	+	# chown vmail:vmail /etc/dovecot-master-user-password
	# chmod 0500 /etc/dovecot-master-user-password		# chmod 0500 /etc/dovecot-master-user-password

ZhangHuangbin: /* Summary */

ZhangHuangbin — Fri, 22 Feb 2013 13:58:01 GMT

Summary

← Older revision		Revision as of 13:58, 22 February 2013
Line 4:		Line 4:
	This tutorial describes how to enable Dovecot Master User in Dovecot-1.2 or Dovecot-2.x. Please visit Dovecot wiki page for more details about Master User:		This tutorial describes how to enable Dovecot Master User in Dovecot-1.2 or Dovecot-2.x. Please visit Dovecot wiki page for more details about Master User:
	* Dovecot-2: http://wiki2.dovecot.org/Authentication/MasterUsers		* Dovecot-2: http://wiki2.dovecot.org/Authentication/MasterUsers
-	* Dovecot-1: http://~~wiki~~.dovecot.org/Authentication/MasterUsers	+	* Dovecot-1: http://wiki1.dovecot.org/Authentication/MasterUsers

	= Steps for Dovecot-2 =		= Steps for Dovecot-2 =

ZhangHuangbin: /* Test Master User */

ZhangHuangbin — Fri, 22 Feb 2013 13:57:11 GMT

Test Master User

← Older revision		Revision as of 13:57, 22 February 2013
Line 81:		Line 81:
	= Test Master User =		= Test Master User =
	You can now login to webmail by specifying both the master username and the login username in the same username field. For example, login to user "my_user@domain.com" with username '''my_user@domain.com*master_user''' and password '''master_password'''.		You can now login to webmail by specifying both the master username and the login username in the same username field. For example, login to user "my_user@domain.com" with username '''my_user@domain.com*master_user''' and password '''master_password'''.
		+
		+	If it doesn't work for you, please enable debug mode in Dovecot and paste related log in our support forum: http://www.iredmail.org/forum/
		+	{{cfg\|dovecot.conf\|<pre>
		+	mail_debug = yes
		+	auth_verbose = yes
		+	auth_debug = yes
		+	auth_debug_passwords = yes
		+	</pre>}}

ZhangHuangbin at 13:55, 22 February 2013

ZhangHuangbin — Fri, 22 Feb 2013 13:55:32 GMT

← Older revision		Revision as of 13:55, 22 February 2013
Line 32:		Line 32:

	'''WARNING''':		'''WARNING''':
-	* If you have '''auth_default_realm = domain.com''' in dovecot.conf, the master user name will be rewritten to '''master_user@domain.com''' if it's not a valid email address.	+	* If you have '''auth_default_realm = domain.com''' in dovecot.conf, the master user name will be rewritten to '''master_user@domain.com''' if it's not a valid email address, and authentication will fail. Please either use a full email address as master user, or disable '''auth_default_realm''' setting.
	* User name '''master_user''' and password '''master_password''' is just an example, please always choose a different name and password. Using random strings is a good choice. You can get random string with below command (replace '15' by a larger integer if you want longer string):		* User name '''master_user''' and password '''master_password''' is just an example, please always choose a different name and password. Using random strings is a good choice. You can get random string with below command (replace '15' by a larger integer if you want longer string):
	{{cmd\|<pre>		{{cmd\|<pre>
Line 70:		Line 70:

	'''WARNING''':		'''WARNING''':
-	* If you have '''auth_default_realm = domain.com''' in dovecot.conf, the master user name will be rewritten to '''master_user@domain.com''' if it's not a valid email address.	+	* If you have '''auth_default_realm = domain.com''' in dovecot.conf, the master user name will be rewritten to '''master_user@domain.com''' if it's not a valid email address, and authentication will fail. Please either use a full email address as master user, or disable '''auth_default_realm''' setting.
	* User name '''master_user''' and password '''master_password''' is just an example, please always choose a different name and password. Using random strings is a good choice. You can get random string with below command (replace '15' by a larger integer if you want longer string):		* User name '''master_user''' and password '''master_password''' is just an example, please always choose a different name and password. Using random strings is a good choice. You can get random string with below command (replace '15' by a larger integer if you want longer string):
	{{cmd\|<pre>		{{cmd\|<pre>

ZhangHuangbin: /* Steps for Dovecot-1 */

ZhangHuangbin — Fri, 22 Feb 2013 13:53:56 GMT

Steps for Dovecot-1

← Older revision		Revision as of 13:53, 22 February 2013
Line 63:		Line 63:
	{{cmd\|<pre>		{{cmd\|<pre>
	# touch /etc/dovecot-master-user-password		# touch /etc/dovecot-master-user-password
		+	# chown dovecot:dovecot /etc/dovecot-master-user-password
		+	# chmod 0500 /etc/dovecot-master-user-password
		+
	# htpasswd -b /etc/dovecot-master-user-password master_user master_password		# htpasswd -b /etc/dovecot-master-user-password master_user master_password
	</pre>}}		</pre>}}