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 [2014/10/31 07:43]
Zoltan
wiki:guides:admins:enabling_email_in_easa [2017/04/27 04:26] (current)
Brian Collins
Line 1: Line 1:
-====== ​Enabling ​Email in EASA ======+====== ​Enable ​Email in EASA ======
  
-To enable the sending of email messages ​from the EASA Serveryou need to specify the connection parameters to an SMTP server ​for EASA to useThe SMTP server settings are entered on the **Email** page found under the **Configure** menu while in **Administrator** mode. The list of server settings found on this page is as follows:+Allow an **EASA Server** to send email messages, ​ by specifying ​SMTP server ​parameters.
  
-  ​* **Outgoing Mail Server (SMTP)** - Name of SMTP server for EASA to use to send e-mail messages.+Go to: 
 +  ​* **EASA->Set Mode->​Administrator->​Configure->​Email**
  
-  ​* **Port Number (Optional)** - Set the port number used by the SMTP server connection, if not the default of 25.+Set: 
 +    * **Outgoing Mail Server (SMTP)** - Name of SMTP server for EASA to use to send e-mail messages. 
 +    ​* **Port Number (Optional)** - Set the port number used by the SMTP server connection, default->​**25**. 
 +    * **User Name (Optional)** - User Name used to authenticate on the SMTP server, if needed. 
 +    * **Password (Optional)** - Password used to authenticate on the SMTP server, if needed. 
 +    * **Encryption (Optional)** - Select encryption method, if not default of None.
  
-  * **User Name (Optional)** - User Name used to authenticate on the SMTP server, if needed.+Check these settings with a test email message from this page.
  
-  ​* **Password (Optional)** ​Password used to authenticate on the SMTP server, if needed.+These settings will be stored in the file: 
 +  ​ ** <​SERVERDATA>​\easa-share\naming\mail\server.xml**
  
-  * **Encryption (Optional)** ​Select encryption method, if not default of None.+---- 
 +===== Exchange SMTP Server Caveat=====
  
-You can send test email message from this screen in order to check that the settings are correct.+**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>​

Page Tools