How to setup Email Response Module - POP3, SMTP with Office365
9. 1. 2020
After migration of Email mailboxes into Office365 Azure cloud it is no more possible to connect to mailboxes without using a secure protocols.
Office 365 supports secure protocols SSL, TLS for both POP3 and SMTP. Siebel supports secure POP3 configuration by using external Java libraries only, the same is valid for IMAP protocol.
Sending emails using SMTP is supported for SSL or TLS with Siebel native sscmmail library. This Blog page deals with detailed description of configuration procedure for both protocols POP3 and SMTP. Blog extends Doc ID 2224128.1 and lists step by step instructions for migration mailboxes from On-Premise solution to Cloud solution.
POP3 configuration
Siebel supports POP3 over secure protocols SSL or TLS. Detailed description can be found on Oracle Support Web, in Document. How To Setup Siebel Email Response With Outlook365 or Gmail or Other Common Email Servers (Doc ID 2224128.1).
Here described all the steps to setup POP3 protocol for Email Response module in Siebel configuration.
1. Test connectivity with Office365 Emails server using OpenSSL
To test the connectivity, logon with Putty on Siebel OM server for respective environment. Then run the following command:
openssl s_client -showcerts -connect outlook.office365.com:995
There is assumption, openssl is configured on each Siebel server, another assumption is that, Siebel OM server has open firewall for port 995.
After successful connection type POP3 commands (valid POP3 user, password and command STAT for information about emails in mailbox):
USER mailbox
PASS password
STAT
This check can be done for each mailbox to see whether it was correctly migrated into O365 and if the port 995 is open between Siebel OM server and O365.
2. Test connectivity with Office365 using Java Mail Client libraries
To test the availability of Java Mail libraries on Siebel server and their connectivity to Office365, connect to Siebel OM server using Putty and run the following command.
java -Djava.class.path="/app/siebel/sieb/siebsrvr/lib/JMailClient.jar:/app/siebel/sieb/siebsrvr/classes/jakarta.mail.jar" com/siebel/scomm/emaildriver/JMailClient /u mailbox /p password /s outlook.office365.com /o 995 /r pop3s
There are two Java libraries used JMailClient.jar and jakarta.mail.jar, they should be located in directory /app/siebel/sieb/siebsrvr/lib/ or /app/siebel/sieb/siebsrvr/classes/ respectively.
According to Doc ID 2224128.1, since IP2016 the needed libraries are delivered with Siebel Pack.
The parameters of the command are /u mailbox_user, /p mailbox password, /s email_server, /o port, /r protocol
3. Set EMRJavaSubsys Java Subsystem parameters
Siebel library sscmmail uses for POP3 protocol over secure channel above mentioned libraries. To allow this, one must first configure EMRJavaSubsys Profile in Administration - Server Configuration, Enterprises, Profile Configuration.
Navigate to Administration - Server Configuration, Enterprises, Profile Configuration, create new Profile with following attributes:
Name: EMRJavaSubsys
Alias: EMRJavaSubsys
Subsystem Type: JVMSubSys
Desciption: Email Response Internet SMTP/POP3 Server driver named subsystem
For the Subsystem following parameters must be set:
JVM Classpath : /app/siebel/sieb/siebsrvr/lib/JMailClient.jar:/app/siebel/sieb/siebsrvr/classes/jakarta.mail.jar
JVM DLL Name: /app/siebel/sieb/jre32/lib/i386/server/libjvm.so
JVM Options : -DXmx512m
4. Set Internet SMTP/POP3 Server driver parameters for POP3 using JavaMail mode
To enable JavaMail for SMTP/POP3 driver one must navigate to Administration - Communications, Communication Drivers and Profiles, select Internet SMTP/POP3 Server , change to tab: Driver Parameters.
Create attribute parameter: Enable Java for POP3
For each Profile that uses mailbox in stored in Office 365 set following attributes for POP3:
Enable Java for POP3 : TRUE
Enable SSL for POP3: TRUE
Enable TLS for POP3: FALSE
POP3 Account Name: mailbox_user@domain.ch,
POP3 Account Password: remains the same
POP3 Server: outlook.office365.com
POP3 Server Port: 995
PollingInterval: 15
SMTP configuration
The connection configuration has been acquired by reverse engineering from logs of CommOutboundManager and POP3SMTP Siebel server log.
Here it will be described all the steps as they had to be adjusted in Siebel configuration. We found out, that Office365 support TLS protocol with EHLO command. It is also needed to specify SMTP account name and password.
To test the connectivity for SMTP secure protocol, logon with Putty on Siebel OM server for respective environment. Then run the following command
openssl s_client -starttls smtp -connect smtp.office365.com:587
There is assumption, openssl is configured on each Siebel server, another assumption is that, Siebel OM server has open firewall for port 587 for connecting to smtp.office365.com
To allow SMTP protocol to connect to Office365 mail server it is needed to enable TLS for SMTP, set SMTP Account Name and SMTP Account password.
1. Test connectivity with Office365 Emails server using OpenSSL
To test the connectivity for SMTP secure protocol, logon with Putty on Siebel OM server for respective environment. Then run the following command
openssl s_client -starttls smtp -connect smtp.office365.com:587
There is assumption, openssl is configured on each Siebel server, another assumption is that, Siebel OM server has open firewall for port 587 for connecting to smtp.office365.com
2. Set Internet SMTP/POP3 Server driver parameters for SMTP
To allow SMTP protocol to connect to Office365 mail server it is needed to enable TLS for SMTP, set SMTP Account Name and SMTP Account password.
Each profile that uses Office365 mail server for sending outgoing emails is required to have following profile attributes configured as listed below.
Enable SSL for SMTP: FALSE
Enable TLS for SMTP: TRUE
From Address: new mailbox address
LogDebug: TRUE
SMTP Account Name: usually the same account name as parameter POP3 Account Name,
SMTP Account Password: usually the same password as in parameter POP3 Account Password
SMTP Server: smtp.office365.com
SMTP Server Port: 587
Use EHLO: TRUE
Back to Blog