14 Aug 02:43

diassoft

7e95350

SMTP Router v2.7.0 Latest

Latest

Smtp Router - v2.7.0

The SMTP Router is a intermediate SMTP server useful to intercept messages and route it to another smtp.

It contains a Listener to capture Smtp messages and a Router that will route the message to another Smtp Server when it matches certain RoutingRules.
It also contains a Server object that encapsulates both the Listener and the Router.

These are some of the uses of an SMTP Router:

SMTP Relay Server
Switch the destination SMTP server based on the incoming message. This is especially useful when you have systems that can only accept one single SMTP configuration and you want to use more than one SMTP.
Provide SMTP authentication for a system that does not have such feature
Use Multiple SMTPs to send messages, due to daily our hourly limits defined by the email provider (in development)

This is a new release of the Smtp Router component, which is now on it's major version 2.

Major Version 2 include the following features:

Feature	Version
Added functionality to Accept messages from certain IP Addresses only	2.7.0
Added functionality to Reject messages from certain IP Addresses	2.7.0
Changed Headers to Custom Headers (`X-SM-Received` and `X-SM-SentBy`)	2.6.0
Fix the problem when reloading messages from files	2.6.0
Fix the problem with connection timeout (force the system to reconnect)	2.6.0
Fix problem when the Smtp Envelope does not match the Mime Message headers	2.0.0
Removal of the Retry folder	2.0.0
File grouping when saving data in the Sent Folder	2.0.0
Better folder structure organization	2.0.0
Improved performance enhancement by using multiple Smtp Connections (Several Improvements)	2.0.0

Implementations using Major Version 1 will need to be modified when moving to Major Version 2.

Assets 2

10 May 06:40

diassoft

v1.0.0.7

3e69651

SMTP Router v1.0.0.7

The SMTP Router is a intermediate SMTP server useful to intercept messages and route it to another smtp.

It contains a Listener to capture Smtp messages and a Router that will route the message to another Smtp Server when it matches certain RoutingRules.

These are some of the uses of an SMTP Router:

SMTP Relay Server
Switch the destination SMTP server based on the incoming message. This is especially useful when you have systems that can only accept one single SMTP configuration and you want to use more than one SMTP.
Use Multiple SMTPs to send messages, due to daily our hourly limits defined by the email provider (in development)

If you wish to contact the creator of this component, you can make it thru the Nuget.org page or by email olavodias@gmail.com.

In this repository

SMTP Router Documentation
How To Use It
Smtp Configuration
Routing Rules

Additional Repositories

There are other interesting repositories regarding the SMTPRouter Project.

Repository	Description
SMTPRouter.Windows	Contains types to allow the use of the SMTPRouter Component in a .NET Framework. It also contains an implementation of the SMTPRouter as a Windows Service

We are currently working on a solution to have it run in other OSs

How To Use It

There are two different ways to use the SMTP Router.

You can initialize a SmtpRouter.Server object or;
You can initialize a Listener and a Router manually.

The Listener opens a SmtpServer and listens to messages. Once a messages arrives, it will raise the MessageReceived event, with the MimeKit.MimeMessage received.

The Router runs in a separated thread from the Listener. The Router itself is the component which checks the RoutingRules and routes the message to the proper SMTP.

The Router creates a folder structure containing the following queues:

Queue	Description
Outgoing	Emails that need to be routed
Sent	Emails that were routed successfully
Retry	Emails that were not sent yet, but are still under the `MessageLifespan`. Those messages are sent back to the Outgoing queue.
Error	Emails that were not sent and the `MessageLifespan` is expired. Those messages are no longer sent unless they are moved manually to the Outgoing queue.

Prerequisites

When you choose to use the SmtpRouter Nuget Package, you will also be required to install the following packages:

Package	Nuget Link	Author
SmtpServer		cosullivan
MimeKit		jstedfast
MailKit		jstedfast

Using the Server Object

The easiest and recommended way to implement the SmtpRouter is by initializing an instance of the Server class and call the StartAsync to start listening to messages route them.

The code below demonstrates how to instantiate a server:

// Creates the Server
var server = new SMTPRouter.Server("localhost", 25, false, false, "SMTPRouter", "C:\\SMTPRouter\\Queues")
{
    MessageLifespan = new TimeSpan(0, 15, 0),
    MessagePurgeLifespan = new TimeSpan(90, 0, 0, 0),
    RoutingRules = new List<Models.RoutingRule>()
    {
        new Models.MailFromDomainRoutingRule(10, "gmail.com", "gmail"),
        new Models.MailFromDomainRoutingRule(20, "hotmail.com", "hotmail")
    },
    DestinationSmtps = new Dictionary<string, Models.SmtpConfiguration>
    {
        { "gmail", new Models.SmtpConfiguration()
            {
                Host = "smtp.gmail.com",
                Description = "Google Mail SMTP",
                Port = 587,
                RequiresAuthentication = true,
                User = "user@gmail.com",
                Password = "",
            }
        },
        { "hotmail", new Models.SmtpConfiguration()
            {
                Host = "smtp.live.com",
                Description = "Hotmail SMTP",
                Port = 587,
                RequiresAuthentication = true,
                User = "user@hotmail.com",
                Password = "",
            }
        }
    },
};

// Initialize Services
Task.WhenAll(server.StartAsync(CancellationToken.None)).ConfigureAwait(false);

The Server class triggers events when certain activities happen. You can hook to the events by using the code below:

// Hook Events
server.SessionCreated += Server_SessionCreated;
server.SessionCommandExecuting += Server_SessionCommandExecuting;
server.SessionCompleted += Server_SessionCompleted;
server.ListeningStarted += Server_ListeningStarted;
server.MessageReceived += Server_MessageReceived;
server.MessageRoutedSuccessfully += Server_MessageRoutedSuccessfully;
server.MessageNotRouted += Server_MessageNotRouted;
server.MessagePurging += Server_MessagePurging;
server.MessagesPurged += Server_MessagesPurged;

For more information, refer to the Server Class in the documentation.

Using the Listener and Router Individually

It is not necessary to instantiate the Listener and Router manually, but if you need to have more control, you can do it.

If you want to have the Router run in a different Service Instance, perhaps having both objects initialized separately would be the best option.

The code below demonstrates how to instantiate a Listener, a Router and hook them together using events.

// Create the Listener
var listener = new SMTPRouter.Listener()
{
    ServerName = "localhost",
    Ports = new int[] { 25, 587 },
    RequiresAuthentication = false,
    UseSSL = false
};
listener.SessionCreated += Server_SessionCreated;
listener.SessionCommandExecuting += Server_SessionCommandExecuting;
listener.SessionCompleted += Server_SessionCompleted;
listener.ListeningStarted += Server_ListeningStarted;

// Create the Router
var router = new SMTPRouter.Router("SMTPRouter", "C:\\SMTPRouter\\Queues")
{
    MessageLifespan = new TimeSpan(0, 15, 0),
    RoutingRules = new List<Models.RoutingRule>()
    {
        new Models.MailFromDomainRoutingRule(10, "gmail.com", "gmail"),
        new Models.MailFromDomainRoutingRule(20, "hotmail.com", "hotmail")
    },
    DestinationSmtps = new Dictionary<string, Models.SmtpConfiguration>
    {
        { "gmail", new Models.SmtpConfiguration()
            {
                Host = "smtp.gmail.com",
                Description = "Google Mail SMTP",
                Port = 587,
                RequiresAuthentication = true,
                User = "user@gmail.com",
                Password = "",
            }
        },
        { "hotmail", new Models.SmtpConfiguration()
            {
                Host = "smtp.live.com",
                Description = "Hotmail SMTP",
                Port = 587,
                RequiresAuthentication = true,
                User = "user@hotmail.com",
                Password = "",
            }
        }
    },
};
router.MessageRoutedSuccessfully += Server_MessageRoutedSuccessfully;
router.MessageNotRouted += Server_MessageNotRouted;

// When the Listener have a message, it has to be sent to the Router. This is Automatic when you use the Server class
listener.MessageReceived += (object sender, MessageEventArgs e) =>
{
    // Make sure to enqueue the message otherwise the router doesn't know about anything
    router.Enqueue(e.MimeMessage);
};
listener.MessageReceived += Server_MessageReceived;

// Initialize Services
Task.WhenAll(listener.StartAsync(CancellationToken.None),
             router.StartAsync(CancellationToken.None)).ConfigureAwait(false);

For more information, refer to the Listener Class and the Router Class in the documentation.

Smtp Configuration

The Router has a property named DestinationSmtps, which represents a Dictionary<string, SmtpConfiguration>.

The Smtps to route messages must be cofigured and added to this collection. The Key field is the key to fetch the Smtp.

You can configure the Smtps when initializing the Server or Router, or you can configure a Smtp using the code below:

// Initializes a new Smtp Configuration
var smtpConfiguration = new SmtpConfiguration()
{
    Key = "Gmail",
    Description = "Gmail SMTP",
    Host = "smtp.gmail.com",
    Port = 587,
    RequiresAuthentication = true,
    UseSSL = false,
    User = "user@gmail.com",
    Password = "password",
    SecureSocketOption = 1
};

The SmtpConfiguration object derives from an ObservableObject, which makes it compatible with Mvvm Implementations.

Valid values for the `SecureSock...

Assets 2

30 Apr 04:39

diassoft

v1.0.0.5

75d9520

SMTP Router v1.0.0.5

Smtp Router - v1.0.0.5

The SMTP Router is a intermediate SMTP server useful to intercept messages and route it to another smtp.

It contains a Listener to capture Smtp messages and a Router that will route the message to another Smtp Server when it matches certain RoutingRules.

These are some of the uses of an SMTP Router:

SMTP Relay Server
Switch the destination SMTP server based on the incoming message. This is especially useful when you have systems that can only accept one single SMTP configuration and you want to use more than one SMTP.
Use Multiple SMTPs to send messages, due to daily our hourly limits defined by the email provider (in development)

If you wish to contact the creator of this component, you can make it thru the Nuget.org page or by email olavodias@gmail.com.

In this repository

SMTP Router Documentation
How To Use It
Smtp Configuration
Routing Rules

Additional Repositories

There are other interesting repositories regarding the SMTPRouter Project.

Repository	Description
SMTPRouter.Windows	Contains types to allow the use of the SMTPRouter Component in a .NET Framework. It also contains an implementation of the SMTPRouter as a Windows Service

We are currently working on a solution to have it run in other OSs

How To Use It

There are two different ways to use the SMTP Router.

You can initialize a SmtpRouter.Server object or;
You can initialize a Listener and a Router manually.

The Listener opens a SmtpServer and listens to messages. Once a messages arrives, it will raise the MessageReceived event, with the MimeKit.MimeMessage received.

The Router runs in a separated thread from the Listener. The Router itself is the component which checks the RoutingRules and routes the message to the proper SMTP.

The Router creates a folder structure containing the following queues:

Queue	Description
Outgoing	Emails that need to be routed
Sent	Emails that were routed successfully
Retry	Emails that were not sent yet, but are still under the `MessageLifespan`. Those messages are sent back to the Outgoing queue.
Error	Emails that were not sent and the `MessageLifespan` is expired. Those messages are no longer sent unless they are moved manually to the Outgoing queue.

Prerequisites

When you choose to use the SmtpRouter Nuget Package, you will also be required to install the following packages:

Package	Nuget Link	Author
SmtpServer		cosullivan
MimeKit		jstedfast
MailKit		jstedfast

Using the Server Object

The easiest and recommended way to implement the SmtpRouter is by initializing an instance of the Server class and call the StartAsync to start listening to messages route them.

The code below demonstrates how to instantiate a server:

// Creates the Server
var server = new SMTPRouter.Server("localhost", 25, false, false, "SMTPRouter", "C:\\SMTPRouter\\Queues")
{
    MessageLifespan = new TimeSpan(0, 15, 0),
    MessagePurgeLifespan = new TimeSpan(90, 0, 0, 0),
    RoutingRules = new List<Models.RoutingRule>()
    {
        new Models.MailFromDomainRoutingRule(10, "gmail.com", "gmail"),
        new Models.MailFromDomainRoutingRule(20, "hotmail.com", "hotmail")
    },
    DestinationSmtps = new Dictionary<string, Models.SmtpConfiguration>
    {
        { "gmail", new Models.SmtpConfiguration()
            {
                Host = "smtp.gmail.com",
                Description = "Google Mail SMTP",
                Port = 587,
                RequiresAuthentication = true,
                User = "user@gmail.com",
                Password = "",
            }
        },
        { "hotmail", new Models.SmtpConfiguration()
            {
                Host = "smtp.live.com",
                Description = "Hotmail SMTP",
                Port = 587,
                RequiresAuthentication = true,
                User = "user@hotmail.com",
                Password = "",
            }
        }
    },
};

// Initialize Services
Task.WhenAll(server.StartAsync(CancellationToken.None)).ConfigureAwait(false);

The Server class triggers events when certain activities happen. You can hook to the events by using the code below:

// Hook Events
server.SessionCreated += Server_SessionCreated;
server.SessionCommandExecuting += Server_SessionCommandExecuting;
server.SessionCompleted += Server_SessionCompleted;
server.ListeningStarted += Server_ListeningStarted;
server.MessageReceived += Server_MessageReceived;
server.MessageRoutedSuccessfully += Server_MessageRoutedSuccessfully;
server.MessageNotRouted += Server_MessageNotRouted;
server.MessagePurging += Server_MessagePurging;
server.MessagesPurged += Server_MessagesPurged;

For more information, refer to the Server Class in the documentation.

Using the Listener and Router Individually

It is not necessary to instantiate the Listener and Router manually, but if you need to have more control, you can do it.

If you want to have the Router run in a different Service Instance, perhaps having both objects initialized separately would be the best option.

The code below demonstrates how to instantiate a Listener, a Router and hook them together using events.

// Create the Listener
var listener = new SMTPRouter.Listener()
{
    ServerName = "localhost",
    Ports = new int[] { 25, 587 },
    RequiresAuthentication = false,
    UseSSL = false
};
listener.SessionCreated += Server_SessionCreated;
listener.SessionCommandExecuting += Server_SessionCommandExecuting;
listener.SessionCompleted += Server_SessionCompleted;
listener.ListeningStarted += Server_ListeningStarted;

// Create the Router
var router = new SMTPRouter.Router("SMTPRouter", "C:\\SMTPRouter\\Queues")
{
    MessageLifespan = new TimeSpan(0, 15, 0),
    RoutingRules = new List<Models.RoutingRule>()
    {
        new Models.MailFromDomainRoutingRule(10, "gmail.com", "gmail"),
        new Models.MailFromDomainRoutingRule(20, "hotmail.com", "hotmail")
    },
    DestinationSmtps = new Dictionary<string, Models.SmtpConfiguration>
    {
        { "gmail", new Models.SmtpConfiguration()
            {
                Host = "smtp.gmail.com",
                Description = "Google Mail SMTP",
                Port = 587,
                RequiresAuthentication = true,
                User = "user@gmail.com",
                Password = "",
            }
        },
        { "hotmail", new Models.SmtpConfiguration()
            {
                Host = "smtp.live.com",
                Description = "Hotmail SMTP",
                Port = 587,
                RequiresAuthentication = true,
                User = "user@hotmail.com",
                Password = "",
            }
        }
    },
};
router.MessageRoutedSuccessfully += Server_MessageRoutedSuccessfully;
router.MessageNotRouted += Server_MessageNotRouted;

// When the Listener have a message, it has to be sent to the Router. This is Automatic when you use the Server class
listener.MessageReceived += (object sender, MessageEventArgs e) =>
{
    // Make sure to enqueue the message otherwise the router doesn't know about anything
    router.Enqueue(e.MimeMessage);
};
listener.MessageReceived += Server_MessageReceived;

// Initialize Services
Task.WhenAll(listener.StartAsync(CancellationToken.None),
             router.StartAsync(CancellationToken.None)).ConfigureAwait(false);

For more information, refer to the Listener Class and the Router Class in the documentation.

Smtp Configuration

The Router has a property named DestinationSmtps, which represents a Dictionary<string, SmtpConfiguration>.

The Smtps to route messages must be cofigured and added to this collection. The Key field is the key to fetch the Smtp.

You can configure the Smtps when initializing the Server or Router, or you can configure a Smtp using the code below:

// Initializes a new Smtp Configuration
var smtpConfiguration = new SmtpConfiguration()
{
    Key = "Gmail",
    Description = "Gmail SMTP",
    Host = "smtp.gmail.com",
    Port = 587,
    RequiresAuthentication = true,
    UseSSL = false,
    User = "user@gmail.com",
    Password = "password",
    SecureSocketOption = 1
};

The SmtpConfiguration object derives from an ObservableObject, which makes it compatible with Mvvm Implementations.

Valid ...

Assets 2

24 Apr 05:40

diassoft

v1.0.0.3

4f76de9

SMTP Router v1.0.0.3

Smtp Router - v1.0.0.3

The SMTP Router is a intermediate SMTP server useful to intercept messages and route it to another smtp.

It contains a Listener to capture Smtp messages and a Router that will route the message to another Smtp Server when it matches certain RoutingRules.

These are some of the uses of an SMTP Router:

SMTP Relay Server
Switch the destination SMTP server based on the incoming message. This is especially useful when you have systems that can only accept one single SMTP configuration and you want to use more than one SMTP.
Use Multiple SMTPs to send messages, due to daily our hourly limits defined by the email provider (in development)

If you wish to contact the creator of this component, you can make it thru the Nuget.org page or by email olavodias@gmail.com.

In this repository

SMTP Router Documentation
How To Use It
Smtp Configuration
Routing Rules

Additional Repositories

There are other interesting repositories regarding the SMTPRouter Project.

Repository	Description	Nuget
SMTPRouter.Windows	Contains types to allow the use of the SMTPRouter Component in a .NET Framework. It also contains an implementation of the SMTPRouter as a Windows Service

We are currently working on a solution to have it run in other OSs

How To Use It

There are two different ways to use the SMTP Router.

You can initialize a SmtpRouter.Server object or;
You can initialize a Listener and a Router manually.

The Listener opens a SmtpServer and listens to messages. Once a messages arrives, it will raise the MessageReceived event, with the MimeKit.MimeMessage received.

The Router runs in a separated thread from the Listener. The Router itself is the component which checks the RoutingRules and routes the message to the proper SMTP.

The Router creates a folder structure containing the following queues:

Queue	Description
Outgoing	Emails that need to be routed
Sent	Emails that were routed successfully
Retry	Emails that were not sent yet, but are still under the `MessageLifespan`. Those messages are sent back to the Outgoing queue.
Error	Emails that were not sent and the `MessageLifespan` is expired. Those messages are no longer sent unless they are moved manually to the Outgoing queue.

Prerequisites

When you choose to use the SmtpRouter Nuget Package, you will also be required to install the following packages:

Package	Nuget Link	Author
SmtpServer		cosullivan
MimeKit		jstedfast
MailKit		jstedfast

Using the Server Object

The easiest and recommended way to implement the SmtpRouter is by initializing an instance of the Server class and call the StartAsync to start listening to messages route them.

The code below demonstrates how to instantiate a server:

// Creates the Server
var server = new SMTPRouter.Server("localhost", 25, false, false, "SMTPRouter", "C:\\SMTPRouter\\Queues")
{
    MessageLifespan = new TimeSpan(0, 15, 0),
    RoutingRules = new List<Models.RoutingRule>()
    {
        new Models.MailFromDomainRoutingRule(10, "gmail.com", "gmail"),
        new Models.MailFromDomainRoutingRule(20, "hotmail.com", "hotmail")
    },
    DestinationSmtps = new Dictionary<string, Models.SmtpConfiguration>
    {
        { "gmail", new Models.SmtpConfiguration()
            {
                Host = "smtp.gmail.com",
                Description = "Google Mail SMTP",
                Port = 587,
                RequiresAuthentication = true,
                User = "user@gmail.com",
                Password = "",
            }
        },
        { "hotmail", new Models.SmtpConfiguration()
            {
                Host = "smtp.live.com",
                Description = "Hotmail SMTP",
                Port = 587,
                RequiresAuthentication = true,
                User = "user@hotmail.com",
                Password = "",
            }
        }
    },
};

// Initialize Services
Task.WhenAll(server.StartAsync(CancellationToken.None)).ConfigureAwait(false);

The Server class triggers events when certain activities happen. You can hook to the events by using the code below:

// Hook Events
server.SessionCreated += Server_SessionCreated;
server.SessionCommandExecuting += Server_SessionCommandExecuting;
server.SessionCompleted += Server_SessionCompleted;
server.ListeningStarted += Server_ListeningStarted;
server.MessageReceived += Server_MessageReceived;
server.MessageRoutedSuccessfully += Server_MessageRoutedSuccessfully;
server.MessageNotRouted += Server_MessageNotRouted;

For more information, refer to the Server Class in the documentation.

Using the Listener and Router Individually

It is not necessary to instantiate the Listener and Router manually, but if you need to have more control, you can do it.

If you want to have the Router run in a different Service Instance, perhaps having both objects initialized separately would be the best option.

The code below demonstrates how to instantiate a Listener, a Router and hook them together using events.

// Create the Listener
var listener = new SMTPRouter.Listener()
{
    ServerName = "localhost",
    Ports = new int[] { 25, 587 },
    RequiresAuthentication = false,
    UseSSL = false
};
listener.SessionCreated += Server_SessionCreated;
listener.SessionCommandExecuting += Server_SessionCommandExecuting;
listener.SessionCompleted += Server_SessionCompleted;
listener.ListeningStarted += Server_ListeningStarted;

// Create the Router
var router = new SMTPRouter.Router("SMTPRouter", "C:\\SMTPRouter\\Queues")
{
    MessageLifespan = new TimeSpan(0, 15, 0),
    RoutingRules = new List<Models.RoutingRule>()
    {
        new Models.MailFromDomainRoutingRule(10, "gmail.com", "gmail"),
        new Models.MailFromDomainRoutingRule(20, "hotmail.com", "hotmail")
    },
    DestinationSmtps = new Dictionary<string, Models.SmtpConfiguration>
    {
        { "gmail", new Models.SmtpConfiguration()
            {
                Host = "smtp.gmail.com",
                Description = "Google Mail SMTP",
                Port = 587,
                RequiresAuthentication = true,
                User = "user@gmail.com",
                Password = "",
            }
        },
        { "hotmail", new Models.SmtpConfiguration()
            {
                Host = "smtp.live.com",
                Description = "Hotmail SMTP",
                Port = 587,
                RequiresAuthentication = true,
                User = "user@hotmail.com",
                Password = "",
            }
        }
    },
};
router.MessageRoutedSuccessfully += Server_MessageRoutedSuccessfully;
router.MessageNotRouted += Server_MessageNotRouted;

// When the Listener have a message, it has to be sent to the Router. This is Automatic when you use the Server class
listener.MessageReceived += (object sender, MessageEventArgs e) =>
{
    // Make sure to enqueue the message otherwise the router doesn't know about anything
    router.Enqueue(e.MimeMessage);
};
listener.MessageReceived += Server_MessageReceived;

// Initialize Services
Task.WhenAll(listener.StartAsync(CancellationToken.None),
             router.StartAsync(CancellationToken.None)).ConfigureAwait(false);

For more information, refer to the Listener Class and the Router Class in the documentation.

Smtp Configuration

The Router has a property named DestinationSmtps, which represents a Dictionary<string, SmtpConfiguration>.

The Smtps to route messages must be cofigured and added to this collection. The Key field is the key to fetch the Smtp.

You can configure the Smtps when initializing the Server or Router, or you can configure a Smtp using the code below:

// Initializes a new Smtp Configuration
var smtpConfiguration = new SmtpConfiguration()
{
    Key = "Gmail",
    Description = "Gmail SMTP",
    Host = "smtp.gmail.com",
    Port = 587,
    RequiresAuthentication = true,
    UseSSL = false,
    User = "user@gmail.com",
    Password = "password",
    SecureSocketOption = 1
};

The SmtpConfiguration object derives from an ObservableObject, which makes it compatible with Mvvm Implementations.

Valid values for the `Se...

Assets 2

23 Apr 04:20

diassoft

v1.0.0.2

c38c374

SMTP Router v1.0.0.2

Smtp Router - v1.0.0.2

The SMTP Router is a intermediate SMTP server useful to intercept messages and route it to another smtp.

It contains a Listener to capture Smtp messages and a Router that will route the message to another Smtp Server when it matches certain RoutingRules.

These are some of the uses of an SMTP Router:

SMTP Relay Server
Switch the destination SMTP server based on the incoming message. This is especially useful when you have systems that can only accept one single SMTP configuration and you want to use more than one SMTP.
Use Multiple SMTPs to send messages, due to daily our hourly limits defined by the email provider (in development)

If you wish to contact the creator of this component, you can make it thru the Nuget.org page or by email olavodias@gmail.com.

In this repository

SMTP Router Documentation
How To Use It
Smtp Configuration
Routing Rules

Additional Repositories

There are other interesting repositories regarding the SMTPRouter Project.

Repository	Description	Nuget
SMTPRouter.Windows	Contains types to allow the use of the SMTPRouter Component in a .NET Framework. It also contains an implementation of the SMTPRouter as a Windows Service

We are currently working on a solution to have it run in other OSs

How To Use It

There are two different ways to use the SMTP Router.

You can initialize a SmtpRouter.Server object or;
You can initialize a Listener and a Router manually.

The Listener opens a SmtpServer and listens to messages. Once a messages arrives, it will raise the MessageReceived event, with the MimeKit.MimeMessage received.

The Router runs in a separated thread from the Listener. The Router itself is the component which checks the RoutingRules and routes the message to the proper SMTP.

The Router creates a folder structure containing the following queues:

Queue	Description
Outgoing	Emails that need to be routed
Sent	Emails that were routed successfully
Retry	Emails that were not sent yet, but are still under the `MessageLifespan`. Those messages are sent back to the Outgoing queue.
Error	Emails that were not sent and the `MessageLifespan` is expired. Those messages are no longer sent unless they are moved manually to the Outgoing queue.

Prerequisites

When you choose to use the SmtpRouter Nuget Package, you will also be required to install the following packages:

Package	Nuget Link	Author
SmtpServer		cosullivan
MimeKit		jstedfast
MailKit		jstedfast

Using the Server Object

The easiest and recommended way to implement the SmtpRouter is by initializing an instance of the Server class and call the StartAsync to start listening to messages route them.

The code below demonstrates how to instantiate a server:

// Creates the Server
var server = new SMTPRouter.Server("localhost", 25, false, false, "SMTPRouter", "C:\\SMTPRouter\\Queues")
{
    MessageLifespan = new TimeSpan(0, 15, 0),
    RoutingRules = new List<Models.RoutingRule>()
    {
        new Models.MailFromDomainRoutingRule(10, "gmail.com", "gmail"),
        new Models.MailFromDomainRoutingRule(20, "hotmail.com", "hotmail")
    },
    DestinationSmtps = new Dictionary<string, Models.SmtpConfiguration>
    {
        { "gmail", new Models.SmtpConfiguration()
            {
                Host = "smtp.gmail.com",
                Description = "Google Mail SMTP",
                Port = 587,
                RequiresAuthentication = true,
                User = "user@gmail.com",
                Password = "",
            }
        },
        { "hotmail", new Models.SmtpConfiguration()
            {
                Host = "smtp.live.com",
                Description = "Hotmail SMTP",
                Port = 587,
                RequiresAuthentication = true,
                User = "user@hotmail.com",
                Password = "",
            }
        }
    },
};

// Initialize Services
Task.WhenAll(server.StartAsync(CancellationToken.None)).ConfigureAwait(false);

The Server class triggers events when certain activities happen. You can hook to the events by using the code below:

// Hook Events
server.SessionCreated += Server_SessionCreated;
server.SessionCommandExecuting += Server_SessionCommandExecuting;
server.SessionCompleted += Server_SessionCompleted;
server.ListeningStarted += Server_ListeningStarted;
server.MessageReceived += Server_MessageReceived;
server.MessageRoutedSuccessfully += Server_MessageRoutedSuccessfully;
server.MessageNotRouted += Server_MessageNotRouted;

For more information, refer to the Server Class in the documentation.

Using the Listener and Router Individually

It is not necessary to instantiate the Listener and Router manually, but if you need to have more control, you can do it.

If you want to have the Router run in a different Service Instance, perhaps having both objects initialized separately would be the best option.

The code below demonstrates how to instantiate a Listener, a Router and hook them together using events.

// Create the Listener
var listener = new SMTPRouter.Listener()
{
    ServerName = "localhost",
    Ports = new int[] { 25, 587 },
    RequiresAuthentication = false,
    UseSSL = false
};
listener.SessionCreated += Server_SessionCreated;
listener.SessionCommandExecuting += Server_SessionCommandExecuting;
listener.SessionCompleted += Server_SessionCompleted;
listener.ListeningStarted += Server_ListeningStarted;

// Create the Router
var router = new SMTPRouter.Router("SMTPRouter", "C:\\SMTPRouter\\Queues")
{
    MessageLifespan = new TimeSpan(0, 15, 0),
    RoutingRules = new List<Models.RoutingRule>()
    {
        new Models.MailFromDomainRoutingRule(10, "gmail.com", "gmail"),
        new Models.MailFromDomainRoutingRule(20, "hotmail.com", "hotmail")
    },
    DestinationSmtps = new Dictionary<string, Models.SmtpConfiguration>
    {
        { "gmail", new Models.SmtpConfiguration()
            {
                Host = "smtp.gmail.com",
                Description = "Google Mail SMTP",
                Port = 587,
                RequiresAuthentication = true,
                User = "user@gmail.com",
                Password = "",
            }
        },
        { "hotmail", new Models.SmtpConfiguration()
            {
                Host = "smtp.live.com",
                Description = "Hotmail SMTP",
                Port = 587,
                RequiresAuthentication = true,
                User = "user@hotmail.com",
                Password = "",
            }
        }
    },
};
router.MessageRoutedSuccessfully += Server_MessageRoutedSuccessfully;
router.MessageNotRouted += Server_MessageNotRouted;

// When the Listener have a message, it has to be sent to the Router. This is Automatic when you use the Server class
listener.MessageReceived += (object sender, MessageEventArgs e) =>
{
    // Make sure to enqueue the message otherwise the router doesn't know about anything
    router.Enqueue(e.MimeMessage);
};
listener.MessageReceived += Server_MessageReceived;

// Initialize Services
Task.WhenAll(listener.StartAsync(CancellationToken.None),
             router.StartAsync(CancellationToken.None)).ConfigureAwait(false);

For more information, refer to the Listener Class and the Router Class in the documentation.

Smtp Configuration

The Router has a property named DestinationSmtps, which represents a Dictionary<string, SmtpConfiguration>.

The Smtps to route messages must be cofigured and added to this collection. The Key field is the key to fetch the Smtp.

You can configure the Smtps when initializing the Server or Router, or you can configure a Smtp using the code below:

// Initializes a new Smtp Configuration
var smtpConfiguration = new SmtpConfiguration()
{
    Key = "Gmail",
    Description = "Gmail SMTP",
    Host = "smtp.gmail.com",
    Port = 587,
    RequiresAuthentication = true,
    UseSSL = false,
    User = "user@gmail.com",
    Password = "password"
};

The SmtpConfiguration object derives from an ObservableObject, which makes it compatible with Mvvm Implementations.

For more information, refer to the [SmtpConfigurati...

Assets 2

21 Apr 04:32

diassoft

v1.0.0.1

6867f95

SMTP Router v1.0.0.1

Smtp Router

The SMTP Router is a intermediate SMTP server useful to intercept messages and route it to another smtp.

It contains a Listener to capture Smtp messages and a Router that will route the message to another Smtp Server when it matches certain RoutingRules.

These are some of the uses of an SMTP Router:

Flexible SMTP Relay Server
Switch the destination SMTP server based on the incoming message. This is especially useful when you have systems that can only accept one single SMTP configuration and you want to use more than one SMTP.
Use Multiple SMTPs to send messages, due to daily our hourly limits defined by the email provider (in development)

How To Use It

There are two different ways to use the SMTP Router.

You can initialize a SmtpRouter.Server object or;
You can initialize a Listener and a Router manually.

The Listener opens a SmtpServer and listens to messages. Once a messages arrives, it will raise the MessageReceived event, with the MimeKit.MimeMessage received.

The Router runs in a separated thread from the Listener. The Router itself is the component which checks the RoutingRules and routes the message to the proper SMTP.

The Router creates a folder structure containing the following queues:

Queue	Description
Outgoing	Emails that need to be routed
Sent	Emails that were routed successfully
Retry	Emails that were not sent yet, but are still under the `MessageLifespan`. Those messages are sent back to the Outgoing queue.
Error	Emails that were not sent and the `MessageLifespan` is expired. Those messages are no longer sent unless they are moved manually to the Outgoing queue.

Prerequisites

When you choose to use the SmtpRouter Nuget Package, you will also be required to install the following packages:

Package	Nuget Link	Author
SmtpServer		cosullivan
MimeKit		jstedfast
MailKit		jstedfast

Using the Server Object

The easiest and recommended way to implement the SmtpRouter is by initializing an instance of the Server class and call the StartAsync to start listening to messages route them.

The code below demonstrates how to instantiate a server:

// Creates the Server
var server = new SMTPRouter.Server("localhost", 25, false, false, "SMTPRouter", "C:\\SMTPRouter\\Queues")
{
    MessageLifespan = new TimeSpan(0, 15, 0),
    RoutingRules = new List<Models.RoutingRule>()
    {
        new Models.MailFromDomainRoutingRule(10, "gmail.com", "gmail"),
        new Models.MailFromDomainRoutingRule(20, "hotmail.com", "hotmail")
    },
    DestinationSmtps = new Dictionary<string, Models.SmtpConfiguration>
    {
        { "gmail", new Models.SmtpConfiguration()
            {
                Host = "smtp.gmail.com",
                Description = "Google Mail SMTP",
                Port = 587,
                RequiresAuthentication = true,
                User = "user@gmail.com",
                Password = "",
            }
        },
        { "hotmail", new Models.SmtpConfiguration()
            {
                Host = "smtp.live.com",
                Description = "Hotmail SMTP",
                Port = 587,
                RequiresAuthentication = true,
                User = "user@hotmail.com",
                Password = "",
            }
        }
    },
};

// Initialize Services
Task.WhenAll(server.StartAsync(CancellationToken.None)).ConfigureAwait(false);

The Server class triggers events when certain activities happen. You can hook to the events by using the code below:

// Hook Events
server.SessionCreated += Server_SessionCreated;
server.SessionCommandExecuting += Server_SessionCommandExecuting;
server.SessionCompleted += Server_SessionCompleted;
server.ListeningStarted += Server_ListeningStarted;
server.MessageReceived += Server_MessageReceived;
server.MessageRoutedSuccessfully += Server_MessageRoutedSuccessfully;
server.MessageNotRouted += Server_MessageNotRouted;

Using the Listener and Router Individually

It is not necessary to instantiate the Listener and Router manually, but if you need to have more control, you can do it.

If you want to have the Router run in a different Service Instance, perhaps having both objects initialized separately would be the best option.

The code below demonstrates how to instantiate a Listener, a Router and hook them together using events.

// Create the Listener
var listener = new SMTPRouter.Listener()
{
    ServerName = "localhost",
    Ports = new int[] { 25, 587 },
    RequiresAuthentication = false,
    UseSSL = false
};
listener.SessionCreated += Server_SessionCreated;
listener.SessionCommandExecuting += Server_SessionCommandExecuting;
listener.SessionCompleted += Server_SessionCompleted;
listener.ListeningStarted += Server_ListeningStarted;

// Create the Router
var router = new SMTPRouter.Router("SMTPRouter", "C:\\SMTPRouter\\Queues")
{
    MessageLifespan = new TimeSpan(0, 15, 0),
    RoutingRules = new List<Models.RoutingRule>()
    {
        new Models.MailFromDomainRoutingRule(10, "gmail.com", "gmail"),
        new Models.MailFromDomainRoutingRule(20, "hotmail.com", "hotmail")
    },
    DestinationSmtps = new Dictionary<string, Models.SmtpConfiguration>
    {
        { "gmail", new Models.SmtpConfiguration()
            {
                Host = "smtp.gmail.com",
                Description = "Google Mail SMTP",
                Port = 587,
                RequiresAuthentication = true,
                User = "user@gmail.com",
                Password = "",
            }
        },
        { "hotmail", new Models.SmtpConfiguration()
            {
                Host = "smtp.live.com",
                Description = "Hotmail SMTP",
                Port = 587,
                RequiresAuthentication = true,
                User = "user@hotmail.com",
                Password = "",
            }
        }
    },
};
router.MessageRoutedSuccessfully += Server_MessageRoutedSuccessfully;
router.MessageNotRouted += Server_MessageNotRouted;

// When the Listener have a message, it has to be sent to the Router. This is Automatic when you use the Server class
listener.MessageReceived += (object sender, MessageEventArgs e) =>
{
    // Make sure to enqueue the message otherwise the router doesn't know about anything
    router.Enqueue(e.MimeMessage);
};
listener.MessageReceived += Server_MessageReceived;

// Initialize Services
Task.WhenAll(listener.StartAsync(CancellationToken.None),
             router.StartAsync(CancellationToken.None)).ConfigureAwait(false);

Smtp Configuration

The Router has a property named DestinationSmtps, which represents a Dictionary<string, SmtpConfiguration>.

The Smtps to route messages must be cofigured and added to this collection. The Key field is the key to fetch the Smtp.

You can configure the Smtps when initializing the Server or Router, or you can configure a Smtp using the code below:

// Initializes a new Smtp Configuration
var smtpConfiguration = new SmtpConfiguration()
{
    Key = "Gmail",
    Description = "Gmail SMTP",
    Host = "smtp.gmail.com",
    Port = 587,
    RequiresAuthentication = true,
    UseSSL = false,
    User = "user@gmail.com",
    Password = "password"
};

Routing Rules

The Router has a property named RoutingRules, which represents a List<RoutingRule>.

A RoutingRule is a Rule that can be applied and, if it matches, the Smtp Configuration for that rule will be used to route the email.

The RoutingRule class itself does not provide any rule, instead, it is a base class that must be inherited from in order to create an actual rule.

By default the SmtpRouter offers the MailFromDomainRoutingRule, which is a rule that verifies if the domain on the mail from matches the domain configured on the rule. Other RoutingRules are to be developed.

The code below demonstrates how to add a MailFromDomainRoutingRule to the Router object:

Router.RoutingRules.Add(new MailFromDomainRoutingRule(10, "mydomain.com", "mydomain"));

You can create your own Routing Rules by inheriting from RoutingRule class, as demonstrated on the code below:

public sealed class MyCustomRoutingRule: RoutingRule
{
    public MyCustomRoutingRule(): this(0)
    {
            
    }

    public MyCustomRoutingRule(int executionSequence, string smtpConfigurationKey): base(executionSequence)
    {
        base.SmtpConfigurationKey = smtpConfigurationKey;
    }

    public override bool Match(MimeMessage mimeMessage)
    {
        return true;
    }
}

You have to override the method Match to provide a algorithm that validades the rule.

Assets 2

Releases: olavodias/SMTPRouter.Gen1

SMTP Router v2.7.0

Smtp Router - v2.7.0

Uh oh!

SMTP Router v1.0.0.7

In this repository

Additional Repositories

How To Use It

Prerequisites

Using the Server Object

Using the Listener and Router Individually

Smtp Configuration

Uh oh!

SMTP Router v1.0.0.5

Smtp Router - v1.0.0.5

In this repository

Additional Repositories

How To Use It

Prerequisites

Using the Server Object

Using the Listener and Router Individually

Smtp Configuration

Uh oh!

SMTP Router v1.0.0.3

Smtp Router - v1.0.0.3

In this repository

Additional Repositories

How To Use It

Prerequisites

Using the Server Object

Using the Listener and Router Individually

Smtp Configuration

Uh oh!

SMTP Router v1.0.0.2

Smtp Router - v1.0.0.2

In this repository

Additional Repositories

How To Use It

Prerequisites

Using the Server Object

Using the Listener and Router Individually

Smtp Configuration

Uh oh!

SMTP Router v1.0.0.1

Smtp Router

How To Use It

Prerequisites

Using the Server Object

Using the Listener and Router Individually

Smtp Configuration

Routing Rules

Uh oh!