Configuring a different mail Socket Factory

By default HCL Commerce mail uses javax.net.ssl.SSLSocketFactory for its Socket Factory. If you use a third-party mail service like Amazon Web Services or Microsoft Office 365, you might need to change the Socket Factory to javax.net.SocketFactory.

Procedure

Navigate to the WAS_installdir/lib/ directory.
Open the JCAEmailConnectionRequestInfo.properties properties file in a text editor. If it does not exist, create it.
Update the configuration to suit your requirements.
For a list of possible JavaMail configuration parameters, see the package description of com.sun.mail.smtp: Package com.sun.mail.smtp.
For example, to change the Socket Factory to javax.net.SocketFactory, include the following line in your properties:
```
mail.smtp.socketFactory.class=javax.net.SocketFactory
```
Save and close the file.

Restart the HCL Commerce Java virtual machine for the changes to take effect.

Note: The following exception can be observed in the logs if the incorrect socketFactory.class set:

Caused by: javax.mail.MessagingException: Exception reading response;
nested exception is:
javax.net.ssl.SSLException: Unrecognized SSL message, plaintext connection?
at com.sun.mail.smtp.SMTPTransport.readServerResponse(SMTPTransport.java:1090)
at com.sun.mail.smtp.SMTPTransport.openServer(SMTPTransport.java:986)
at com.sun.mail.smtp.SMTPTransport.protocolConnect(SMTPTransport.java:197)
at javax.mail.Service.connect(Service.java:313)
at javax.mail.Service.connect(Service.java:172)
at javax.mail.Service.connect(Service.java:121)
at com.sun.mail.smtp.SMTPTransport.connect(SMTPTransport.java:104)
at com.ibm.commerce.messaging.adapters.jcaemail.JCAEmailManagedConnection.init(JCAEmailManagedConnection.java:200)

Results

The Socket Factory and its settings are changed to the ones specified in the properties file.