Adding upstream version 1:2.3.19.1+dfsg1.upstream/1%2.3.19.1+dfsg1upstream

Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>

1 files changed, 22 insertions, 0 deletions

diff --git a/doc/wiki/PasswordDatabase.ExtraFields.NoLogin.txt b/doc/wiki/PasswordDatabase.ExtraFields.NoLogin.txt
new file mode 100644
index 0000000..fa7ea03
--- /dev/null
+++ b/doc/wiki/PasswordDatabase.ExtraFields.NoLogin.txt
@@ -0,0 +1,22 @@
+Nologin extra field
+===================
+
+User isn't allowed to log in even if the password matches. Commonly used with
+<proxying> [PasswordDatabase.ExtraFields.Proxy.txt] and <login referrals>
+[PasswordDatabase.ExtraFields.Host.txt], but may also be used standalone. One
+way to use this would be perhaps:
+
+ * 'nologin=y'
+ * 'reason=System is being upgraded, please try again later.'
+
+Unfortunately many clients don't show the reason to the user at all and just
+assume that the password was given wrong, so it might not be a good idea to use
+this unless the system will be down for days and you don't have a better way to
+notify the users.
+
+Note: if you want to entirely block the user from logging in (i.e. account is
+suspended), with no IMAP referral information provided, you must ensure that
+neither 'proxy' nor 'host' are defined as one of the passdb extra fields.  The
+order of preference is:'proxy', 'host', then 'nologin'.
+
+(This file was created from the wiki on 2019-06-19 12:42)