Manual:Tools/email: Difference between revisions

From MikroTik Wiki
Jump to navigation Jump to search
 
(4 intermediate revisions by one other user not shown)
Line 67: Line 67:




{{Note | All server's configuration (if specified) can be overridden by [[#Send | send]] command. If <b><nowiki>'''start-tls=tls-only'''</nowiki></b>, port 465 will be used}}
{{Note | All server's configuration (if specified) can be overridden by [[#Send | send]] command.}}


==Sending Email==
==Sending Email==
Line 92: Line 92:
|type=string
|type=string
|default=
|default=
|desc=Send a copy to listed recipients.
|desc=Send a copy to listed recipients. Multiple addresses allowed, use "," to separate entries
}}
}}


Line 156: Line 156:
|type=string
|type=string
|default=
|default=
|desc=Destination email address
|desc=Destination email address. Single address allowed.


}}
}}

Latest revision as of 12:27, 8 March 2023

Version.png

Applies to RouterOS: v3, v4, v5 +


Summary

E-mail tool is the utility that allows to send e-mails from the router. Tool can be used to send regular configuration backups and exports to network administrator.

Email tool uses only plain authentication and tls encryption. Other methods are not supported.


Properties

Sub-menu: /tool e-mail


This submenu allows to set smtp server that will be used.

Property Description
address (IP/IPv6 address; Default: 0.0.0.0) SMTP server's IP address.
from (string; Default: <>) Name or email address that will be shown as receiver.
password (string; Default: "") Password used for authenticate to SMTP server.
port (integer[0..65535]; Default: 25) SMTP server's port.
start-tls (no|yes|tls-only; Default: no) Whether to use tls encryption:
  • yes - sends STARTTLS and continue without TLS if server responds that TLS is not available;
  • no - do not send STARTTLS;
  • tls-only - sends STARTTLS and drops the session if TLS is not available on the server.
user (string; Default: "") Username used for authenticate to SMTP server.


Icon-note.png

Note: All server's configuration (if specified) can be overridden by send command.


Sending Email

Command: /tool e-mail send


Send command takes following parameters:

Property Description
body (string; Default: ) Actual body of the email message
cc (string; Default: ) Send a copy to listed recipients. Multiple addresses allowed, use "," to separate entries
file (File[,File]; Default: ) List of the file names that will be attached to the mail separated by comma.
from (string; Default: ) Name or email address which will appear as sender. If not specified value from server's configuration is used.
password (string; Default: ) Password used to authenticate to SMTP server. If not specified value from server's configuration is used.
port (integer[0..65535]; Default: ) Port of SMTP server. If not specified, value from server's configuration is used.
server (IP/IPv6 address; Default: ) Ip or IPv6 address of SMTP server. If not specified, value from server's configuration is used.
start-tls (yes|no|tls-only; Default: no) Whether to use tls encryption:
  • yes - sends STARTTLS and continue without TLS if server responds that TLS is not available;
  • no - do not send STARTTLS;
  • tls-only - sends STARTTLS and drops the session if TLS is not available on the server.
subject (string; Default: ) Subject of the message.
to (string; Default: ) Destination email address. Single address allowed.
user (string; Default: ) Username used to authenticate to SMTP server. If not specified, value from server's configuration is used.

Basic examples

This example will show how to send email with configuration export every 24hours.


1. Configure SMTP server

[admin@MikroTik] /tool e-mail> set server=10.1.1.1 port=25 from="router@mydomain.com"

2. Add new script named "export-send"

/export file=export
/tool e-mail send to="config@mydomain.com" subject="$[/system identity get name]  export" \
body="$[/system clock get date] configuration file" file=export.rsc

3. Add scheduler to run our script

/system scheduler
add on-event="export-send" start-time=00:00:00 interval=24h


Send e-mail to server using TLS/SSL encryption. For example, Google mail requires that.


1. configure client to connect to correct server

/tool e-mail
set address=173.194.77.108
set port=587
set from=myuser@gmail.com
set user=myuser
set password=mypassword

2. send e-mail using send command with tls attribute set to yes

send to=myuser@anotherdomain.com subject="email test" body="email test" start-tls=yes


[ Top | Back to Content ]