From 52d8efc1b84f625f36d8afea656d32e476fa61e1 Mon Sep 17 00:00:00 2001 From: Tom Mairs Date: Fri, 28 Apr 2023 12:35:32 -0700 Subject: [PATCH] Populate SMTP Injection page --- docs/userguide/operation/smtpinjection.md | 33 +++++++++++++++++++++++ 1 file changed, 33 insertions(+) diff --git a/docs/userguide/operation/smtpinjection.md b/docs/userguide/operation/smtpinjection.md index 87b88bd1..898b6e06 100644 --- a/docs/userguide/operation/smtpinjection.md +++ b/docs/userguide/operation/smtpinjection.md @@ -1 +1,34 @@ # Injecting Using SMTP + +KumoMTA will listen for message injection in any [listener](https://docs.kumomta.com/reference/kumo/start_esmtp_listener/) [defined](https://docs.kumomta.com/reference/kumo/start_http_listener/) in configuration. You have complete control over the IPs and Ports available for message injection. + +The ESMTP Listener will accept any properly formatted SMTP connection request allowd by its configuration. For instance, based on this: +```console +kumo.start_esmtp_listener { + listen = '0.0.0.0:25', + hostname = 'mail.example.com', + relay_hosts = { '127.0.0.1', '10.5.1.0/24' }, +} +``` +KumoMTA will accept any SMTP injection from the local host as well as any hosts in the 10.5.1.0/24 CIDR block on port 25. The most basic form of "injection" is to test from localhost using nc or telnet. + +```console +ehlo moto +mail from:youremail@address.com +rcpt to:youremail@address.com +DATA +from:youremail@address.com +to:youremail@address.com +subject: My First Email + +Hey, this is my first email! +. + +``` + +If that returns a `250 OK`, then any more complex injection should work as well. + +In most campaign systems that connect with third-party MTA's, you will need to enter the configuration settings, and find something like "SMTP" or "OutBound Email" and set the SMTP Port, Hostname or IP ddress and If you have configured [SMTP_Auth](https://docs.kumomta.com/reference/events/smtp_server_auth_plain/), your injection username and password as well. Below is a sample of the configuration page for [Mautic](https://docs.mautic.org/en/setup/how-to-install-mautic/install-mautic-from-package) marketing automation. + +![Mautic SMTP Configuration](/docs/assets/images/Mautic_SMTP_Config.png) +