Difference between revisions of "SMTPSERVER"

From HSYCO
Jump to navigation Jump to search
 
(8 intermediate revisions by the same user not shown)
Line 27: Line 27:
 
|1...65535
 
|1...65535
 
|the SMTP port number. The server listens on the specified port of all available network interfaces.
 
|the SMTP port number. The server listens on the specified port of all available network interfaces.
 +
|-
 +
 +
|rowspan="2"|rawbody
 +
|rowspan="2"|false
 +
|false
 +
|when true, the SMTPSERVER returns the whole body message. When false, if the message content is multipart/alternative, it will look for the first text/plain part and return that part only as body
 +
|-
 +
|false
 +
|start generating events only after HSYCO is aligned with the current status of the system
 
|-
 
|-
  
Line 49: Line 58:
 
|JSON string
 
|JSON string
 
|R
 
|R
|a forced event generated when an email message is received.<br>The event's value is a JSON object containing all headers and the message body.<br>The body is arranged as an array of the first 64 lines od the body text. Lines after the 64th are ignored.
+
|a forced event generated when an email message is received.<br>The event's value is a JSON object containing all headers and the message body.<br>The body is arranged as an array of the first 64 lines od the body text. Lines after the 64th are ignored.<br>When the rawbody option is false, if the message content is multipart/alternative and a text/plain part is present, only that part is returned
 
|-
 
|-
  
Line 82: Line 91:
  
 
== Release Notes ==
 
== Release Notes ==
 +
=== 3.7.0 ===
 +
*fixed a bug that caused messages without a "Content-type" header in the body to be ignored
 +
 +
=== 3.6.0 ===
 +
*improved UTF-8 support
 +
*added support for multipart/alternative messages
 +
 
=== 3.5.1 ===
 
=== 3.5.1 ===
 
*initial release
 
*initial release

Latest revision as of 16:08, 19 October 2019

The SMTPSERVER I/O Server implements a very basic Simple Mail Transfer Protocol (SMTP) server based on a subset of the RFC 821 standard. The SMTP I/O Server is not intended to be used as an ordinary SMTP server in the open Internet, but as an internal server, inside a protected network and not accessible from unknown clients, for SMTP-based M2M communication, or for testing purposes.

HSYCO Configuration

Add an SMTPSERVER I/O Server in the I/O Servers section of the Settings and set its parameters.

Note that the SMTPSERVER I/O Server doesn't count in the I/O servers license total, so you don't need an extra I/O Server license to use SMTPSERVER with HSYCO.


Communication

n/a

High Availability

  • Shutdown when inactive: defaults to false.

Options

ID Default Values Description
port 25 1...65535 the SMTP port number. The server listens on the specified port of all available network interfaces.
rawbody false false when true, the SMTPSERVER returns the whole body message. When false, if the message content is multipart/alternative, it will look for the first text/plain part and return that part only as body
false start generating events only after HSYCO is aligned with the current status of the system
threads 4 > 0 the maximum number of concurrent active server threads (equivalent to connected clients).

Datapoints

ID Value R/W Description
mail JSON string R a forced event generated when an email message is received.
The event's value is a JSON object containing all headers and the message body.
The body is arranged as an array of the first 64 lines od the body text. Lines after the 64th are ignored.
When the rawbody option is false, if the message content is multipart/alternative and a text/plain part is present, only that part is returned

The following code in Events is an example of how to parse the event's value, assuming "smtp" is the SMTP I/O Server's ID:

function IOEvent(name, value) : {
	if (__run == 1 && name == "smtp.mail") {
		var mail = JSON.parse(value);
		messageLog("From: " + mail.from);
		messageLog("To: " + mail.to);
		messageLog("Date: " + mail.date);
		messageLog("Subject: " + mail.subject);
		for (i = 0; i < mail.body.length; i++) {
			messageLog("Body Line " + (i + 1) + ": " + mail.body[i]);
		}
	}
}


2016.01.25 18:24:49.582 - IO MONITOR FORCED: smtp.mail = {"from":"My Name <me@example.com>","to":"test@hsyco.com","subject":"This is a test","date":"Mon, 25 Jan 2016 18:24:49 +0100","contenttype":"text/plain; charset=us-ascii","returnpath":"","body":["My mail body."]} 
2016.01.25 18:24:49.590 - From: My Name <me@example.com>
2016.01.25 18:24:49.591 - To: test@hsyco.com 
2016.01.25 18:24:49.592 - Date: Mon, 25 Jan 2016 18:24:49 +0100 
2016.01.25 18:24:49.592 - Subject: This is a test
2016.01.25 18:24:49.593 - Body Line 1: My mail body.

Release Notes

3.7.0

  • fixed a bug that caused messages without a "Content-type" header in the body to be ignored

3.6.0

  • improved UTF-8 support
  • added support for multipart/alternative messages

3.5.1

  • initial release