New tutorial: howto/iredadmin-pro.default.password.policy.md.

2014-12-03 20:35:06 +08:00 · 2014-12-03 20:35:06 +08:00 · 57932d1c0d
parent 13b140b56e
commit 57932d1c0d
5 changed files with 79 additions and 7 deletions
--- a/README.md
+++ b/README.md
@ -21,6 +21,7 @@ We're migrating [old wiki documents](http://www.iredmail.org/wiki) to Markdown f
 * [Allow user to send email without authentication](https://bitbucket.org/zhb/docs.iredmail.org/src/default/howto/allow.user.to.send.email.without.authentication.md)
 * [Force mail user to change password in 90 days](https://bitbucket.org/zhb/docs.iredmail.org/src/default/howto/force.user.to.change.password.md)
 * [Ignore Trash folder in mailbox quota](https://bitbucket.org/zhb/docs.iredmail.org/src/default/howto/ignore.trash.folder.in.quota.md)
+* [iRedAdmin-Pro: Default password restrictions](https://bitbucket.org/zhb/docs.iredmail.org/src/default/howto/iredadmin-pro.default.password.policy.md)
 * [LDAP: Add an alias domain](https://bitbucket.org/zhb/docs.iredmail.org/src/default/howto/ldap.add.alias.domain.md)
 * [LDAP: Add a mail alias account](https://bitbucket.org/zhb/docs.iredmail.org/src/default/howto/ldap.add.mail.alias.md)
 * [LDAP: Add a mail list account](https://bitbucket.org/zhb/docs.iredmail.org/src/default/howto/ldap.add.mail.list.md)
--- a/TODO.md
+++ b/TODO.md
@ -30,15 +30,8 @@

 * ~~ http://www.iredmail.org/wiki/index.php?title=Integration/Active.Directory.iRedMail ~~

-# New
-
-* ~~Use same DKIM PEM file for all mail domains.~~
-* ~~ How to sign DKIM signature on sent emails for new mail domain. mention how
-  to use one DKIM key for all domains. ~~
-
 # wiki FAQ

-* http://www.iredmail.org/wiki/index.php?title=Addition/MySQL/Catch-all
 * http://www.iredmail.org/wiki/index.php?title=IRedAdmin-Pro/FAQ/change.default.password.policy
 * http://www.iredmail.org/wiki/index.php?title=IRedMail/FAQ/Backup
 * http://www.iredmail.org/forum/topic1968-enabling-ipv6-for-your-iredmail-postfixdovecot.html
@ -56,11 +49,16 @@

 # Howto

+* ~~Use same DKIM PEM file for all mail domains.~~
+* ~~ How to sign DKIM signature on sent emails for new mail domain. mention how
+  to use one DKIM key for all domains. ~~
+
 * ~~ http://www.iredmail.org/wiki/index.php?title=IRedMail/FAQ/Reset.password.for.mail.user ~~
 * ~~http://www.iredmail.org/wiki/index.php?title=IRedMail/FAQ/LDAP/Monitor.Incoming.and.Outgoing.Mails.with.BCC~~
 * ~~http://www.iredmail.org/wiki/index.php?title=IRedMail/FAQ/LDAP/Turn.On.Debug.Mode.In.OpenLDAP~~
 * ~~ http://www.iredmail.org/wiki/index.php?title=IRedMail/FAQ/Quarantining.Clean.Mail ~~
 * ~~ http://www.iredmail.org/wiki/index.php?title=IRedMail/FAQ/Quarantining.SPAM ~~
+* ~~ http://www.iredmail.org/wiki/index.php?title=Addition/MySQL/Catch-all ~~

 # Migration

--- a/howto/iredadmin-pro.default.password.policy.md
+++ b/howto/iredadmin-pro.default.password.policy.md
@ -0,0 +1,26 @@
+# iRedAdmin-Pro: Default password restrictions
+
+iRedAdmin-Pro has some default password restrictions, you can find default
+settings in file `libs/default_settings.py`. If you want to change them, please
+copy the parameters to iRedAdmin-Pro config file `settings.py` then update its
+value. Restarting Apache/Nginx web service is required. 
+
+```
+# default password restriction setting in file: libs/default_settings.py
+
+# Special characters which can be used in password.
+PASSWORD_SPECIAL_CHARACTERS = """#$%&'"*+-,.:;!<=>?@[]/\(){}^_`~"""
+
+# Must contain at least one letter, one uppercase letter, one number, one special character
+PASSWORD_HAS_LETTER = True
+PASSWORD_HAS_UPPERCASE = True
+PASSWORD_HAS_NUMBER = True
+PASSWORD_HAS_SPECIAL_CHAR = True
+```
+
+For example, if you don't want to enforce upper case in password, set below
+parameter in iRedAdmin-Pro config file `settings.py`:
+
+```
+PASSWORD_HAS_UPPERCASE = False
+```
--- a/html/index.html
+++ b/html/index.html
@ -36,6 +36,7 @@
 <li><a href="allow.user.to.send.email.without.authentication.html">Allow user to send email without authentication</a></li>
 <li><a href="force.user.to.change.password.html">Force mail user to change password in 90 days</a></li>
 <li><a href="ignore.trash.folder.in.quota.html">Ignore Trash folder in mailbox quota</a></li>
+<li><a href="iredadmin-pro.default.password.policy.html">iRedAdmin-Pro: Default password restrictions</a></li>
 <li><a href="ldap.add.alias.domain.html">LDAP: Add an alias domain</a></li>
 <li><a href="ldap.add.mail.alias.html">LDAP: Add a mail alias account</a></li>
 <li><a href="ldap.add.mail.list.html">LDAP: Add a mail list account</a></li>
--- a/html/iredadmin-pro.default.password.policy.html
+++ b/html/iredadmin-pro.default.password.policy.html
@ -0,0 +1,46 @@
+<html>
+    <head>
+        <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
+        <title>iRedAdmin-Pro: Default password restrictions</title>
+        <link href="./css/markdown.css" rel="stylesheet"></head>
+    </head>
+    <body>
+    
+    <div id="navigation">
+        <a href="http://www.iredmail.org" target="_blank">iRedMail web site</a>
+    
+        // <a href="./index.html">Document Index</a>
+    </div><h1 id="iredadmin-pro-default-password-restrictions">iRedAdmin-Pro: Default password restrictions</h1>
+<p>iRedAdmin-Pro has some default password restrictions, you can find default
+settings in file <code>libs/default_settings.py</code>. If you want to change them, please
+copy the parameters to iRedAdmin-Pro config file <code>settings.py</code> then update its
+value. Restarting Apache/Nginx web service is required. </p>
+<pre><code># default password restriction setting in file: libs/default_settings.py
+
+# Special characters which can be used in password.
+PASSWORD_SPECIAL_CHARACTERS = &quot;&quot;&quot;#$%&amp;'&quot;*+-,.:;!&lt;=&gt;?@[]/\(){}^_`~&quot;&quot;&quot;
+
+# Must contain at least one letter, one uppercase letter, one number, one special character
+PASSWORD_HAS_LETTER = True
+PASSWORD_HAS_UPPERCASE = True
+PASSWORD_HAS_NUMBER = True
+PASSWORD_HAS_SPECIAL_CHAR = True
+</code></pre>
+
+<p>For example, if you don't want to enforce upper case in password, set below
+parameter in iRedAdmin-Pro config file <code>settings.py</code>:</p>
+<pre><code>PASSWORD_HAS_UPPERCASE = False
+</code></pre><br /><p style="text-align: center;">If you found something wrong
+in this document, please do
+<a href="http://www.iredmail.org/contact.html">contact us</a> to fix it.</p><p style="text-align: center; color: grey;">This tutorial is published under a <a href="http://creativecommons.org/licenses/by-nd/3.0/us/" target="_blank">CC BY-ND 3.0</a> license.<!-- Google Analytics -->
+<script type="text/javascript">
+    var gaJsHost = (("https:" == document.location.protocol) ? "https://ssl." : "http://www.");
+    document.write(unescape("%3Cscript src='" + gaJsHost + "google-analytics.com/ga.js' type='text/javascript'%3E%3C/script%3E"));
+</script>
+<script type="text/javascript">
+    try {
+        var pageTracker = _gat._getTracker("UA-3293801-14");
+        pageTracker._trackPageview();
+    } catch(err) {}
+</script>
+</body></html>