Emails pipeline data through a SMTP server.
Synopsis
email [-e|--endpoint] [-f|--from <email>] [-s|--subject <string>]
[-u|--username <string>] [-p|--password <string>]
[-i|--authzid <string>] [-a|--authorization <string>]
[-P|--skip-peer-verification] [-H|--skip-hostname-verification]
[-m|--mime] [-v|--verbose]
<recipient>
Description
The email
saver establish a SMTP(S) connection to a mail server and sends
bytes as email body.
The default printer for the email
saver is json
.
<recipient>
The recipient of the mail.
The expected format is either Name <user@example.org>
with the email in angle
brackets, or a plain email adress, such as user@example.org
.
-e|--endpoint
The endpoint of the mail server.
To choose between SMTP and SMTPS, provide a URL with with the corresponding
scheme. For example, smtp://127.0.0.1:25
will establish an unencrypted
connection, whereas smtps://127.0.0.1:25
an encrypted one. If you specify a
server without a schema, the protocol defaults to SMTPS.
Defaults to smtp://localhost:25
.
-f|--from <email>
The From
header.
If you do not specify this parameter, an empty address is sent to the SMTP server which might cause the email to be rejected.
-s|--subject <string>
The Subject
header.
-u|--username <string>
The username in an authenticated SMTP connection.
-p|--password <string>
The password in an authenticated SMTP connection.
-i|--authzid <string>
The authorization identity in an authenticated SMTP connection.
This option is only applicable to the PLAIN SASL authentication mechanism where
it is optional. When not specified only the authentication identity (authcid
)
as specified by the username is sent to the server, along with the password. The
server derives an authzid
from the authcid
when not provided, which it then
uses internally. When the authzid
is specified it can be used to access
another user's inbox, that the user has been granted access to, or a shared
mailbox.
-a|--authorization <string>
The authorization options for an authenticated SMTP connection.
This login option defines the preferred authentication mechanism, e.g.,
AUTH=PLAIN
, AUTH=LOGIN
, or AUTH=*
.
-P|--skip-peer-verification
Skips certificate verification.
By default, an SMTPS connection verifies the authenticity of the peer's certificate. During connection negotiation, the server sends a certificate indicating its identity. We verify whether the certificate is authentic, i.e., that you can trust that the server is who the certificate says it is.
Providing this flag disables loading of the CA certificates and verification of the peer certificate.
-H|--skip-hostname-verification
Ignores verification of the server name in the certificate.
When negotiating TLS and SSL connections, the server sends a certificate indicating its identity. By default, that certificate must indicate that the server is the server to which you meant to connect, or the connection fails. That is, the server has to have the same name in the certificate as is in the URL you operate against. We consider the server the intended one when the Common Name field or a Subject Alternate Name field in the certificate matches the hostname in the URL.
Providing this flag skips this check, but it makes the connection insecure.
-m|--mime
Wraps the chunk into a MIME part.
The saver takes the uses the metadata of the byte chunk for the Content-Type
MIME header.
-v|--verbose
Enables verbose output on stderr.
This option is helpful for debugging on the command line.
Examples
Send the Tenzir version string as CSV to user@example.org
:
version
| write csv
| save email user@example.org
Send the email body as MIME part:
version
| write json
| save email --mime user@example.org
This may result in the following email body:
--------------------------s89ecto6c12ILX7893YOEf
Content-Type: application/json
Content-Transfer-Encoding: quoted-printable
{
"version": "4.10.4+ge0a060567b-dirty",
"build": "ge0a060567b-dirty",
"major": 4,
"minor": 10,
"patch": 4
}
--------------------------s89ecto6c12ILX7893YOEf--