User Tools

Site Tools


Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
wiki:guides:admins:enabling_email_in_easa [2016/12/06 10:50]
Brian Collins
wiki:guides:admins:enabling_email_in_easa [2017/04/27 04:26] (current)
Brian Collins
Line 14: Line 14:
  
 Check these settings with a test email message from this page. Check these settings with a test email message from this page.
 +
 +These settings will be stored in the file:
 +  *  ** <​SERVERDATA>​\easa-share\naming\mail\server.xml**
 +
 +----
 +===== Exchange SMTP Server Caveat=====
 +
 +**Exchange** must allow anonymous access to be used as the outgoing SMTP server.
 +
 +**Exchange** may be configured for either:
 +  - TLS authentication ​
 +  - No authentication
 +
 +For each case the **server.xml** configuration file needs be manually modified, **and not reconfigured within EASA**.
 +
 +Any visit to **EASA->​Set Mode->​Administrator->​Configure->​Email** will overwrite this manual change.
 +
 +Thus an **Administrator** must not select 'send test email' but instead should **Author** a simple EASAP with an **[[ wiki:​guides:​authors:​objects:​email_action]]**.
 +
 +Below are the **server.xml** files for each case.
 +
 +  - Change **EXCHANGE-SMTP-SERVER** to the actual SMTP hostname.
 +  - Copy the file to:
 +    *  ** <​SERVERDATA>​\easa-share\naming\mail\server.xml**
 +  - Restart the EASA/Tomcat service
 +
 +----
 +====TLS authentication====
 +<file xml server.xml>​
 +<​resource name="​mail/​Session"​ type="​javax.mail.Session">​
 +  <​parameter>​
 +    <​name>​encryption</​name>​
 +    <​value>​TLS</​value>​
 +  </​parameter>​
 +  <​parameter>​
 +    <​name>​mail.smtp.host</​name>​
 +    <​value>​EXCHANGE-SMTP-SERVER</​value>​
 +  </​parameter>​
 +  <​parameter>​
 +    <​name>​factory</​name>​
 +    <​value>​com.easa.naming.EncryptedMailSessionFactory</​value>​
 +  </​parameter>​
 +  <​parameter>​
 +    <​name>​mail.smtp.starttls.enable</​name>​
 +    <​value>​false</​value>​
 +  </​parameter>​
 +  <​parameter>​
 +    <​name>​mail.smtp.auth</​name>​
 +    <​value>​false</​value>​
 +  </​parameter>​
 +</​resource>​
 +</​file>​
 +
 +----
 +====No authentication====
 +<file xml server.xml>​
 +<​resource name="​mail/​Session"​ type="​javax.mail.Session">​
 +  <​parameter>​
 +    <​name>​encryption</​name>​
 +    <​value>​none</​value>​
 +  </​parameter>​
 +  <​parameter>​
 +    <​name>​mail.smtp.port</​name>​
 +    <​value>​25</​value>​
 +  </​parameter>​
 +  <​parameter>​
 +    <​name>​mail.smtp.host</​name>​
 +    <​value>​EXCHANGE-SMTP-SERVER</​value>​
 +  </​parameter>​
 +  <​parameter>​
 +    <​name>​factory</​name>​
 +    <​value>​com.easa.naming.EncryptedMailSessionFactory</​value>​
 +  </​parameter>​
 +  <​parameter>​
 +    <​name>​mail.smtp.auth</​name>​
 +    <​value>​false</​value>​
 +  </​parameter>​
 +</​resource>​
 +</​file>​