SMTP Connector Tag

Help Contents

Introduction

The SMTP Connector Tag Channel Tag Icon provides a connection to a Simple Mail Transfer Protocol (SMTP) Server. Using this tag Fernhill SCADA can automatically send emails to users. Emails sent this way could contain:

Configuration Properties

The SMTP Connector Tag supports the properties of the Active Channel Tag plus these properties:

PropertyTypeVersionDescription
HostName WSTRING 3.23 The host name or IP address of the SMTP Server.
PortNumber WSTRING 3.23 The port number used for communications. The default port number for SMTP is 25.
FromAddress WSTRING 3.23 The "From" address in all emails sent using this connector. Where possible use a real email address to minimize the chance the SMTP server will reject messages sent from this connector.
InactivityTimeout Time 3.23 The maximum amount of time this SMTP connector will remain connected to the SMTP server when there are no emails to send.
Password WSTRING 3.24 The password used for SMTP Authentication. Note: The password value is encrypted and not stored as plain text.
UserName WSTRING 3.24 If set, the SMTP Connector will try and authenticate with the SMTP Server.

See SMTP Connector Setup Guide for a guide to set up the SMTP Connector tag.

TLS

The SMTP Connector Tag supports the STARTTLS extension (RFC 3207). If the SMTP Server supports STARTTLS, Fernhill SCADA will always try and negotiate an encrypted connection.

SMTP Authentication

If the UserName property is configured, the SMTP Connector will try and use SMTP Authentication to login to the SMTP Server. The SMTP Connector currently supports these authentication methods:

Information Information: If you have configured a UserName and Password make sure the SMTP Server supports the STARTTLS extension. If PLAIN authentication is used without encryption, the password is easily read and decoded by anyone who has access to the network.

When PLAIN authentication is used, the encoded username and password are not shown in diagnostic logs. If you monitor communication using the Data Log Window the encoded username and password will not be shown.

Data Properties

The SMTP Connector Tag supports the data properties of the Active Channel Tag plus these properties:

Property Type Description
MessagesRejected UDINT The number of messages rejected by the SMTP Server.
MessagesSent UDINT The number of messages accepted by the SMTP Server.
SMTPAuthMethod STRING[32] The authentication method used to login to the SMTP Server. This property will only show a value if the SMTP Connector Tag is online to the SMTP Server.

Tag Commands

The SMTP Connector Tag supports the tag commands of the Active Channel Tag plus these commands:

Tag Command Version Description
SendMessageTo 3.23 Sends an email to a user.

Relationships to Other Tag Types

The SMTP Connector Tag builds on the features of these tag types:

Further Information

Active Channel Tag

To learn about the properties common to all active channels.

Alarm Conditions

To learn about abnormal conditions in SCADA applications.

Glossary

For the meaning of terms used in Fernhill SCADA.