How to configure RMS server to enable eMail notifications (worklist) for gmail accounts?

How to configure RMS server to enable eMail notifications (worklist) for gmail accounts?

book

Article ID: KB0076816

calendar_today

Updated On:

Products Versions
TIBCO BusinessEvents Enterprise Edition 5.x

Description

Some additional configuration steps are required to enable eMail notifications for a gmail account in WebStudio (commit, approve, reject items from worklist).

Issue/Introduction

How to configure RMS server to enable eMail notifications (worklist) and for gmail accounts

Environment

All Operating Systems

Resolution

1.)
Update gmail account properties and enabled security permission 
  "Access from less secure apps" (https://www.google.com/settings/security/lesssecureapps). If you do not enable this option you will receive Bad Credentials error in RMS log and email notification will not work.
Please discuss with your team internally to see if this setting is acceptable in your organization and if you comply with all your company level email account setting standards.


2.)
Three additional mail properties required "ws.notify.prop.mail.smtp.starttls.required", "ws.notify.prop.mail.smtp.starttls.enable" and "ws.notify.prop.mail.smtp.ssl.trust"

eg:
replace <eMailAccount> and <password> with valid gMail account and password
<property-group comment="" name="Notify">
    <property name="ws.notify.mail.domain" type="string" value="gmail.com"/>
    <property name="ws.notify.enabled" type="boolean" value="true"/>
    <property name="ws.notify.file.location" type="string" value="C:/tibco/be/5.5/rms/config/notify/UserNotify.Ids"/>
    <property name="ws.notify.ldap.userNotifyIdAttr" type="string" value="userPrincipalName"/>
    <property name="ws.notify.impl.class" type="string" value="com.tibco.be.ws.notification.impl.EmailNotification"/>
    <property name="ws.notify.context.impl.class" type="string" value="com.tibco.be.ws.notification.impl.EmailNotificationContext"/>
    <property name="ws.notify.message.template.file" type="string" value="C:/tibco/be/5.5/rms/config/notify/message.stg"/>
    <property name="ws.notify.mail.receiver.cc.emails" type="string" value=""/>
    <property name="ws.notify.prop.MAIL_PROTOCOL" type="string" value="smtp"/>
    <property name="ws.notify.prop.MAIL_SERVER_HOST" type="string" value="smtp.gmail.com"/> 
    <property name="ws.notify.prop.MAIL_SERVER_PORT" type="string" value="587"/> 
    <property name="ws.notify.prop.SENDER_EMAIL" type="string" value="<eMailAccount>@gmail.com"/> 
    <property name="ws.notify.prop.SENDER_USERNAME" type="string" value="<eMailAccount>@gmail.com"/> 
    <property name="ws.notify.prop.SENDER_PASSWORD" type="string" value="<password>"/> 
    <property name="ws.notify.prop.mail.smtps.auth" type="string" value="true"/>
    <property name="ws.notify.prop.mail.smtp.starttls.required" type="string" value="true"/> 
    <property name="ws.notify.prop.mail.smtp.starttls.enable" type="string" value="true"/> 
    <property name="ws.notify.prop.mail.smtp.ssl.trust" type="string" value="smtp.gmail.com"/>
    <property name="ws.notify.prop.mail.smtps.ssl.enable" type="string" value="false"/> 
</property-group>

 

Additional Information

gMail, RMS, notification