SMTP Settings

For any kind of e-mail notifications (alarms/SLA/Service request etc.) the SMTP server needs to be set correctly to send out the E-mail notifications. SapphireIMS supports SMTP and Exchange mail servers for email notifications. It also supports OAuth2 for authentication for both Exchange and GSuite/Gmail.

Limits can be set on the number of recipients, number of mails in a day and by module. Refer section Setting Global Limits for Mails.

Settings for the SMTP server

Click 'Settings' then from the 'Advanced System Settings' section click 'SMTP Settings'. The following screen is displayed. Select 'SMTP' as the 'Mail Service'.

The SMTP settings fields are described below.

Serial No	Field Name	Description
1	SMTP Server	Specify your SMTP server name
2	From Address	Specify the e-mail address from which the notifications need to be sent
3	From Address Display Tag	Name that will be displayed as the ‘Sender’
4	SMTP Port	Port on which SMTP service is running
5	Authentication	Check this box if your SMTP server requires authentication. If checked, you need to provide a valid username and password, this will be used to authenticate the SMTP server.
6	isTLS (transport layer security- a protocol that provides communication security over the internet)	Check this box to allow the client to connect to TLS-enabled server requesting a secure connection.
7	isSSL (secure socket layer - a secured layer for communications over the network)	Check this box if SSL protocol has to be used for secured communication. The path of the SSL certificate has to be provided in the 'StartWebConsole.bat' file present in'<Installed folder\SapphireIMS\WebManagement\bin>' folder.
8	Advanced Settings	This is applicable only for ITSM module. 'To': Enter the maximum number of recipients to whom the E-mail can be sent. 'Cc': Enter the maximum number of recipients to whom the E-mail can be copied. 'Limits per day': The maximum number of E-mails that can be sent in a day. 'Limits Mails Modulewise': Check this to further restrict the limits for each module. ITSM is the only module currently which supports restrictions. 'Limit sub modules of ITSM': Check this to further set limits to the mails sent by 'User Survey', 'Feedback' and 'Announcements' module. When the limits are exceeded, mails go into a back log for further action. Refer Pending Mails for Approval.

Click the 'Test' button to verify the SMTP settings. This will initiate an e-mail transaction and send a test mail (to the same ID as a self test); if this is successful then the SMTP settings are correct. If this throws an error, then verify your SMTP settings.
Click on 'Update'.

Settings for the Exchange Server

Click 'Settings' then from the 'Advanced System Settings' section click 'SMTP Settings'. The following screen is displayed. Select 'Exchange' as the 'Mail Service'.

The fields are described below.

Serial No	Field Name	Description
1	From Address	Enter the 'From Address' which is the email account from which the mail is to be sent.
2	User Name	Enter the 'User Name' for the email account
3	Password	Enter the 'Password' for the email account
4	Advanced Settings	This is applicable only for ITSM module. 'To': Enter the maximum number of recipients to whom the E-mail can be sent. 'Cc': Enter the maximum number of recipients to whom the E-mail can be copied. 'Limits per day': The maximum number of E-mails that can be sent in a day. 'Limits Mails Modulewise': Check this to further restrict the limits for each module. ITSM is the only module currently which supports restrictions. 'Limit sub modules of ITSM': Check this to further set limits to the mails sent by 'User Survey', 'Feedback' and 'Announcements' module. When the limits are exceeded, mails go into a back log for further action. Refer Pending Mails for Approval.

Click the 'Test' button to verify the Exchange settings. This will initiate an e-mail transaction and send a test mail (to the same ID as a self test); if this is successful then the Exchange settings are correct. If this throws an error, then verify your Exchange settings.
Click on 'Update'.

Settings for Exchange using OAuth2 Authentication

Click 'Settings' then from the 'Advanced System Settings' section click 'SMTP Settings'. The following screen is displayed. Select 'OAuth2 Authentication Exchange' as the 'Mail Service'.

The fields are described below

Serial No	Field Name	Description
1	From Address	Enter the 'From Address' which is the email account from which the mail is to be sent.
2	Mail Profile	Select a 'Mail Profile'. Refer to the topic Settings->Advanced System Settings->Mail Profiles for creating mail profiles.
3	Authorize Access	Click on this button to authenticate. This needs to be done the first time.
4	Advanced Settings	This is applicable only for ITSM module. 'To': Enter the maximum number of recipients to whom the E-mail can be sent. 'Cc': Enter the maximum number of recipients to whom the E-mail can be copied. 'Limits per day': The maximum number of E-mails that can be sent in a day. 'Limits Mails Modulewise': Check this to further restrict the limits for each module. ITSM is the only module currently which supports restrictions. 'Limit sub modules of ITSM': Check this to further set limits to the mails sent by 'User Survey', 'Feedback' and 'Announcements' module. When the limits are exceeded, mails go into a back log for further action. Refer Pending Mails for Approval.

Click the 'Test' button to verify the SMTP settings. This will initiate an e-mail transaction and send a test mail (to the same ID as a self test); if this is successful then the SMTP settings are correct. If this throws an error, then verify your SMTP settings.
Click on 'Update'.

Settings for GSuite/GMail using OAuth2 Authentication

Click 'Settings' then from the 'Advanced System Settings' section click 'SMTP Settings'. The following screen is displayed. Select 'SMTP OAuth2 GSuite/Gmail' as the 'Mail Service'.

The SMTP settings fields are described below.

Serial No	Field Name	Description
1	SMTP Server	Specify your SMTP server name
2	From Address Display Tag	Name that will be displayed as the ‘Sender’
3	SMTP Port	Port on which SMTP service is running
4	Mail Profile	Select a 'Mail Profile'. Refer to the topic Settings->Advanced System Settings->Mail Profiles for creating mail profiles.
5	From Address	Enter the 'From Address' which is the email account from which the mail is to be sent.
6	Authorize Access	Click on this button to authenticate. This needs to be done the first time.
7	Advanced Settings	This is applicable only for ITSM module. 'To': Enter the maximum number of recipients to whom the E-mail can be sent. 'Cc': Enter the maximum number of recipients to whom the E-mail can be copied. 'Limits per day': The maximum number of E-mails that can be sent in a day. 'Limits Mails Modulewise': Check this to further restrict the limits for each module. ITSM is the only module currently which supports restrictions. 'Limit sub modules of ITSM': Check this to further set limits to the mails sent by 'User Survey', 'Feedback' and 'Announcements' module. When the limits are exceeded, mails go into a back log for further action. Refer Pending Mails for Approval.

Click the 'Test' button to verify the SMTP settings. This will initiate an e-mail transaction and send a test mail (to the same ID as a self test); if this is successful then the SMTP settings are correct. If this throws an error, then verify your SMTP settings.
Click on 'Update'.

Proxy Settings

Some of the modules in SapphireIMS (like patch download etc) require access to the Internet. If you need to access the Internet via the proxy then specify the same in the configuration provided by Sapphire

Click the 'Settings' tab. In the 'Advanced System Settings' section, click 'Proxy Settings'. Select the ‘Proxy Server’ radio button as shown in this link

Proxy Settings

Sr. No	Field Name	Description
1	HTTP Proxy Server	Set the hostname or the IP address of the HTTP proxy server
2	HTTP Proxy Port	Set the port number to be used for the proxy access
3	User Name	Specify the user name that is to be sued for the proxy connection
4	Password	Password to be used for the proxy access

Pending Mails for Approval

When the limits exceed, sending of mails is paused and the list of backlog mails is displayed to take action. Click on the tab 'Pending Mails for Approval' to view the list of mails not sent. From the Settings screen you can click on to view this screen.

If you want to send any mails, select the mails and click on 'Resume'.
To discard mails, select the mails and click on 'Suspend'. Mails which are suspended will be displayed under 'Suspended Mails'. Refer to Suspended Mails.
Click on 'Settings' button to return to the 'SMTP Settings' screen.
Check the 'Auto Resume' box to automatically cause the mails sending to be resumed once the count of pending mails falls below the threshold or the limits are increased. Note that the Auto Resume box should be first checked before increasing the limits.

Suspended Mails

Click on 'Suspended Mails' tab to view the suspended mails.

Note: Mails in this list remain forever and are not purged.

Setting Global Limits for Mails

The following Global Settings set the overall limits globally across all modules. This can be set in the Global Settings. Refer to Settings->Advanced System Settings->Global Settings for details.

'MAIL_LIMIT_PER_DAY_SMTP' - set the limit for overall mails outgoing per day for SMTP server.
'RECIPIENTS_LIMIT_PER_MAIL_SMTP' - set the limit for recipients per mail for SMTP server.