Creating Custom SMTP Notification Provider
Last updated
Last updated
IT-Conductor offers the tenants two options for delivering e-mail notifications:
The default option is to use the IT-Conductor e-mail service, which uses a public network to deliver SMTP emails. No configuration is required.
The second option allows tenants to configure their own e-mail providers that communicate directly with their mail services on-premises or in the cloud, avoiding public SMTP transmissions.
1. Before you begin, determine what kind of e-mail services your company utilizes and what type of connections are supported. The following are widely used options:
a. On-premises Exchange Server
Direct connection to the server - This will require an Exchange account dedicated to IT-Conductor. You will need to supply the user and a password to IT-Conductor configuration. In this case, the notification e-mails will be sent from IT-Conductor assigned exchange account.
Relay SMTP Server - The relay server can be installed on the IT-Conductor Gateway machine and configured to forward e-mails to the exchange server or any other type of corporate messaging platform. Please work with your exchange administrators to set it up as it may require explicit authorizations in Exchange to allow the e-mails to be forwarded. This option usually does not require a user/password in IT-Conductor configuration; only host/port. Additionally, the e-mail sender can be chosen as needed and the notification initiated by users will be marked as sent by them.
b. Cloud-based E-mail Services
Microsoft Office 360 Exchange Services - Office 360 supports Connectors, which allow authenticating the senders by source IP address or Host Name. A dedicated Connector can be configured for exclusive use by IT-Conductor. The connections will be initiated from one of the on-premise IT-Conductor Gateways.
Google Workspace SMTP Relay - Google offers functionality similar to office 360 connectors where a dedicated relay can be defined for IT-Conductor and authenticated either by IP/Address or User/Password combination. Similarly, the connection to the relay will be initiated from one of the IT-Conductor Gateways.
2. Configure SMTP Server in IT-Conductor
a. Navigate to Dashboards > Administrator.
b. Click SMTP Servers to open the SMTP Servers tile in full-screen view.
3. Configure Notification Provider.
a. Navigate to Management > Notification > Notification Providers.
4. Update Tenant settings.
a. Navigate to Management > Tenant Properties.
Note: You will need to be designated as Tenant Administrator to be able to change the Tenant settings.
b. Pick the newly configured provider in the "Notification Provider" field and save the tenant properties. The new setting will become active in about an hour. You can request a refresh from the support team by creating a ticket. When the configuration is active, all e-mails will be routed through that service.
c. Click the to add a new SMTP Server configuration and fill in the attributes. Click again once done.
d. If "Requires Authentication" is selected, the account needs to be created by clicking the tool on the newly created server. If not, proceed to step 3.
e. Click to create a new SMTP account and fill in the values. Click the again to save. Make sure you select the "Person" as the same user as you are currently logged in.
b. Click to create a new provider. Make sure you select the previously created SMTP Server in the Notification Server field. Click again to save.