mxHero Transport Agent

Use case

If you have MS Exchange on premises - 2010/2013/2016 - you have a couple of deployment options for mxHero. See the table below:

Email System

Inbound 1

Outbound 2

Intra-bound 3

Selective Routing 4

On Prem 7

MS Exchange



Yes 5

Yes 6


  1. Inbound: message from external sender to internal recipients.
  2. Outbound: message from internal senders to external recipients.
  3. Intra-bound: message from internal senders to internal recipients in the same email server.
  4. Selective Routing: only route through the gateway messages for specific users or groups.
  5. Intra-bound routing requires installation of mxHero's transport agent on the MS Exchange server.
  6. Selective Routing can be achieved by installing mxHero's transport agent or depends on the Security Email gateway for routing.
  7. On-Premises mxHero deployments are supported. MxHero recommends the use of its cloud environment, however on-premises might be the best option in certain cases.

For inbound only, you can simply change your MX records to point to mxHero (like any email gateway). For outbound, you only need create a Send Connector in your Exchange and route messages through mxHero. However, to capture intra-bound messages, you must install the mxHero Transport Agent, and this is what we describe in this article.


Please ask mxHero support for the Transport Agent installation package. Then install it in your Exchange Transport servers. There's a package for Exchange 2010 and another for 2013/2016. The configuration for all of them is the same.

Agent configuration

First, please open C:\ProgramData\MxHeroTransportAgent\config.ini and change the "ClientHeader" section value to "X-mxHero-TA-On-Prem".

Then, open the mxHero Agent Setting Editor and setup the configuration according to the following:


Use these values for the mxHero cloud. If you have mxHero on prem, they will be according to your deployment. Also please change Connect Timeout to 15000 and Send Timeout 300000.


Agent key - this value is provided by the mxHero support.


Activate logging. This will help you during the testing phase.

When you click SAVE, the system will ask you to install the change. Just confirm.

Exchange configuration

A few adjustments on the Exchange side are needed in order to finish the integration with the transport agent.

mxHero relay/whitelist

If you are using mxHero's SaaS service, please inform mxHero support your Exchange IPs. We have to configure our cloud to accept emails from your systems.

Exchange relay/whitelist

Also, in the case you are using mxHero's SaaS service, you have to allow mxHero to inject emails into your Exchange. Please follow this article for IP based relay:

The IPs you have to allow relay are:

Receive Connector adjustment

To support the email flow between mxHero and Exchange, two flags in your existing receive connectors need to be changed. The command below, using Exchange Management Shell, will do the trick, however if you want more information about this, please access:

> Get-ReceiveConnector *\* | Set-ReceiveConnector -BinaryMimeEnabled $False -ChunkingEnabled $False

All set!

Now, just restart the Exchange services to make sure all settings are in place. Command for the Exchange Management shell below.

> $services = Get-Service | ? { $ -like "MSExchange*" -and $_.Status -eq "Running"}
> foreach ($service in $services) {Restart-Service $ -Force}

Now, create your rules in the mxHero dashboard and your integration is complete!

Have more questions? Submit a request


Powered by Zendesk