You are viewing a plain text version of this content. The canonical link for it is here.
Posted to server-dev@james.apache.org by rc...@apache.org on 2019/11/26 10:41:24 UTC

[james-project] 03/06: JAMES-2949 Update documentation accordingly

This is an automated email from the ASF dual-hosted git repository.

rcordier pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/james-project.git

commit f6cda852d5e15f33b50087e5368d8f4aa2637c96
Author: Raphael Ouazana <ra...@linagora.com>
AuthorDate: Thu Nov 21 12:21:30 2019 +0100

    JAMES-2949 Update documentation accordingly
---
 CHANGELOG.md                          |  1 +
 src/site/xdoc/server/config-users.xml |  3 +++
 upgrade-instructions.md               | 14 +++++++++++++-
 3 files changed, 17 insertions(+), 1 deletion(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 5baf925..b6abb79 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -21,6 +21,7 @@ of tasks being currently executed.
   - Read related [upgrade instructions](upgrade-instructions.md)
 - JAMES-2855 Multiple library/plugin/docker images/build tool upgrades
 - By default the cassandra keyspace creation by James is now disabled by default. This allow to have credentials limited to a keyspace. It can be enabled by setting cassandra.keyspace.create=true in the cassandra.properties file.
+- Usernames are assumed to be always lower cased. Many users recently complained about mails non received when sending to upper cased local recipients. We decided to simplify the handling of case for local recipients and users by always storing them lower cased.
   
 ### Fixed
 - JAMES-2828 & JAMES-2929 bugs affecting JDBCMailRepository usage with PostgresSQL thanks to Jörg Thomas & Sergey B
diff --git a/src/site/xdoc/server/config-users.xml b/src/site/xdoc/server/config-users.xml
index 8024dc4..5829c23 100644
--- a/src/site/xdoc/server/config-users.xml
+++ b/src/site/xdoc/server/config-users.xml
@@ -47,6 +47,9 @@
             and the domain part should be concatenated after a domain delimiter('@'). E.g. 'myuser@james.org'
         </li>
       </ul>
+      <p>
+        A user is always considered as lower cased, so 'myUser' and 'myuser' are the same user, and can be used as well as recipient local part than as login for different protocols.
+      </p>
     </subsection>
 
     <subsection name="General configuration">
diff --git a/upgrade-instructions.md b/upgrade-instructions.md
index f1b0ab3..32db72d 100644
--- a/upgrade-instructions.md
+++ b/upgrade-instructions.md
@@ -16,10 +16,22 @@ Changes to apply between 3.4.x and 3.5.x will be reported here.
 
 Change list:
 
+ - [Enforce usernames to be lower cased](#enforce-usernames-to-be-lower-cased)
+ - [Cassandra keyspace creation configuration](#cassandra-keyspace-creation-configuration)
  - [UsersFileRepository](#usersfilerepository)
  - [ElasticSearch performance enhancements](#elasticsearch-performance-enhancements)
  - [JAMES-2703 Post 3.4.0 release removals](#james-2703-post-340-release-removals)
- - [Cassandra keyspace creation configuration](#cassandra-keyspace-creation-configuration)
+
+#### Enforce usernames to be lower cased
+
+Date 21/11/2019
+
+SHA-1 xxxxxxxxx
+
+JIRA: https://issues.apache.org/jira/browse/JAMES-2949
+
+Many users recently complained about mails non received when sending to upper cased local recipients. We decided to simplify the handling of case for local recipients and users by always storing them lower cased.
+Now all the users repositories are storing user in lower case to ensure that. If you previously used to store users in a case sensitive way (which is very unlikely as it is broking delivery), you could need to update your user database to lower case all your users.
 
 #### Cassandra keyspace creation configuration
 


---------------------------------------------------------------------
To unsubscribe, e-mail: server-dev-unsubscribe@james.apache.org
For additional commands, e-mail: server-dev-help@james.apache.org