From 13d3b5e5ebe4d53a12b1dfc6dfef802abfce4a9b Mon Sep 17 00:00:00 2001
From: Zhang Huangbin
Date: Fri, 6 Nov 2015 23:02:46 +0800
Subject: [PATCH] New: en_US/howto/authenticate.without.domain.name.md.
---
.../howto/authenticate.without.domain.name.md | 39 +++++++++++++
en_US/integrations/0-sogo-centos-6-mysql.md | 10 ++++
.../integrations/0-sogo-centos-6-openldap.md | 10 ++++
en_US/integrations/_links.md | 5 --
html/authenticate.without.domain.name.html | 57 +++++++++++++++++++
html/index.html | 8 +--
html/sogo-centos-6-mysql.html | 18 +++++-
html/sogo-centos-6-openldap.html | 18 +++++-
8 files changed, 151 insertions(+), 14 deletions(-)
create mode 100644 en_US/howto/authenticate.without.domain.name.md
create mode 100644 html/authenticate.without.domain.name.html
diff --git a/en_US/howto/authenticate.without.domain.name.md b/en_US/howto/authenticate.without.domain.name.md
new file mode 100644
index 00000000..678f116c
--- /dev/null
+++ b/en_US/howto/authenticate.without.domain.name.md
@@ -0,0 +1,39 @@
+# Authenticate without domain part in email address
+
+With default settings, client must use full email address as username for
+POP3/IMAP/SMTP/webmail login, if you want to login without domain name part in
+email address, please follow below steps.
+
+* Open Dovecot config file `/etc/dovecot/dovecot.conf` (Linux/OpenBSD) or
+ `/usr/local/etc/dovecot/dovecot.conf` (FreeBSD), find parameter
+ `auth_default_realm`, set the domain name you want to allow user to login
+ without domain name part in email address. For example:
+
+```
+auth_default_realm = mydomain.com
+```
+
+ Restarting Dovecot is required. After restarted Dovecot, user logins as
+ `john.smith` will be rewritten to `john.smith@mydomain.com` by Dovecot.
+ This works for POP3/IMAP/SMTP services.
+
+* [OPTIONAL] Open Roundcube webmail
+ [config file `config/main.inc.php`](./file.locations.html#roundcube-webmail),
+ find parameter `$config['username_domain']`, list your domain name
+ in this parameter. For example:
+
+```
+// Automatically add this domain to user names for login
+// Only for IMAP servers that require full e-mail addresses for login
+// Specify an array with 'host' => 'domain' values to support multiple hosts
+// Supported replacement variables:
+// %h - user's IMAP hostname
+// %n - hostname ($_SERVER['SERVER_NAME'])
+// %t - hostname without the first part
+// %d - domain (http hostname $_SERVER['HTTP_HOST'] without the first part)
+// %z - IMAP domain (IMAP hostname without the first part)
+// For example %n = mail.domain.tld, %t = domain.tld
+$config['username_domain'] = 'mydomain.com';
+```
+
+ Restarting Apache web server is recommended.
diff --git a/en_US/integrations/0-sogo-centos-6-mysql.md b/en_US/integrations/0-sogo-centos-6-mysql.md
index 932979a9..9e5057a6 100644
--- a/en_US/integrations/0-sogo-centos-6-mysql.md
+++ b/en_US/integrations/0-sogo-centos-6-mysql.md
@@ -349,3 +349,13 @@ word `SOGo` is case-sensitive), you can login with your email account credential
Please check our documents [here](./index.html#configure-mail-client-applications)
to configure your mail clients or mobile devices.
+
+
+## References
+
+* [SOGo web site](http://sogo.nu)
+* Outlook plugins:
+
+ * [Outlook CalDav Synchronizer](https://github.com/aluxnimm/outlookcaldavsynchronizer)
+
+ > Outlook Plugin, which synchronizes events, tasks and contacts(beta) between Outlook and Google, SOGo, Horde or any other CalDAV or CardDAV server. Supported Outlook versions are 2016, 2013, 2010 and 2007.
diff --git a/en_US/integrations/0-sogo-centos-6-openldap.md b/en_US/integrations/0-sogo-centos-6-openldap.md
index 4b86134e..495692e0 100644
--- a/en_US/integrations/0-sogo-centos-6-openldap.md
+++ b/en_US/integrations/0-sogo-centos-6-openldap.md
@@ -365,3 +365,13 @@ word `SOGo` is case-sensitive), you can login with your email account credential
Please check our documents [here](./index.html#configure-mail-client-applications)
to configure your mail clients or mobile devices.
+
+
+## References
+
+* [SOGo web site](http://sogo.nu)
+* Outlook plugins:
+
+ * [Outlook CalDav Synchronizer](https://github.com/aluxnimm/outlookcaldavsynchronizer)
+
+ > Outlook Plugin, which synchronizes events, tasks and contacts(beta) between Outlook and Google, SOGo, Horde or any other CalDAV or CardDAV server. Supported Outlook versions are 2016, 2013, 2010 and 2007.
diff --git a/en_US/integrations/_links.md b/en_US/integrations/_links.md
index 4830cd85..8d82f04c 100644
--- a/en_US/integrations/_links.md
+++ b/en_US/integrations/_links.md
@@ -11,8 +11,3 @@ Documents contributed by iRedMail users:
* [Integrate OpenVPN in iRedMail with OpenLDAP](https://www.howtoforge.com/using-iredmail-and-openvpn-for-virtual-email-hosting-and-vpn-services-centos-5.4), Howtoforge tutorial.
* [Integrate Ejabberd in iRedMail with OpenLDAP](./ejabberd.openldap.ubuntu.html)
* [Virtual Mail And FTP Hosting With iRedMail And Pure-FTPd](./pureftpd.openldap.centos.html)
-* SOGo Groupware
- * [CentOS 6.5 + iRedMail (OpenLDAP backend) + SOGo Groupware](http://www.iredmail.org/forum/topic6604-iredmail-support-iredmail-ldap-sogo-centos.html). Contributed by kospel. 2014-04-18
- * [Ubuntu 11.04 (oneiric) + iRedMail (MySQL backend) + SOGo Groupware](http://www.wynni.com/howto-iredmail-sogo-mysql-authentication-ubuntu-11-10-oneiric-ocelot/). Contributed by Wynni, 2012-05-12.
- * [Debian + iRedMail (OpenLDAP backend) + SOGo Groupware](http://www.iredmail.org/forum/topic2071-debian-iredmail-sogo-installation-guide.html). Contributed by Luciano Pedron, 2011-06-04.
- * [Install iRedMail with LDAP backend and SOGo as Groupware](http://conheotiensinh.blogspot.com/2009/12/install-iredmail-use-ldap-and-groupware.html). Contributed by conheotiensinh
diff --git a/html/authenticate.without.domain.name.html b/html/authenticate.without.domain.name.html
new file mode 100644
index 00000000..523d9c21
--- /dev/null
+++ b/html/authenticate.without.domain.name.html
@@ -0,0 +1,57 @@
+
+
+
+ Authenticate without domain part in email address
+
+
+
+
+
With default settings, client must use full email address as username for
+POP3/IMAP/SMTP/webmail login, if you want to login without domain name part in
+email address, please follow below steps.
+
+
Open Dovecot config file /etc/dovecot/dovecot.conf (Linux/OpenBSD) or
+ /usr/local/etc/dovecot/dovecot.conf (FreeBSD), find parameter
+ auth_default_realm, set the domain name you want to allow user to login
+ without domain name part in email address. For example:
+
+
auth_default_realm = mydomain.com
+
+
+
Restarting Dovecot is required. After restarted Dovecot, user logins as
+ john.smith will be rewritten to john.smith@mydomain.com by Dovecot.
+ This works for POP3/IMAP/SMTP services.
+
+
[OPTIONAL] Open Roundcube webmail
+ config file config/main.inc.php,
+ find parameter $config['username_domain'], list your domain name
+ in this parameter. For example:
+
+
// Automatically add this domain to user names for login
+// Only for IMAP servers that require full e-mail addresses for login
+// Specify an array with 'host' => 'domain' values to support multiple hosts
+// Supported replacement variables:
+// %h - user's IMAP hostname
+// %n - hostname ($_SERVER['SERVER_NAME'])
+// %t - hostname without the first part
+// %d - domain (http hostname $_SERVER['HTTP_HOST'] without the first part)
+// %z - IMAP domain (IMAP hostname without the first part)
+// For example %n = mail.domain.tld, %t = domain.tld
+$config['username_domain'] = 'mydomain.com';
+
+
+
Restarting Apache web server is recommended.
Document published under a CC BY-ND 3.0 license. If you found something wrong, please do contact us to fix it.
+
\ No newline at end of file
diff --git a/html/index.html b/html/index.html
index 330fb666..8ff3df4d 100644
--- a/html/index.html
+++ b/html/index.html
@@ -83,6 +83,7 @@ repository.