james-server-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From btell...@apache.org
Subject [11/13] james-project git commit: JAMES-2394 Add a missing JMAP configuration page
Date Thu, 05 Jul 2018 02:01:33 GMT
JAMES-2394 Add a missing JMAP configuration page


Project: http://git-wip-us.apache.org/repos/asf/james-project/repo
Commit: http://git-wip-us.apache.org/repos/asf/james-project/commit/4c27a8a9
Tree: http://git-wip-us.apache.org/repos/asf/james-project/tree/4c27a8a9
Diff: http://git-wip-us.apache.org/repos/asf/james-project/diff/4c27a8a9

Branch: refs/heads/master
Commit: 4c27a8a9f066906080c164b10defc2cbfdeecfc2
Parents: b44df19
Author: benwa <btellier@linagora.com>
Authored: Thu May 10 17:25:59 2018 +0700
Committer: benwa <btellier@linagora.com>
Committed: Thu Jul 5 08:59:57 2018 +0700

----------------------------------------------------------------------
 src/site/site.xml                    |  1 +
 src/site/xdoc/server/config-jmap.xml | 63 +++++++++++++++++++++++++++++++
 src/site/xdoc/server/config.xml      |  7 +++-
 3 files changed, 70 insertions(+), 1 deletion(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/james-project/blob/4c27a8a9/src/site/site.xml
----------------------------------------------------------------------
diff --git a/src/site/site.xml b/src/site/site.xml
index 1ed9248..89e4eb2 100644
--- a/src/site/site.xml
+++ b/src/site/site.xml
@@ -123,6 +123,7 @@
                         <item name="SMTP LMTP" href="/server/config-smtp-lmtp.html" />
                         <item name="POP3" href="/server/config-pop3.html" />
                         <item name="IMAP4" href="/server/config-imap4.html" />
+                        <item name="JMAP" href="/server/config-jmap.html" />
                         <item name="Mailet Container" href="/server/config-mailetcontainer.html"
/>
                         <item name="FetchMail" href="/server/config-fetchmail.html" />
                         <item name="SSL/TLS" href="/server/config-ssl-tls.html" />

http://git-wip-us.apache.org/repos/asf/james-project/blob/4c27a8a9/src/site/xdoc/server/config-jmap.xml
----------------------------------------------------------------------
diff --git a/src/site/xdoc/server/config-jmap.xml b/src/site/xdoc/server/config-jmap.xml
new file mode 100644
index 0000000..88addd9
--- /dev/null
+++ b/src/site/xdoc/server/config-jmap.xml
@@ -0,0 +1,63 @@
+<?xml version="1.0"?>
+<!--
+  Licensed to the Apache Software Foundation (ASF) under one
+  or more contributor license agreements.  See the NOTICE file
+  distributed with this work for additional information
+  regarding copyright ownership.  The ASF licenses this file
+  to you under the Apache License, Version 2.0 (the
+  "License"); you may not use this file except in compliance
+  with the License.  You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+  Unless required by applicable law or agreed to in writing,
+  software distributed under the License is distributed on an
+  "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+  KIND, either express or implied.  See the License for the
+  specific language governing permissions and limitations
+  under the License.
+-->
+<document>
+
+    <properties>
+        <title>Apache James Server 3 - JMAP Configuration</title>
+    </properties>
+
+    <body>
+
+        <section name="JMAP configuration">
+
+            <p><a href="https://jmap.io/">JMAP</a>  is intended to be a
new standard for email clients to connect to mail
+                stores. It therefore intends to primarily replace IMAP + SMTP submission.
It is also designed to be more
+                generic. It does not replace MTA-to-MTA SMTP transmission.</p>
+
+            <p>Cassandra Guice proposes a JMAP implementation.</p>
+
+            <subsection name="jmap.properties">
+
+                <p>Consult <a href="https://github.com/apache/james-project/blob/master/dockerfiles/run/guice/cassandra/destination/conf/jmap.properties">jmap.properties</a>
in GIT to get some examples and hints.</p>
+
+                <br/>
+
+                <dl>
+                    <dt><strong>enabled</strong></dt>
+                    <dd>true/false. Governs whether JMAP should be enabled</dd>
+
+                    <dt><strong>tls.keystoreURL</strong></dt>
+                    <dd>Keystore to be used for generating authentication tokens for
password authentication mechanism.
+                    This should not be the same keystore than the ones used by TLS based
protocols.</dd>
+
+                    <dt><strong>tls.secret</strong></dt>
+                    <dd>Password used to read the keystore</dd>
+
+                    <dt><strong>jwt.publickeypem.url</strong></dt>
+                    <dd>Optional. JWT tokens allows request to bypass authentication</dd>
+                </dl>
+
+            </subsection>
+
+        </section>
+
+    </body>
+
+</document>

http://git-wip-us.apache.org/repos/asf/james-project/blob/4c27a8a9/src/site/xdoc/server/config.xml
----------------------------------------------------------------------
diff --git a/src/site/xdoc/server/config.xml b/src/site/xdoc/server/config.xml
index 807b22d..073c97e 100644
--- a/src/site/xdoc/server/config.xml
+++ b/src/site/xdoc/server/config.xml
@@ -38,7 +38,7 @@
     <p>Please note that the configuration is dependent of the wiring you have chosen.
Some configuration files are specific to
     some back-ends, to some protocols. Please also note that some configuration files are
not required for Guice. In this
     case, it will be specified.</p>
-       
+
     <p>In every configuration files, you can use the following notation to use an environment
variable: <code>${env:MY_VAR}</code>.
     If <code>MY_VAR</code> exists, it will be replaced by the matching environment
variable.
     If it does not, <code>${env:MY_VAR}</code> will be kept as is.</p>
@@ -123,6 +123,11 @@
         <td><a href="config-fetchmail.html">FetchMail Configuration (Spring only)</a></td>
         <td></td>
       </tr>
+      <tr>
+        <td><a href="https://github.com/apache/james-project/blob/master/dockerfiles/run/guice/cassandra/destination/conf/jmap.properties">jmap.properties</a></td>
+        <td><a href="config-jmap.html">JMAP Configuration (Guice only)</a></td>
+        <td></td>
+      </tr>
 
     </table>
     


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


Mime
View raw message