Transport agent concepts in Exchange 2013

Find information about how the transport agent pipeline and server role architecture in Exchange 2013 affect transport agent development, and the classes that you can use to develop transport agents.

Last modified: February 25, 2014

Applies to: Exchange Server 2013

In this article
Transport agents in the transport pipeline
Transport events
Transport agents and server roles
Transport agent classes
Additional resources

You can use the class library provided in Exchange Server 2013 to implement transport agents that register for events and take actions on messages as they pass through the transport pipeline. You can also use transport agents to modify messages and convert content.

This article provides information about transport agents and the transport pipeline architecture. It is important to understand the architecture of the transport pipeline so that you can modify transport behavior to meet your organization's needs. This article also provides information about changes in the Exchange 2013 architecture that affect transport agents and the classes that you can use to develop transport agents.

Transport agents are derived from one of the following three classes:

The transport pipeline refers to the flow of message data within the boundaries of an Exchange 2013 organization. The pipeline consists of the services listed in the following table.

Table 1.  Transport pipeline services

Service

Description

Classes supported

Front End Transport

Runs on all Client Access servers and acts as a stateless proxy for all inbound and outbound external SMTP traffic for the Exchange 2013 organization. The Front End Transport service doesn't inspect message content or queue any messages locally. It communicates with the Transport service on a Mailbox server.

SmtpReceiveAgent

Transport

Runs on all Mailbox servers and is similar to the Hub Transport server role in Exchange Server 2010. The Transport service routes messages between itself and the Mailbox Transport and Front End Transport services. This service does not communicate directly with mailbox databases.

SmtpReceiveAgent

RoutingAgent

DeliveryAgent

Mailbox Transport

Runs on all Mailbox servers and consists of two separate services: Mailbox Transport Submission and Mailbox Transport Delivery. Mailbox Transport Delivery receives SMTP messages from the Transport service, and connects to the mailbox database by using an Exchange remote procedure call (RPC) to deliver the message. Mailbox Transport Submission connects to the mailbox database using RPC to retrieve messages, and submits the messages via SMTP to the Transport service.

None.

Transport events

You implement transport agents by first registering for an event, and then taking an action when that event fires. Each of the three agent types can register for a different set of events.

The following figure shows where in the transport pipeline transport agents can register for events.

Figure 1.  Transport events

An image shows message flow through the transport pipeline and events for which each agent can register beginning with Smtp events for the SmtpReceivedAgent, then Categorizor events for the RoutingAgent, and finally deliver events for the DeliveryAgent.

When a message enters the transport pipeline, a transport agent derived from the SmtpReceiveAgent class can act on the message during any of the SMTP events that the agent registered for. An agent derived from the RoutingAgent class can act on any of the four categorizer events that it has registered for. An agent derived from the DeliveryAgent class can act on a message during any of the delivery events that it has registered for.

Changes to the server role architecture in Exchange 2013 affect transport agents and what your transport agents can do. Exchange 2013 includes the following server roles:

  • Mailbox server — Includes Client Access protocols, the Transport service, mailbox databases, and Unified Messaging components. The Mailbox server communicates directly with Active Directory Domain Services (AD DS), Client Access servers, and mail clients such as Outlook.

  • Client Access server — Provides authentication, limited redirection, proxy services, and client access protocols such as HTTP, POP, IMAP, and SMTP.

  • Edge Transport server — Routes email into and out of an organization. Edge Transport servers typically sit at the perimeter of an Exchange topology.

This consolidated structure reduces the number of servers that need to be deployed in an Exchange 2013 environment. Administrators no longer have to deploy Hub Transport and Client Access servers in every Active Directory site that includes a Mailbox server, and they no longer need to update all server roles in order to take advantage of new functionality.

These changes to the server role architecture can potentially affect where in the pipeline your agent can respond to events. If you have created transport agents for versions of Exchange earlier than Exchange 2013, be sure to review the architectural changes to determine whether you need to make any changes to your agents.

The following figure shows how the architectural changes in Exchange 2013 result in a streamlined, consolidated transport pipeline. In this figure, Client Access servers are labeled CAS. And Mailbox servers are labeled MBX.

Figure 2.  Exchange 2013 server role architecture

An image shows client traffic through an external firewall and Edge Transport on the left that passes traffic through a layer 4 load balance to a consolidated CAS array and set of mailbox servers in a database accessibility group on the right.

The following figure shows the interactions between the Exchange 2013 server roles.

Figure 3.  Mailbox and Client Access server interactions

An image shows interactions starting with arrows from client traffic passing through a layer 4 load balance that has 4 targets in the CAS: IIS/HTTP Proxy, POP/IMAP, SMTP, and UM. The arrows pass to their complimentary targets in the mailbox store.

For more information about changes in the Exchange 2013 server role architecture, see Exchange 2013 architecture in What's New in Exchange 2013.

The class your transport agent derives from determines the events for which your agent can register. Your agent will typically contain an agent class, an agent factory, one or more event handlers, and the code that performs the actions that you want your agent to take.

The following table lists the classes from which to derive for each agent type.

Table 2.  Agent classes

Agent type

Factory base class

Agent base class

SMTP receive

SmtpReceiveAgentFactory

SmtpReceiveAgent

Routing

RoutingAgentFactory

RoutingAgent

Delivery

DeliveryAgentFactory<Manager>

DeliveryAgent

These factory and agent base classes provide properties and methods that you can use to access transport events and messages. Implement classes in your agent that inherit from these classes. In the agent factory derived class, override the CreateAgent method so that it returns a new instance of your agent class.

Arguments passed to the events can contain an instance of the EmailMessage class, which you can use to change the properties and contents of the underlying message. Not all message information is available in each event. You must determine which agent and which event is best for the task you want to accomplish.

The following namespaces contain types that you can use to read, write, and modify messages in the transport pipeline:

After you write your transport agent, you install and manage your agent by using the Exchange Management Shell. For more information, see Creating transport agents for Exchange 2013.

Community Additions

ADD
Show:
© 2014 Microsoft