SMTP

Owned by David Stavisski
Last updated: Jul 07, 2022
3 min read

Creating custom SMTP Notification Provider

IT-Conductor offers the tenants two options for delivering the e-mail notifications.

The default option is IT-Conductor e-mail service, that uses public network to deliver SMTP emails. No configuration is required

Optionally tenants can configure their own e-mail providers that communicate directly with their mail services on premises or in the cloud, avoiding public SMTP transmissions.

Below are the instructions how to configure private SMTP provider:

  1. Before you begin, please determine what kind of e-mail services your company utilizes and what type of connections are supported. The following are widely used options:
    1. On-premises Exchange Sever
      1. 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
      2. 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 might require explicit authorizations in exchange to allow for  the e-mails to be forwarded. This option usually doesn't require user/password in IT-Conductor configuration, only host/port. Additionally the e-mails sender can be chosen as needed and the notification initiated by users will be marked as sent by them.
    2. Cloud-based e-mail services
      1. Microsoft Office 360 Exchange services. Office 360 supports Connectors, which allow to authenticate the senders via IP address or Host Name. A dedicated Connector can be defined for exclusive use by IT-Conductor (the connections will be initiated from one of IT-Conductor gateways)
      2. 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

    1. Navigate to Administrator dashboard
    2. Click on SMTP Servers tile to open the view full-screen
    3. Click (plus) to add new SMTP Server configuration and fill in the attributes, press (plus) when done


    4. If Requires Authentication is checked, the account will need to be created by clicking Account tool on the newly created server, if not proceed to step 3.
    5. Click on (plus) to create a new SMTP account, fill in the values and click (plus) to save. Make sure you select the Person as the same user as you are currently logged in.


  3. Configure Notification Provider

    1. Navigate in the top menu to Management → Notification → Notification Providers

    2. Click (plus) to create a new provider, Make sure you select the previously created SMTP Server in the  Notification Server field. Click (plus) to save.
  4. Update Tenant settings
    1. Navigate in the top menu to Management → Tenant Properties (you will need to be designated as Tenant Administrator to be able to change Tenant settings)
    2. Pick the newly configured provider in 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