06 Jun

How to activate IMAPS, the secure IMAP support on Alfresco

imap_serverStarting from Alfresco 3.2 the IMAP support has been introduced for accessing the Alfresco server. This a very interesting feature because make the users able to manage emails – and documents – directly from a mail client.

The IMAP support is extended with encryption  using SSL. Doing that, a secure communication can be achieved with a full IMAPS support.

Activating the IMAPS protocol in Alfresco is very easy, but in the real life, something should be changed in the official documentation. Waiting for the update of the official wiki we share the experimented way to do that.

As documented in the official wiki, the very first thing to do is to add some simple lines to the alfresco-global.properties file.

imap.server.enabled=true
imap.server.host=...
imap.server.imaps.enabled=true
imap.server.imaps.port=993

Unfortunately what is written about the keystore is not true in practice, and to set the proper SSL keystore in Alfresco you have to change your alfresco.sh script (for more informations about that script, read here).

Before showing the script, let’s remember that the keystore is a repository of security certificates, either authorization certificates or public key certificates – used for instance in SSL encryption. We are not going to show how to create a keystore but, if interested, let me know and I’ll tell you a lot of documentation, easy to find in the web.

Now it’s time to see the modifications to the alfresco.sh script.

export JAVA_OPTS="${JAVA_OPTS} -Djavax.net.ssl.keyStore=<absolutePath>/keystore.jks -Djavax.net.ssl.keyStorePassword=<password>"

Now restart Alfresco and your users will be able to use Alfresco’s IMAP and IMAPS.

[Thanks to Piergiorgio Lucidi for the contribution to the described solution]

3 thoughts on “How to activate IMAPS, the secure IMAP support on Alfresco

  1. Hi !
    Thanks for sharing your experience. It’s very usefull.
    But I don’t understand where should I write the line
    export JAVA_OPTS=”${JAVA_OPTS} -Djavax.net.ssl.keyStore=/keystore.jks -Djavax.net.ssl.keyStorePassword=”
    It’s on the top of the alfresco.sh’s file or at the end ?

    Thanks for reading

Leave a Reply

Your email address will not be published. Required fields are marked *

Time limit is exhausted. Please reload CAPTCHA.