An E-mail tool is a utility that allows sending e-mails from the router. The tool can be used to send regular configuration backups and exports to a network administrator.
Email tool uses only plain authentication and TLS encryption. Other methods are not supported.
Properties
/tool e-mail
This submenu allows setting 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 a receiver. |
password (string; Default: "") | Password used for authenticating to an SMTP server. |
port (integer[0..65535]; Default: 25) | SMTP server's port. |
tls (no|yes|starttls; Default: no) | Whether to use TLS encryption:
|
user (string; Default: "") | The username used for authenticating to an SMTP server. |
vrf (VRF name; default value: main) | Set VRF on which service is creating outgoing connections. |
Sending Email
/tool e-mail send
Send command takes the following parameters:
Property | Description |
---|---|
body (string; Default: ) | The 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 a comma. |
from (string; Default: ) | Name or email address which will appear as the sender. If a not specified value from the server's configuration is used. |
password (string; Default: ) | Password used to authenticate to an SMTP server. If a not specified value from the server's configuration is used. |
port (integer[0..65535]; Default: ) | Port of SMTP server. If not specified, a value from the server's configuration is used. |
server (IP/IPv6 address; Default: ) | Ip or IPv6 address of SMTP server. If not specified, a value from the server's configuration is used. |
tls (yes|no|starttls; Default: no) | Whether to use TLS encryption:
|
subject (string; Default: ) | The subject of the message. |
to (string; Default: ) | Destination email address. Single address allowed. |
user (string; Default: ) | The username used to authenticate to an SMTP server. If not specified, a value from the server's configuration is used. |
Basic examples
This example will show how to send an 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 a 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 a server using TLS/SSL encryption. For example, Google mail requires that.
After the Google mail added a new security policy that does not allow 3d-party devices to authenticate using your standard Gmail password → you need to generate a 16-digit passcode ("App" password) and use it instead of your Gmail password. To configure this, navigate to the "Security>Signing in to Google" section settings and:
- Enable 2-Step Verification;
- Generate an App password.
Use the newly generated App password in the "set password=mypassword" setting shown below.
1. configure a client to connect to the correct server:
/tool e-mail set address=173.194.77.108 set port=465 set tls=yes set from=myuser@gmail.com set user=myuser set password=mypassword
2. send e-mail using send command with TLS attribute set to yes:
/tool e-mail send to=myuser@anotherdomain.com subject="email test" body="email test" tls=starttls