moparisthebest
/
davmail
mirror of https://github.com/moparisthebest/davmail
1
0
Fork 0
Code Issues Releases Wiki Activity

Doc: fixes and updates on ssl setup and build 

git-svn-id: http://svn.code.sf.net/p/davmail/code/trunk@1514 3d1905a2-6b24-0410-a738-b14d5a86fcbd
This commit is contained in:
mguessan 2010-10-21 09:05:14 +00:00
parent af6afe9042
commit 51c2d3b1a0
3 changed files with 27 additions and 25 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

6
src/site/xdoc/build.xml
View File

@ -25,8 +25,10 @@
</li>
</ul>
</li>
<li>Download and unzip ant from&#x20;<a href="http://ant.apache.org/">ant.apache.org</a>,
add ant/bin full path to the PATH environment variable
<li>Check if you already have Apache Ant installed :<br/>
<source>ant -version</source><br/>
If you don't, download and unzip ant from&#x20;<a href="http://ant.apache.org/">ant.apache.org</a>,
add ant/bin full path to the PATH environment variable.
</li>
<li>Get DavMail source package from sourceforge and uncompress it:
<source>tar xvzf davmail-src-*.tgz</source>

32
src/site/xdoc/faq.xml
View File

@ -18,7 +18,7 @@
<strong>How do I create a WIRE debug log ?</strong>
</p>
<p>In DavMail trackers and forums, I often ask for a WIRE debug log. To create this
log file, you will need to change DavMail settings under the advanced tab.
log file, you will need to change DavMail settings under the Logging tab.
Set the WIRE logging category to DEBUG level.
</p>
<p>You can then reproduce your issue and send the log file to
@ -83,7 +83,7 @@
<li>Select the IIS role, then add Role Services</li>
<li>Add WebDav Publishing (both Cas server and Mailbox Server)</li>
<li>On the Mailbox server, add the ISAPI extensions Role Service to the IIS role</li>
<li>On the Default Web Site (each server) , enable WebDav</li>
<li>On the Default Web Site (each server), enable WebDav</li>
<li>Should not have to enable any additional WebDav rules</li>
<li>Install the server roles</li>
<li>Create a test mailbox (see Exchange Docs)</li>
@ -99,9 +99,13 @@
<p>
<strong>Is Exchange 2010 supported ?</strong>
</p>
<p>Currently, the answer is no. As Microsoft decided to drop WebDav support in Exchange 2010, DavMail
will not work with this new version. Experimental Exchange Web Service support compatible with
Exchange 2010 is available in subversion, but not complete yet.
<p>As Microsoft decided to drop WebDav support in Exchange 2010, I had to implement a new backend from
scratch to support the new Exchange Web Services interface. This support is still experimental,
but is working quite well. However, you still need to enable it manually in .davmail.properties
with the following line:
<br/>
<source>davmail.enableEws=true</source>
<br/>
</p>
</subsection>
@ -126,19 +130,10 @@
<p>Communication between the messaging client and DavMail is
<em>not</em>
secured by default. This is not an issue in standalone mode as all communication is local, but you
may want
to improve this in server (shared) mode.
may want to improve this in server (shared) mode.
</p>
<p>This is quite simple: you just need to get a server certificate in PKCS12 or JKS format and add it in
the key store section in DavMail settings, see&#x20;<a href="gettingstarted.html">Getting
started</a>.
You need to choose the key store type in davmail.ssl.keystoreType: PKCS12 for .p12 file and JKS for
java generated key stores. Then set the full path to your certificate file in
davmail.ssl.keystoreFile
and the certificate file password in davmail.ssl.keystorePass. You may also have a key password in
addition
to the file password, specify it in davmail.ssl.keyPass. This will switch all DavMail services to
SSL mode: POP3S/IMAPS/SMTPS/HTTPS/LDAPS.
the key store section in DavMail settings, see&#x20;<a href="sslsetup.html">SSL Setup</a>.
</p>
<p>
@ -166,8 +161,7 @@ calendar.debug.log.verbose=true]]></source>
<p>Lightning 0.9 mail notifications are broken, activate
Caldav notifications to outbox instead:
</p>
<p>Check the following parameter in Thunderbird, it should be set
to true
<p>Check the following parameter in Thunderbird, it should be set to true
</p>
<source>calendar.caldav.sched.enabled=true</source>
@ -196,7 +190,7 @@ calendar.debug.log.verbose=true]]></source>
<p>
<strong>Message deleted over IMAP still visible through OWA</strong>
</p>
<p>Message move does not exist in IMAP, thus the move is a delete followed by a create.
<p>Message move does not exist in IMAP, thus the move is a copy followed by a delete.
And a delete is not immediate with IMAP: you need to EXPUNGE the folder to actually
delete a message.
</p>

14
src/site/xdoc/sslsetup.xml
View File

@ -24,6 +24,8 @@
pkcs12 -validity 3650 -dname cn=davmailhostname.company.com,ou=davmail,o=sf,o=net
</source>
<p>Note to iPhone users: iOS does not support the default DSA algorithm, make sure you use an RSA key pair</p>
<p>Then add this keystore to DavMail settings:
</p>
<source><![CDATA[
@ -31,12 +33,16 @@ davmail.ssl.keystoreType=PKCS12
davmail.ssl.keyPass=password
davmail.ssl.keystoreFile=davmail.p12
davmail.ssl.keystorePass=password]]></source>
<p>Restart DavMail, all DavMail listeners will switch to secure mode. You will also need to enable SSL
in
client applications and manually accept the certificate as it's not signed by a trusted
Certification Authority.
<p>If your already have your keystore in JKS format, just set keystoreType to JKS in DavMail
settings. keystorePass is the password used to open the KeyStore, keyPass protects the private key
inside the KeyStore.
</p>
<p>Restart DavMail, all DavMail listeners will switch to secure mode: POP3S/IMAPS/SMTPS/HTTPS/LDAPS.
You will also need to enable SSL in client applications and manually accept the certificate as it's
not signed by a trusted Certification Authority.
</p>
</subsection>
<subsection name="DavMail to Exchange">
<p>In most cases, using https in OWA url is enough to secure communication between DavMail and Exchange.
However, with Exchange servers setup to require mutual authentication, you will have to register