... | @@ -9,39 +9,6 @@ authenticated SMTP for LDAP users of the `torproject.org` domain. |
... | @@ -9,39 +9,6 @@ authenticated SMTP for LDAP users of the `torproject.org` domain. |
|
|
|
|
|
# Tutorial
|
|
# Tutorial
|
|
|
|
|
|
<!-- simple, brainless step-by-step instructions requiring little or -->
|
|
|
|
<!-- no technical background -->
|
|
|
|
|
|
|
|
TODO: should include easy configuration instructions for major
|
|
|
|
platforms (Thunderbird, Mail app, Outlook and Google mail,
|
|
|
|
maybe?). pili volunteered to write/test the Mac OS instructions. ggus
|
|
|
|
says that Access Now! has some docs we could start from. vegas agrees
|
|
|
|
that this documentation and support will be covered by teams outside
|
|
|
|
of TPA.
|
|
|
|
|
|
|
|
# How-to
|
|
|
|
|
|
|
|
<!-- more in-depth procedure that may require interpretation -->
|
|
|
|
|
|
|
|
## Glossary
|
|
|
|
|
|
|
|
* **SMTP**: Simple Mail Transfer Protocol. The email protocol spoken
|
|
|
|
between servers to deliver email. Consists of two standards,
|
|
|
|
[RFC821](https://tools.ietf.org/html/rfc821) and [RFC5321](https://tools.ietf.org/html/rfc5321) which defined SMTP extensions, also
|
|
|
|
known as **ESMTP**.
|
|
|
|
* **MTA**: Mail Transport Agent. A generic SMTP server. Eugeni is
|
|
|
|
such a server.
|
|
|
|
* **MUA**: Mail User Agent. An "email client", a program used to
|
|
|
|
receive, manage and send email for users.
|
|
|
|
* **MSA** : Mail Submission Agent. An SMTP server specifically
|
|
|
|
designed to only *receive* email.
|
|
|
|
* **MDA**: Mail Delivery Agent. The email service actually writing
|
|
|
|
the email to the user's mailbox. Out of scope.
|
|
|
|
|
|
|
|
This document describes the implementation of a **MSA**, although the
|
|
|
|
service will most likely also include a **MTA** functionality in that
|
|
|
|
it will actually deliver emails to targets.
|
|
|
|
|
|
|
|
## Setting an email password
|
|
## Setting an email password
|
|
|
|
|
|
To use the email submission service, you first need to set a "mail
|
|
To use the email submission service, you first need to set a "mail
|
... | @@ -86,6 +53,38 @@ Then on first email send you will be prompted for your email |
... | @@ -86,6 +53,38 @@ Then on first email send you will be prompted for your email |
|
password. You should *NOT* get a certificate warning, a real cert
|
|
password. You should *NOT* get a certificate warning, a real cert
|
|
(signed by Let's Encrypt) should be presented by the server.
|
|
(signed by Let's Encrypt) should be presented by the server.
|
|
|
|
|
|
|
|
## Other clients
|
|
|
|
|
|
|
|
TODO: we should include easy configuration instructions for major
|
|
|
|
platforms (Thunderbird, Mail app, Outlook and Google mail,
|
|
|
|
maybe?). pili volunteered to write/test the Mac OS instructions. ggus
|
|
|
|
says that Access Now! has some docs we could start from. vegas agrees
|
|
|
|
that this documentation and support will be covered by teams outside
|
|
|
|
of TPA.
|
|
|
|
|
|
|
|
# How-to
|
|
|
|
|
|
|
|
<!-- more in-depth procedure that may require interpretation -->
|
|
|
|
|
|
|
|
## Glossary
|
|
|
|
|
|
|
|
* **SMTP**: Simple Mail Transfer Protocol. The email protocol spoken
|
|
|
|
between servers to deliver email. Consists of two standards,
|
|
|
|
[RFC821](https://tools.ietf.org/html/rfc821) and [RFC5321](https://tools.ietf.org/html/rfc5321) which defined SMTP extensions, also
|
|
|
|
known as **ESMTP**.
|
|
|
|
* **MTA**: Mail Transport Agent. A generic SMTP server. Eugeni is
|
|
|
|
such a server.
|
|
|
|
* **MUA**: Mail User Agent. An "email client", a program used to
|
|
|
|
receive, manage and send email for users.
|
|
|
|
* **MSA** : Mail Submission Agent. An SMTP server specifically
|
|
|
|
designed to only *receive* email.
|
|
|
|
* **MDA**: Mail Delivery Agent. The email service actually writing
|
|
|
|
the email to the user's mailbox. Out of scope.
|
|
|
|
|
|
|
|
This document describes the implementation of a **MSA**, although the
|
|
|
|
service will most likely also include a **MTA** functionality in that
|
|
|
|
it will actually deliver emails to targets.
|
|
|
|
|
|
## Pager playbook
|
|
## Pager playbook
|
|
|
|
|
|
TODO: pager playbook
|
|
TODO: pager playbook
|
... | | ... | |