2023-01-30 16:27:06 +03:00
package mox
import (
"bytes"
"context"
"crypto/ed25519"
cryptorand "crypto/rand"
"crypto/rsa"
"crypto/x509"
"encoding/pem"
"fmt"
"net"
2023-08-23 15:27:21 +03:00
"net/url"
2023-01-30 16:27:06 +03:00
"os"
"path/filepath"
"sort"
2023-03-29 11:55:05 +03:00
"strings"
2023-01-30 16:27:06 +03:00
"time"
"github.com/mjl-/mox/config"
"github.com/mjl-/mox/dkim"
2023-08-23 15:27:21 +03:00
"github.com/mjl-/mox/dmarc"
2023-01-30 16:27:06 +03:00
"github.com/mjl-/mox/dns"
"github.com/mjl-/mox/junk"
"github.com/mjl-/mox/mlog"
"github.com/mjl-/mox/mtasts"
"github.com/mjl-/mox/smtp"
2023-08-23 15:27:21 +03:00
"github.com/mjl-/mox/tlsrpt"
2023-01-30 16:27:06 +03:00
)
// TXTStrings returns a TXT record value as one or more quoted strings, taking the max
// length of 255 characters for a string into account.
func TXTStrings ( s string ) string {
r := ""
for len ( s ) > 0 {
n := len ( s )
if n > 255 {
n = 255
}
if r != "" {
r += " "
}
r += ` " ` + s [ : n ] + ` " `
s = s [ n : ]
}
return r
}
// MakeDKIMEd25519Key returns a PEM buffer containing an ed25519 key for use
// with DKIM.
// selector and domain can be empty. If not, they are used in the note.
func MakeDKIMEd25519Key ( selector , domain dns . Domain ) ( [ ] byte , error ) {
_ , privKey , err := ed25519 . GenerateKey ( cryptorand . Reader )
if err != nil {
return nil , fmt . Errorf ( "generating key: %w" , err )
}
pkcs8 , err := x509 . MarshalPKCS8PrivateKey ( privKey )
if err != nil {
return nil , fmt . Errorf ( "marshal key: %w" , err )
}
block := & pem . Block {
Type : "PRIVATE KEY" ,
Headers : map [ string ] string {
"Note" : dkimKeyNote ( "ed25519" , selector , domain ) ,
} ,
Bytes : pkcs8 ,
}
b := & bytes . Buffer { }
if err := pem . Encode ( b , block ) ; err != nil {
return nil , fmt . Errorf ( "encoding pem: %w" , err )
}
return b . Bytes ( ) , nil
}
func dkimKeyNote ( kind string , selector , domain dns . Domain ) string {
s := kind + " dkim private key"
var zero dns . Domain
if selector != zero && domain != zero {
s += fmt . Sprintf ( " for %s._domainkey.%s" , selector . ASCII , domain . ASCII )
}
s += fmt . Sprintf ( ", generated by mox on %s" , time . Now ( ) . Format ( time . RFC3339 ) )
return s
}
// MakeDKIMEd25519Key returns a PEM buffer containing an rsa key for use with
// DKIM.
// selector and domain can be empty. If not, they are used in the note.
func MakeDKIMRSAKey ( selector , domain dns . Domain ) ( [ ] byte , error ) {
// 2048 bits seems reasonable in 2022, 1024 is on the low side, larger
// keys may not fit in UDP DNS response.
privKey , err := rsa . GenerateKey ( cryptorand . Reader , 2048 )
if err != nil {
return nil , fmt . Errorf ( "generating key: %w" , err )
}
pkcs8 , err := x509 . MarshalPKCS8PrivateKey ( privKey )
if err != nil {
return nil , fmt . Errorf ( "marshal key: %w" , err )
}
block := & pem . Block {
Type : "PRIVATE KEY" ,
Headers : map [ string ] string {
"Note" : dkimKeyNote ( "rsa" , selector , domain ) ,
} ,
Bytes : pkcs8 ,
}
b := & bytes . Buffer { }
if err := pem . Encode ( b , block ) ; err != nil {
return nil , fmt . Errorf ( "encoding pem: %w" , err )
}
return b . Bytes ( ) , nil
}
// MakeAccountConfig returns a new account configuration for an email address.
func MakeAccountConfig ( addr smtp . Address ) config . Account {
account := config . Account {
Domain : addr . Domain . Name ( ) ,
Destinations : map [ string ] config . Destination {
2023-03-10 00:07:37 +03:00
addr . String ( ) : { } ,
2023-01-30 16:27:06 +03:00
} ,
RejectsMailbox : "Rejects" ,
JunkFilter : & config . JunkFilter {
Threshold : 0.95 ,
Params : junk . Params {
Onegrams : true ,
MaxPower : .01 ,
TopWords : 10 ,
IgnoreWords : .1 ,
RareWords : 2 ,
} ,
} ,
}
improve training of junk filter
before, we used heuristics to decide when to train/untrain a message as junk or
nonjunk: the message had to be seen, be in certain mailboxes. then if a message
was marked as junk, it was junk. and otherwise it was nonjunk. this wasn't good
enough: you may want to keep some messages around as neither junk or nonjunk.
and that wasn't possible.
ideally, we would just look at the imap $Junk and $NotJunk flags. the problem
is that mail clients don't set these flags, or don't make it easy. thunderbird
can set the flags based on its own bayesian filter. it has a shortcut for
marking Junk and moving it to the junk folder (good), but the counterpart of
notjunk only marks a message as notjunk without showing in the UI that it was
marked as notjunk. there is also no "move and mark as notjunk" mechanism. e.g.
"archive" does not mark a message as notjunk. ios mail and mutt don't appear to
have any way to see or change the $Junk and $NotJunk flags.
what email clients do have is the ability to move messages to other
mailboxes/folders. so mox now has a mechanism that allows you to configure
mailboxes that automatically set $Junk or $NotJunk (or clear both) when a
message is moved/copied/delivered to that folder. e.g. a mailbox called junk or
spam or rejects marks its messags as junk. inbox, postmaster, dmarc, tlsrpt,
neutral* mark their messages as neither junk or notjunk. other folders mark
their messages as notjunk. e.g. list/*, archive. this functionality is
optional, but enabled with the quickstart and for new accounts.
also, mox now keeps track of the previous training of a message and will only
untrain/train if needed. before, there probably have been duplicate or missing
(un)trainings.
this also includes a new subcommand "retrain" to recreate the junkfilter for an
account. you should run it after updating to this version. and you should
probably also modify your account config to include the AutomaticJunkFlags.
2023-02-12 01:00:12 +03:00
account . AutomaticJunkFlags . Enabled = true
2023-02-13 12:47:20 +03:00
account . AutomaticJunkFlags . JunkMailboxRegexp = "^(junk|spam)"
account . AutomaticJunkFlags . NeutralMailboxRegexp = "^(inbox|neutral|postmaster|dmarc|tlsrpt|rejects)"
2023-01-30 16:27:06 +03:00
account . SubjectPass . Period = 12 * time . Hour
return account
}
// MakeDomainConfig makes a new config for a domain, creating DKIM keys, using
// accountName for DMARC and TLS reports.
change mox to start as root, bind to network sockets, then drop to regular unprivileged mox user
makes it easier to run on bsd's, where you cannot (easily?) let non-root users
bind to ports <1024. starting as root also paves the way for future improvements
with privilege separation.
unfortunately, this requires changes to how you start mox. though mox will help
by automatically fix up dir/file permissions/ownership.
if you start mox from the systemd unit file, you should update it so it starts
as root and adds a few additional capabilities:
# first update the mox binary, then, as root:
./mox config printservice >mox.service
systemctl daemon-reload
systemctl restart mox
journalctl -f -u mox &
# you should see mox start up, with messages about fixing permissions on dirs/files.
if you used the recommended config/ and data/ directory, in a directory just for
mox, and with the mox user called "mox", this should be enough.
if you don't want mox to modify dir/file permissions, set "NoFixPermissions:
true" in mox.conf.
if you named the mox user something else than mox, e.g. "_mox", add "User: _mox"
to mox.conf.
if you created a shared service user as originally suggested, you may want to
get rid of that as it is no longer useful and may get in the way. e.g. if you
had /home/service/mox with a "service" user, that service user can no longer
access any files: only mox and root can.
this also adds scripts for building mox docker images for alpine-supported
platforms.
the "restart" subcommand has been removed. it wasn't all that useful and got in
the way.
and another change: when adding a domain while mtasts isn't enabled, don't add
the per-domain mtasts config, as it would cause failure to add the domain.
based on report from setting up mox on openbsd from mteege.
and based on issue #3. thanks for the feedback!
2023-02-27 14:19:55 +03:00
func MakeDomainConfig ( ctx context . Context , domain , hostname dns . Domain , accountName string , withMTASTS bool ) ( config . Domain , [ ] string , error ) {
2023-01-30 16:27:06 +03:00
log := xlog . WithContext ( ctx )
now := time . Now ( )
year := now . Format ( "2006" )
timestamp := now . Format ( "20060102T150405" )
var paths [ ] string
defer func ( ) {
for _ , p := range paths {
2023-02-16 15:22:00 +03:00
err := os . Remove ( p )
log . Check ( err , "removing path for domain config" , mlog . Field ( "path" , p ) )
2023-01-30 16:27:06 +03:00
}
} ( )
writeFile := func ( path string , data [ ] byte ) error {
os . MkdirAll ( filepath . Dir ( path ) , 0770 )
f , err := os . OpenFile ( path , os . O_WRONLY | os . O_CREATE | os . O_EXCL , 0660 )
if err != nil {
return fmt . Errorf ( "creating file %s: %s" , path , err )
}
defer func ( ) {
if f != nil {
2023-02-16 15:22:00 +03:00
err := os . Remove ( path )
log . Check ( err , "removing file after error" )
err = f . Close ( )
log . Check ( err , "closing file after error" )
2023-01-30 16:27:06 +03:00
}
} ( )
if _ , err := f . Write ( data ) ; err != nil {
return fmt . Errorf ( "writing file %s: %s" , path , err )
}
if err := f . Close ( ) ; err != nil {
return fmt . Errorf ( "close file: %v" , err )
}
f = nil
return nil
}
confDKIM := config . DKIM {
Selectors : map [ string ] config . Selector { } ,
}
addSelector := func ( kind , name string , privKey [ ] byte ) error {
record := fmt . Sprintf ( "%s._domainkey.%s" , name , domain . ASCII )
keyPath := filepath . Join ( "dkim" , fmt . Sprintf ( "%s.%s.%skey.pkcs8.pem" , record , timestamp , kind ) )
2023-07-02 14:53:34 +03:00
p := configDirPath ( ConfigDynamicPath , keyPath )
2023-01-30 16:27:06 +03:00
if err := writeFile ( p , privKey ) ; err != nil {
return err
}
paths = append ( paths , p )
confDKIM . Selectors [ name ] = config . Selector {
// Example from RFC has 5 day between signing and expiration. ../rfc/6376:1393
// Expiration is not intended as antireplay defense, but it may help. ../rfc/6376:1340
// Messages in the wild have been observed with 2 hours and 1 year expiration.
Expiration : "72h" ,
PrivateKeyFile : keyPath ,
}
return nil
}
addEd25519 := func ( name string ) error {
key , err := MakeDKIMEd25519Key ( dns . Domain { ASCII : name } , domain )
if err != nil {
return fmt . Errorf ( "making dkim ed25519 private key: %s" , err )
}
return addSelector ( "ed25519" , name , key )
}
addRSA := func ( name string ) error {
key , err := MakeDKIMRSAKey ( dns . Domain { ASCII : name } , domain )
if err != nil {
return fmt . Errorf ( "making dkim rsa private key: %s" , err )
}
return addSelector ( "rsa" , name , key )
}
if err := addEd25519 ( year + "a" ) ; err != nil {
return config . Domain { } , nil , err
}
if err := addRSA ( year + "b" ) ; err != nil {
return config . Domain { } , nil , err
}
if err := addEd25519 ( year + "c" ) ; err != nil {
return config . Domain { } , nil , err
}
if err := addRSA ( year + "d" ) ; err != nil {
return config . Domain { } , nil , err
}
// We sign with the first two. In case they are misused, the switch to the other
// keys is easy, just change the config. Operators should make the public key field
// of the misused keys empty in the DNS records to disable the misused keys.
confDKIM . Sign = [ ] string { year + "a" , year + "b" }
confDomain := config . Domain {
LocalpartCatchallSeparator : "+" ,
DKIM : confDKIM ,
DMARC : & config . DMARC {
Account : accountName ,
Localpart : "dmarc-reports" ,
Mailbox : "DMARC" ,
} ,
TLSRPT : & config . TLSRPT {
Account : accountName ,
Localpart : "tls-reports" ,
Mailbox : "TLSRPT" ,
} ,
}
change mox to start as root, bind to network sockets, then drop to regular unprivileged mox user
makes it easier to run on bsd's, where you cannot (easily?) let non-root users
bind to ports <1024. starting as root also paves the way for future improvements
with privilege separation.
unfortunately, this requires changes to how you start mox. though mox will help
by automatically fix up dir/file permissions/ownership.
if you start mox from the systemd unit file, you should update it so it starts
as root and adds a few additional capabilities:
# first update the mox binary, then, as root:
./mox config printservice >mox.service
systemctl daemon-reload
systemctl restart mox
journalctl -f -u mox &
# you should see mox start up, with messages about fixing permissions on dirs/files.
if you used the recommended config/ and data/ directory, in a directory just for
mox, and with the mox user called "mox", this should be enough.
if you don't want mox to modify dir/file permissions, set "NoFixPermissions:
true" in mox.conf.
if you named the mox user something else than mox, e.g. "_mox", add "User: _mox"
to mox.conf.
if you created a shared service user as originally suggested, you may want to
get rid of that as it is no longer useful and may get in the way. e.g. if you
had /home/service/mox with a "service" user, that service user can no longer
access any files: only mox and root can.
this also adds scripts for building mox docker images for alpine-supported
platforms.
the "restart" subcommand has been removed. it wasn't all that useful and got in
the way.
and another change: when adding a domain while mtasts isn't enabled, don't add
the per-domain mtasts config, as it would cause failure to add the domain.
based on report from setting up mox on openbsd from mteege.
and based on issue #3. thanks for the feedback!
2023-02-27 14:19:55 +03:00
if withMTASTS {
confDomain . MTASTS = & config . MTASTS {
PolicyID : time . Now ( ) . UTC ( ) . Format ( "20060102T150405" ) ,
Mode : mtasts . ModeEnforce ,
// We start out with 24 hour, and warn in the admin interface that users should
// increase it to weeks once the setup works.
MaxAge : 24 * time . Hour ,
MX : [ ] string { hostname . ASCII } ,
}
}
2023-01-30 16:27:06 +03:00
rpaths := paths
paths = nil
return confDomain , rpaths , nil
}
// DomainAdd adds the domain to the domains config, rewriting domains.conf and
// marking it loaded.
//
2023-04-24 13:04:46 +03:00
// accountName is used for DMARC/TLS report and potentially for the postmaster address.
2023-01-30 16:27:06 +03:00
// If the account does not exist, it is created with localpart. Localpart must be
// set only if the account does not yet exist.
func DomainAdd ( ctx context . Context , domain dns . Domain , accountName string , localpart smtp . Localpart ) ( rerr error ) {
log := xlog . WithContext ( ctx )
defer func ( ) {
if rerr != nil {
log . Errorx ( "adding domain" , rerr , mlog . Field ( "domain" , domain ) , mlog . Field ( "account" , accountName ) , mlog . Field ( "localpart" , localpart ) )
}
} ( )
Conf . dynamicMutex . Lock ( )
defer Conf . dynamicMutex . Unlock ( )
c := Conf . Dynamic
if _ , ok := c . Domains [ domain . Name ( ) ] ; ok {
return fmt . Errorf ( "domain already present" )
}
// Compose new config without modifying existing data structures. If we fail, we
// leave no trace.
nc := c
nc . Domains = map [ string ] config . Domain { }
for name , d := range c . Domains {
nc . Domains [ name ] = d
}
change mox to start as root, bind to network sockets, then drop to regular unprivileged mox user
makes it easier to run on bsd's, where you cannot (easily?) let non-root users
bind to ports <1024. starting as root also paves the way for future improvements
with privilege separation.
unfortunately, this requires changes to how you start mox. though mox will help
by automatically fix up dir/file permissions/ownership.
if you start mox from the systemd unit file, you should update it so it starts
as root and adds a few additional capabilities:
# first update the mox binary, then, as root:
./mox config printservice >mox.service
systemctl daemon-reload
systemctl restart mox
journalctl -f -u mox &
# you should see mox start up, with messages about fixing permissions on dirs/files.
if you used the recommended config/ and data/ directory, in a directory just for
mox, and with the mox user called "mox", this should be enough.
if you don't want mox to modify dir/file permissions, set "NoFixPermissions:
true" in mox.conf.
if you named the mox user something else than mox, e.g. "_mox", add "User: _mox"
to mox.conf.
if you created a shared service user as originally suggested, you may want to
get rid of that as it is no longer useful and may get in the way. e.g. if you
had /home/service/mox with a "service" user, that service user can no longer
access any files: only mox and root can.
this also adds scripts for building mox docker images for alpine-supported
platforms.
the "restart" subcommand has been removed. it wasn't all that useful and got in
the way.
and another change: when adding a domain while mtasts isn't enabled, don't add
the per-domain mtasts config, as it would cause failure to add the domain.
based on report from setting up mox on openbsd from mteege.
and based on issue #3. thanks for the feedback!
2023-02-27 14:19:55 +03:00
// Only enable mta-sts for domain if there is a listener with mta-sts.
var withMTASTS bool
for _ , l := range Conf . Static . Listeners {
if l . MTASTSHTTPS . Enabled {
withMTASTS = true
break
}
}
confDomain , cleanupFiles , err := MakeDomainConfig ( ctx , domain , Conf . Static . HostnameDomain , accountName , withMTASTS )
2023-01-30 16:27:06 +03:00
if err != nil {
return fmt . Errorf ( "preparing domain config: %v" , err )
}
defer func ( ) {
for _ , f := range cleanupFiles {
2023-02-16 15:22:00 +03:00
err := os . Remove ( f )
log . Check ( err , "cleaning up file after error" , mlog . Field ( "path" , f ) )
2023-01-30 16:27:06 +03:00
}
} ( )
if _ , ok := c . Accounts [ accountName ] ; ok && localpart != "" {
return fmt . Errorf ( "account already exists (leave localpart empty when using an existing account)" )
} else if ! ok && localpart == "" {
return fmt . Errorf ( "account does not yet exist (specify a localpart)" )
} else if accountName == "" {
return fmt . Errorf ( "account name is empty" )
} else if ! ok {
nc . Accounts [ accountName ] = MakeAccountConfig ( smtp . Address { Localpart : localpart , Domain : domain } )
2023-04-24 13:04:46 +03:00
} else if accountName != Conf . Static . Postmaster . Account {
nacc := nc . Accounts [ accountName ]
nd := map [ string ] config . Destination { }
for k , v := range nacc . Destinations {
nd [ k ] = v
}
pmaddr := smtp . Address { Localpart : "postmaster" , Domain : domain }
nd [ pmaddr . String ( ) ] = config . Destination { }
nacc . Destinations = nd
nc . Accounts [ accountName ] = nacc
2023-01-30 16:27:06 +03:00
}
nc . Domains [ domain . Name ( ) ] = confDomain
2023-02-16 15:22:00 +03:00
if err := writeDynamic ( ctx , log , nc ) ; err != nil {
2023-01-30 16:27:06 +03:00
return fmt . Errorf ( "writing domains.conf: %v" , err )
}
log . Info ( "domain added" , mlog . Field ( "domain" , domain ) )
cleanupFiles = nil // All good, don't cleanup.
return nil
}
// DomainRemove removes domain from the config, rewriting domains.conf.
//
// No accounts are removed, also not when they still reference this domain.
func DomainRemove ( ctx context . Context , domain dns . Domain ) ( rerr error ) {
log := xlog . WithContext ( ctx )
defer func ( ) {
if rerr != nil {
log . Errorx ( "removing domain" , rerr , mlog . Field ( "domain" , domain ) )
}
} ( )
Conf . dynamicMutex . Lock ( )
defer Conf . dynamicMutex . Unlock ( )
c := Conf . Dynamic
domConf , ok := c . Domains [ domain . Name ( ) ]
if ! ok {
return fmt . Errorf ( "domain does not exist" )
}
// Compose new config without modifying existing data structures. If we fail, we
// leave no trace.
nc := c
nc . Domains = map [ string ] config . Domain { }
s := domain . Name ( )
for name , d := range c . Domains {
if name != s {
nc . Domains [ name ] = d
}
}
2023-02-16 15:22:00 +03:00
if err := writeDynamic ( ctx , log , nc ) ; err != nil {
2023-01-30 16:27:06 +03:00
return fmt . Errorf ( "writing domains.conf: %v" , err )
}
// Move away any DKIM private keys to a subdirectory "old". But only if
// they are not in use by other domains.
usedKeyPaths := map [ string ] bool { }
for _ , dc := range nc . Domains {
for _ , sel := range dc . DKIM . Selectors {
usedKeyPaths [ filepath . Clean ( sel . PrivateKeyFile ) ] = true
}
}
for _ , sel := range domConf . DKIM . Selectors {
if sel . PrivateKeyFile == "" || usedKeyPaths [ filepath . Clean ( sel . PrivateKeyFile ) ] {
continue
}
src := ConfigDirPath ( sel . PrivateKeyFile )
dst := ConfigDirPath ( filepath . Join ( filepath . Dir ( sel . PrivateKeyFile ) , "old" , filepath . Base ( sel . PrivateKeyFile ) ) )
_ , err := os . Stat ( dst )
if err == nil {
err = fmt . Errorf ( "destination already exists" )
} else if os . IsNotExist ( err ) {
os . MkdirAll ( filepath . Dir ( dst ) , 0770 )
err = os . Rename ( src , dst )
}
if err != nil {
log . Errorx ( "renaming dkim private key file for removed domain" , err , mlog . Field ( "src" , src ) , mlog . Field ( "dst" , dst ) )
}
}
log . Info ( "domain removed" , mlog . Field ( "domain" , domain ) )
return nil
}
improve webserver, add domain redirects (aliases), add tests and admin page ui to manage the config
- make builtin http handlers serve on specific domains, such as for mta-sts, so
e.g. /.well-known/mta-sts.txt isn't served on all domains.
- add logging of a few more fields in access logging.
- small tweaks/bug fixes in webserver request handling.
- add config option for redirecting entire domains to another (common enough).
- split httpserver metric into two: one for duration until writing header (i.e.
performance of server), another for duration until full response is sent to
client (i.e. performance as perceived by users).
- add admin ui, a new page for managing the configs. after making changes
and hitting "save", the changes take effect immediately. the page itself
doesn't look very well-designed (many input fields, makes it look messy). i
have an idea to improve it (explained in admin.html as todo) by making the
layout look just like the config file. not urgent though.
i've already changed my websites/webapps over.
the idea of adding a webserver is to take away a (the) reason for folks to want
to complicate their mox setup by running an other webserver on the same machine.
i think the current webserver implementation can already serve most common use
cases. with a few more tweaks (feedback needed!) we should be able to get to 95%
of the use cases. the reverse proxy can take care of the remaining 5%.
nevertheless, a next step is still to change the quickstart to make it easier
for folks to run with an existing webserver, with existing tls certs/keys.
that's how this relates to issue #5.
2023-03-02 20:15:54 +03:00
func WebserverConfigSet ( ctx context . Context , domainRedirects map [ string ] string , webhandlers [ ] config . WebHandler ) ( rerr error ) {
log := xlog . WithContext ( ctx )
defer func ( ) {
if rerr != nil {
log . Errorx ( "saving webserver config" , rerr )
}
} ( )
Conf . dynamicMutex . Lock ( )
defer Conf . dynamicMutex . Unlock ( )
// Compose new config without modifying existing data structures. If we fail, we
// leave no trace.
nc := Conf . Dynamic
nc . WebDomainRedirects = domainRedirects
nc . WebHandlers = webhandlers
if err := writeDynamic ( ctx , log , nc ) ; err != nil {
return fmt . Errorf ( "writing domains.conf: %v" , err )
}
log . Info ( "webserver config saved" )
return nil
}
2023-01-30 16:27:06 +03:00
// todo: find a way to automatically create the dns records as it would greatly simplify setting up email for a domain. we could also dynamically make changes, e.g. providing grace periods after disabling a dkim key, only automatically removing the dkim dns key after a few days. but this requires some kind of api and authentication to the dns server. there doesn't appear to be a single commonly used api for dns management. each of the numerous cloud providers have their own APIs and rather large SKDs to use them. we don't want to link all of them in.
// DomainRecords returns text lines describing DNS records required for configuring
// a domain.
func DomainRecords ( domConf config . Domain , domain dns . Domain ) ( [ ] string , error ) {
d := domain . ASCII
h := Conf . Static . HostnameDomain . ASCII
records := [ ] string {
2023-02-27 17:04:32 +03:00
"; Time To Live of 5 minutes, may be recognized if importing as a zone file." ,
"; Once your setup is working, you may want to increase the TTL." ,
2023-01-30 16:27:06 +03:00
"$TTL 300" ,
"" ,
2023-08-25 15:32:28 +03:00
}
2023-01-30 16:27:06 +03:00
2023-08-25 15:32:28 +03:00
if d != h {
records = append ( records ,
"; For the machine, only needs to be created once, for the first domain added." ,
fmt . Sprintf ( ` %-*s IN TXT "v=spf1 a -all" ` , 20 + len ( d ) , h + "." ) , // ../rfc/7208:2263 ../rfc/7208:2287
"" ,
)
}
2023-02-03 17:54:34 +03:00
2023-08-25 15:32:28 +03:00
records = append ( records ,
2023-02-03 17:54:34 +03:00
"; Deliver email for the domain to this host." ,
2023-01-30 16:27:06 +03:00
fmt . Sprintf ( "%s. MX 10 %s." , d , h ) ,
"" ,
"; Outgoing messages will be signed with the first two DKIM keys. The other two" ,
"; configured for backup, switching to them is just a config change." ,
2023-08-25 15:32:28 +03:00
)
2023-01-30 16:27:06 +03:00
var selectors [ ] string
for name := range domConf . DKIM . Selectors {
selectors = append ( selectors , name )
}
sort . Slice ( selectors , func ( i , j int ) bool {
return selectors [ i ] < selectors [ j ]
} )
for _ , name := range selectors {
sel := domConf . DKIM . Selectors [ name ]
dkimr := dkim . Record {
Version : "DKIM1" ,
Hashes : [ ] string { "sha256" } ,
PublicKey : sel . Key . Public ( ) ,
}
if _ , ok := sel . Key . ( ed25519 . PrivateKey ) ; ok {
dkimr . Key = "ed25519"
} else if _ , ok := sel . Key . ( * rsa . PrivateKey ) ; ! ok {
return nil , fmt . Errorf ( "unrecognized private key for DKIM selector %q: %T" , name , sel . Key )
}
txt , err := dkimr . Record ( )
if err != nil {
return nil , fmt . Errorf ( "making DKIM DNS TXT record: %v" , err )
}
if len ( txt ) > 255 {
records = append ( records ,
"; NOTE: Ensure the next record is added in DNS as a single record, it consists" ,
"; of multiple strings (max size of each is 255 bytes)." ,
)
}
s := fmt . Sprintf ( "%s._domainkey.%s. IN TXT %s" , name , d , TXTStrings ( txt ) )
records = append ( records , s )
}
2023-08-23 15:27:21 +03:00
dmarcr := dmarc . DefaultRecord
dmarcr . Policy = "reject"
if domConf . DMARC != nil {
uri := url . URL {
Scheme : "mailto" ,
Opaque : smtp . NewAddress ( domConf . DMARC . ParsedLocalpart , domConf . DMARC . DNSDomain ) . Pack ( false ) ,
}
dmarcr . AggregateReportAddresses = [ ] dmarc . URI {
{ Address : uri . String ( ) , MaxSize : 10 , Unit : "m" } ,
}
}
2023-01-30 16:27:06 +03:00
records = append ( records ,
"" ,
"; Specify the MX host is allowed to send for our domain and for itself (for DSNs)." ,
"; ~all means softfail for anything else, which is done instead of -all to prevent older" ,
"; mail servers from rejecting the message because they never get to looking for a dkim/dmarc pass." ,
fmt . Sprintf ( ` %s. IN TXT "v=spf1 mx ~all" ` , d ) ,
"" ,
2023-08-23 15:27:21 +03:00
"; Emails that fail the DMARC check (without aligned DKIM and without aligned SPF)" ,
"; should be rejected, and request reports. If you email through mailing lists that" ,
"; strip DKIM-Signature headers and don't rewrite the From header, you may want to" ,
"; set the policy to p=none." ,
fmt . Sprintf ( ` _dmarc.%s. IN TXT "%s" ` , d , dmarcr . String ( ) ) ,
2023-01-30 16:27:06 +03:00
"" ,
)
if sts := domConf . MTASTS ; sts != nil {
records = append ( records ,
"; TLS must be used when delivering to us." ,
fmt . Sprintf ( ` mta-sts.%s. IN CNAME %s. ` , d , h ) ,
fmt . Sprintf ( ` _mta-sts.%s. IN TXT "v=STSv1; id=%s" ` , d , sts . PolicyID ) ,
"" ,
)
2023-02-27 17:04:32 +03:00
} else {
records = append ( records ,
"; Note: No MTA-STS to indicate TLS should be used. Either because disabled for the" ,
"; domain or because mox.conf does not have a listener with MTA-STS configured." ,
"" ,
)
2023-01-30 16:27:06 +03:00
}
2023-08-23 15:27:21 +03:00
if domConf . TLSRPT != nil {
uri := url . URL {
Scheme : "mailto" ,
Opaque : smtp . NewAddress ( domConf . TLSRPT . ParsedLocalpart , domConf . TLSRPT . DNSDomain ) . Pack ( false ) ,
}
tlsrptr := tlsrpt . Record { Version : "TLSRPTv1" , RUAs : [ ] [ ] string { { uri . String ( ) } } }
records = append ( records ,
"; Request reporting about TLS failures." ,
fmt . Sprintf ( ` _smtp._tls.%s. IN TXT "%s" ` , d , tlsrptr . String ( ) ) ,
"" ,
)
}
2023-01-30 16:27:06 +03:00
2023-08-23 15:27:21 +03:00
records = append ( records ,
2023-01-30 16:27:06 +03:00
"; Autoconfig is used by Thunderbird. Autodiscover is (in theory) used by Microsoft." ,
fmt . Sprintf ( ` autoconfig.%s. IN CNAME %s. ` , d , h ) ,
fmt . Sprintf ( ` _autodiscover._tcp.%s. IN SRV 0 1 443 autoconfig.%s. ` , d , d ) ,
"" ,
// ../rfc/6186:133 ../rfc/8314:692
"; For secure IMAP and submission autoconfig, point to mail host." ,
fmt . Sprintf ( ` _imaps._tcp.%s. IN SRV 0 1 993 %s. ` , d , h ) ,
fmt . Sprintf ( ` _submissions._tcp.%s. IN SRV 0 1 465 %s. ` , d , h ) ,
"" ,
// ../rfc/6186:242
2023-02-27 17:04:32 +03:00
"; Next records specify POP3 and non-TLS ports are not to be used." ,
2023-02-05 23:25:48 +03:00
"; These are optional and safe to leave out (e.g. if you have to click a lot in a" ,
"; DNS admin web interface)." ,
2023-01-30 16:27:06 +03:00
fmt . Sprintf ( ` _imap._tcp.%s. IN SRV 0 1 143 . ` , d ) ,
fmt . Sprintf ( ` _submission._tcp.%s. IN SRV 0 1 587 . ` , d ) ,
fmt . Sprintf ( ` _pop3._tcp.%s. IN SRV 0 1 110 . ` , d ) ,
fmt . Sprintf ( ` _pop3s._tcp.%s. IN SRV 0 1 995 . ` , d ) ,
"" ,
"; Optional:" ,
"; You could mark Let's Encrypt as the only Certificate Authority allowed to" ,
"; sign TLS certificates for your domain." ,
fmt . Sprintf ( "%s. IN CAA 0 issue \"letsencrypt.org\"" , d ) ,
)
return records , nil
}
// AccountAdd adds an account and an initial address and reloads the
// configuration.
//
2023-03-29 11:55:05 +03:00
// The new account does not have a password, so cannot yet log in. Email can be
2023-01-30 16:27:06 +03:00
// delivered.
2023-03-29 22:11:43 +03:00
//
// Catchall addresses are not supported for AccountAdd. Add separately with AddressAdd.
2023-01-30 16:27:06 +03:00
func AccountAdd ( ctx context . Context , account , address string ) ( rerr error ) {
log := xlog . WithContext ( ctx )
defer func ( ) {
if rerr != nil {
log . Errorx ( "adding account" , rerr , mlog . Field ( "account" , account ) , mlog . Field ( "address" , address ) )
}
} ( )
2023-03-29 11:55:05 +03:00
addr , err := smtp . ParseAddress ( address )
if err != nil {
return fmt . Errorf ( "parsing email address: %v" , err )
}
2023-01-30 16:27:06 +03:00
Conf . dynamicMutex . Lock ( )
defer Conf . dynamicMutex . Unlock ( )
c := Conf . Dynamic
if _ , ok := c . Accounts [ account ] ; ok {
return fmt . Errorf ( "account already present" )
}
2023-03-29 11:55:05 +03:00
if err := checkAddressAvailable ( addr ) ; err != nil {
return fmt . Errorf ( "address not available: %v" , err )
2023-01-30 16:27:06 +03:00
}
// Compose new config without modifying existing data structures. If we fail, we
// leave no trace.
nc := c
nc . Accounts = map [ string ] config . Account { }
for name , a := range c . Accounts {
nc . Accounts [ name ] = a
}
nc . Accounts [ account ] = MakeAccountConfig ( addr )
2023-02-16 15:22:00 +03:00
if err := writeDynamic ( ctx , log , nc ) ; err != nil {
2023-01-30 16:27:06 +03:00
return fmt . Errorf ( "writing domains.conf: %v" , err )
}
log . Info ( "account added" , mlog . Field ( "account" , account ) , mlog . Field ( "address" , addr ) )
return nil
}
// AccountRemove removes an account and reloads the configuration.
func AccountRemove ( ctx context . Context , account string ) ( rerr error ) {
log := xlog . WithContext ( ctx )
defer func ( ) {
if rerr != nil {
log . Errorx ( "adding account" , rerr , mlog . Field ( "account" , account ) )
}
} ( )
Conf . dynamicMutex . Lock ( )
defer Conf . dynamicMutex . Unlock ( )
c := Conf . Dynamic
if _ , ok := c . Accounts [ account ] ; ! ok {
return fmt . Errorf ( "account does not exist" )
}
// Compose new config without modifying existing data structures. If we fail, we
// leave no trace.
nc := c
nc . Accounts = map [ string ] config . Account { }
for name , a := range c . Accounts {
if name != account {
nc . Accounts [ name ] = a
}
}
2023-02-16 15:22:00 +03:00
if err := writeDynamic ( ctx , log , nc ) ; err != nil {
2023-01-30 16:27:06 +03:00
return fmt . Errorf ( "writing domains.conf: %v" , err )
}
log . Info ( "account removed" , mlog . Field ( "account" , account ) )
return nil
}
2023-03-29 11:55:05 +03:00
// checkAddressAvailable checks that the address after canonicalization is not
// already configured, and that its localpart does not contain the catchall
// localpart separator.
//
// Must be called with config lock held.
func checkAddressAvailable ( addr smtp . Address ) error {
if dc , ok := Conf . Dynamic . Domains [ addr . Domain . Name ( ) ] ; ! ok {
return fmt . Errorf ( "domain does not exist" )
} else if lp , err := CanonicalLocalpart ( addr . Localpart , dc ) ; err != nil {
return fmt . Errorf ( "canonicalizing localpart: %v" , err )
} else if _ , ok := Conf . accountDestinations [ smtp . NewAddress ( lp , addr . Domain ) . String ( ) ] ; ok {
return fmt . Errorf ( "canonicalized address %s already configured" , smtp . NewAddress ( lp , addr . Domain ) )
} else if dc . LocalpartCatchallSeparator != "" && strings . Contains ( string ( addr . Localpart ) , dc . LocalpartCatchallSeparator ) {
return fmt . Errorf ( "localpart cannot include domain catchall separator %s" , dc . LocalpartCatchallSeparator )
}
return nil
}
2023-03-29 22:11:43 +03:00
// AddressAdd adds an email address to an account and reloads the configuration. If
// address starts with an @ it is treated as a catchall address for the domain.
2023-01-30 16:27:06 +03:00
func AddressAdd ( ctx context . Context , address , account string ) ( rerr error ) {
log := xlog . WithContext ( ctx )
defer func ( ) {
if rerr != nil {
log . Errorx ( "adding address" , rerr , mlog . Field ( "address" , address ) , mlog . Field ( "account" , account ) )
}
} ( )
Conf . dynamicMutex . Lock ( )
defer Conf . dynamicMutex . Unlock ( )
c := Conf . Dynamic
a , ok := c . Accounts [ account ]
if ! ok {
return fmt . Errorf ( "account does not exist" )
}
2023-03-29 22:11:43 +03:00
var destAddr string
if strings . HasPrefix ( address , "@" ) {
d , err := dns . ParseDomain ( address [ 1 : ] )
if err != nil {
return fmt . Errorf ( "parsing domain: %v" , err )
}
dname := d . Name ( )
destAddr = "@" + dname
if _ , ok := Conf . Dynamic . Domains [ dname ] ; ! ok {
return fmt . Errorf ( "domain does not exist" )
} else if _ , ok := Conf . accountDestinations [ destAddr ] ; ok {
return fmt . Errorf ( "catchall address already configured for domain" )
}
} else {
addr , err := smtp . ParseAddress ( address )
if err != nil {
return fmt . Errorf ( "parsing email address: %v" , err )
}
if err := checkAddressAvailable ( addr ) ; err != nil {
return fmt . Errorf ( "address not available: %v" , err )
}
destAddr = addr . String ( )
2023-01-30 16:27:06 +03:00
}
// Compose new config without modifying existing data structures. If we fail, we
// leave no trace.
nc := c
nc . Accounts = map [ string ] config . Account { }
for name , a := range c . Accounts {
nc . Accounts [ name ] = a
}
nd := map [ string ] config . Destination { }
for name , d := range a . Destinations {
nd [ name ] = d
}
2023-03-29 22:11:43 +03:00
nd [ destAddr ] = config . Destination { }
2023-01-30 16:27:06 +03:00
a . Destinations = nd
nc . Accounts [ account ] = a
2023-02-16 15:22:00 +03:00
if err := writeDynamic ( ctx , log , nc ) ; err != nil {
2023-01-30 16:27:06 +03:00
return fmt . Errorf ( "writing domains.conf: %v" , err )
}
2023-03-29 22:11:43 +03:00
log . Info ( "address added" , mlog . Field ( "address" , address ) , mlog . Field ( "account" , account ) )
2023-01-30 16:27:06 +03:00
return nil
}
// AddressRemove removes an email address and reloads the configuration.
func AddressRemove ( ctx context . Context , address string ) ( rerr error ) {
log := xlog . WithContext ( ctx )
defer func ( ) {
if rerr != nil {
log . Errorx ( "removing address" , rerr , mlog . Field ( "address" , address ) )
}
} ( )
Conf . dynamicMutex . Lock ( )
defer Conf . dynamicMutex . Unlock ( )
2023-03-29 22:11:43 +03:00
ad , ok := Conf . accountDestinations [ address ]
2023-01-30 16:27:06 +03:00
if ! ok {
return fmt . Errorf ( "address does not exists" )
}
// Compose new config without modifying existing data structures. If we fail, we
// leave no trace.
2023-03-29 22:11:43 +03:00
a , ok := Conf . Dynamic . Accounts [ ad . Account ]
2023-01-30 16:27:06 +03:00
if ! ok {
return fmt . Errorf ( "internal error: cannot find account" )
}
na := a
na . Destinations = map [ string ] config . Destination { }
var dropped bool
2023-03-29 22:11:43 +03:00
for destAddr , d := range a . Destinations {
if destAddr != address {
na . Destinations [ destAddr ] = d
2023-01-30 16:27:06 +03:00
} else {
dropped = true
}
}
if ! dropped {
return fmt . Errorf ( "address not removed, likely a postmaster/reporting address" )
}
2023-03-29 22:11:43 +03:00
nc := Conf . Dynamic
2023-01-30 16:27:06 +03:00
nc . Accounts = map [ string ] config . Account { }
2023-03-29 22:11:43 +03:00
for name , a := range Conf . Dynamic . Accounts {
2023-01-30 16:27:06 +03:00
nc . Accounts [ name ] = a
}
nc . Accounts [ ad . Account ] = na
2023-02-16 15:22:00 +03:00
if err := writeDynamic ( ctx , log , nc ) ; err != nil {
2023-01-30 16:27:06 +03:00
return fmt . Errorf ( "writing domains.conf: %v" , err )
}
2023-03-29 22:11:43 +03:00
log . Info ( "address removed" , mlog . Field ( "address" , address ) , mlog . Field ( "account" , ad . Account ) )
2023-01-30 16:27:06 +03:00
return nil
}
add webmail
it was far down on the roadmap, but implemented earlier, because it's
interesting, and to help prepare for a jmap implementation. for jmap we need to
implement more client-like functionality than with just imap. internal data
structures need to change. jmap has lots of other requirements, so it's already
a big project. by implementing a webmail now, some of the required data
structure changes become clear and can be made now, so the later jmap
implementation can do things similarly to the webmail code. the webmail
frontend and webmail are written together, making their interface/api much
smaller and simpler than jmap.
one of the internal changes is that we now keep track of per-mailbox
total/unread/unseen/deleted message counts and mailbox sizes. keeping this
data consistent after any change to the stored messages (through the code base)
is tricky, so mox now has a consistency check that verifies the counts are
correct, which runs only during tests, each time an internal account reference
is closed. we have a few more internal "changes" that are propagated for the
webmail frontend (that imap doesn't have a way to propagate on a connection),
like changes to the special-use flags on mailboxes, and used keywords in a
mailbox. more changes that will be required have revealed themselves while
implementing the webmail, and will be implemented next.
the webmail user interface is modeled after the mail clients i use or have
used: thunderbird, macos mail, mutt; and webmails i normally only use for
testing: gmail, proton, yahoo, outlook. a somewhat technical user is assumed,
but still the goal is to make this webmail client easy to use for everyone. the
user interface looks like most other mail clients: a list of mailboxes, a
search bar, a message list view, and message details. there is a top/bottom and
a left/right layout for the list/message view, default is automatic based on
screen size. the panes can be resized by the user. buttons for actions are just
text, not icons. clicking a button briefly shows the shortcut for the action in
the bottom right, helping with learning to operate quickly. any text that is
underdotted has a title attribute that causes more information to be displayed,
e.g. what a button does or a field is about. to highlight potential phishing
attempts, any text (anywhere in the webclient) that switches unicode "blocks"
(a rough approximation to (language) scripts) within a word is underlined
orange. multiple messages can be selected with familiar ui interaction:
clicking while holding control and/or shift keys. keyboard navigation works
with arrows/page up/down and home/end keys, and also with a few basic vi-like
keys for list/message navigation. we prefer showing the text instead of
html (with inlined images only) version of a message. html messages are shown
in an iframe served from an endpoint with CSP headers to prevent dangerous
resources (scripts, external images) from being loaded. the html is also
sanitized, with javascript removed. a user can choose to load external
resources (e.g. images for tracking purposes).
the frontend is just (strict) typescript, no external frameworks. all
incoming/outgoing data is typechecked, both the api request parameters and
response types, and the data coming in over SSE. the types and checking code
are generated with sherpats, which uses the api definitions generated by
sherpadoc based on the Go code. so types from the backend are automatically
propagated to the frontend. since there is no framework to automatically
propagate properties and rerender components, changes coming in over the SSE
connection are propagated explicitly with regular function calls. the ui is
separated into "views", each with a "root" dom element that is added to the
visible document. these views have additional functions for getting changes
propagated, often resulting in the view updating its (internal) ui state (dom).
we keep the frontend compilation simple, it's just a few typescript files that
get compiled (combined and types stripped) into a single js file, no additional
runtime code needed or complicated build processes used. the webmail is served
is served from a compressed, cachable html file that includes style and the
javascript, currently just over 225kb uncompressed, under 60kb compressed (not
minified, including comments). we include the generated js files in the
repository, to keep Go's easily buildable self-contained binaries.
authentication is basic http, as with the account and admin pages. most data
comes in over one long-term SSE connection to the backend. api requests signal
which mailbox/search/messages are requested over the SSE connection. fetching
individual messages, and making changes, are done through api calls. the
operations are similar to imap, so some code has been moved from package
imapserver to package store. the future jmap implementation will benefit from
these changes too. more functionality will probably be moved to the store
package in the future.
the quickstart enables webmail on the internal listener by default (for new
installs). users can enable it on the public listener if they want to. mox
localserve enables it too. to enable webmail on existing installs, add settings
like the following to the listeners in mox.conf, similar to AccountHTTP(S):
WebmailHTTP:
Enabled: true
WebmailHTTPS:
Enabled: true
special thanks to liesbeth, gerben, andrii for early user feedback.
there is plenty still to do, see the list at the top of webmail/webmail.ts.
feedback welcome as always.
2023-08-07 22:57:03 +03:00
// AccountFullNameSave updates the full name for an account and reloads the configuration.
func AccountFullNameSave ( ctx context . Context , account , fullName string ) ( rerr error ) {
log := xlog . WithContext ( ctx )
defer func ( ) {
if rerr != nil {
log . Errorx ( "saving account full name" , rerr , mlog . Field ( "account" , account ) )
}
} ( )
Conf . dynamicMutex . Lock ( )
defer Conf . dynamicMutex . Unlock ( )
c := Conf . Dynamic
acc , ok := c . Accounts [ account ]
if ! ok {
return fmt . Errorf ( "account not present" )
}
// Compose new config without modifying existing data structures. If we fail, we
// leave no trace.
nc := c
nc . Accounts = map [ string ] config . Account { }
for name , a := range c . Accounts {
nc . Accounts [ name ] = a
}
acc . FullName = fullName
nc . Accounts [ account ] = acc
if err := writeDynamic ( ctx , log , nc ) ; err != nil {
return fmt . Errorf ( "writing domains.conf: %v" , err )
}
log . Info ( "account full name saved" , mlog . Field ( "account" , account ) )
return nil
}
2023-02-11 01:47:19 +03:00
// DestinationSave updates a destination for an account and reloads the configuration.
func DestinationSave ( ctx context . Context , account , destName string , newDest config . Destination ) ( rerr error ) {
log := xlog . WithContext ( ctx )
defer func ( ) {
if rerr != nil {
log . Errorx ( "saving destination" , rerr , mlog . Field ( "account" , account ) , mlog . Field ( "destname" , destName ) , mlog . Field ( "destination" , newDest ) )
}
} ( )
Conf . dynamicMutex . Lock ( )
defer Conf . dynamicMutex . Unlock ( )
c := Conf . Dynamic
acc , ok := c . Accounts [ account ]
if ! ok {
return fmt . Errorf ( "account not present" )
}
if _ , ok := acc . Destinations [ destName ] ; ! ok {
return fmt . Errorf ( "destination not present" )
}
// Compose new config without modifying existing data structures. If we fail, we
// leave no trace.
nc := c
nc . Accounts = map [ string ] config . Account { }
for name , a := range c . Accounts {
nc . Accounts [ name ] = a
}
nd := map [ string ] config . Destination { }
for dn , d := range acc . Destinations {
nd [ dn ] = d
}
nd [ destName ] = newDest
nacc := nc . Accounts [ account ]
nacc . Destinations = nd
nc . Accounts [ account ] = nacc
2023-02-16 15:22:00 +03:00
if err := writeDynamic ( ctx , log , nc ) ; err != nil {
2023-02-11 01:47:19 +03:00
return fmt . Errorf ( "writing domains.conf: %v" , err )
}
log . Info ( "destination saved" , mlog . Field ( "account" , account ) , mlog . Field ( "destname" , destName ) )
return nil
}
2023-03-28 21:50:36 +03:00
// AccountLimitsSave saves new message sending limits for an account.
func AccountLimitsSave ( ctx context . Context , account string , maxOutgoingMessagesPerDay , maxFirstTimeRecipientsPerDay int ) ( rerr error ) {
log := xlog . WithContext ( ctx )
defer func ( ) {
if rerr != nil {
log . Errorx ( "saving account limits" , rerr , mlog . Field ( "account" , account ) )
}
} ( )
Conf . dynamicMutex . Lock ( )
defer Conf . dynamicMutex . Unlock ( )
c := Conf . Dynamic
acc , ok := c . Accounts [ account ]
if ! ok {
return fmt . Errorf ( "account not present" )
}
// Compose new config without modifying existing data structures. If we fail, we
// leave no trace.
nc := c
nc . Accounts = map [ string ] config . Account { }
for name , a := range c . Accounts {
nc . Accounts [ name ] = a
}
acc . MaxOutgoingMessagesPerDay = maxOutgoingMessagesPerDay
acc . MaxFirstTimeRecipientsPerDay = maxFirstTimeRecipientsPerDay
nc . Accounts [ account ] = acc
if err := writeDynamic ( ctx , log , nc ) ; err != nil {
return fmt . Errorf ( "writing domains.conf: %v" , err )
}
log . Info ( "account limits saved" , mlog . Field ( "account" , account ) )
return nil
}
2023-01-30 16:27:06 +03:00
// ClientConfig holds the client configuration for IMAP/Submission for a
// domain.
type ClientConfig struct {
Entries [ ] ClientConfigEntry
}
type ClientConfigEntry struct {
Protocol string
Host dns . Domain
Port int
Listener string
Note string
}
// ClientConfigDomain returns the client config for IMAP/Submission for a
// domain.
func ClientConfigDomain ( d dns . Domain ) ( ClientConfig , error ) {
_ , ok := Conf . Domain ( d )
if ! ok {
return ClientConfig { } , fmt . Errorf ( "unknown domain" )
}
c := ClientConfig { }
c . Entries = [ ] ClientConfigEntry { }
var listeners [ ] string
for name := range Conf . Static . Listeners {
listeners = append ( listeners , name )
}
sort . Slice ( listeners , func ( i , j int ) bool {
return listeners [ i ] < listeners [ j ]
} )
note := func ( tls bool , requiretls bool ) string {
if ! tls {
return "plain text, no STARTTLS configured"
}
if requiretls {
return "STARTTLS required"
}
return "STARTTLS optional"
}
for _ , name := range listeners {
l := Conf . Static . Listeners [ name ]
host := Conf . Static . HostnameDomain
if l . Hostname != "" {
host = l . HostnameDomain
}
if l . Submissions . Enabled {
c . Entries = append ( c . Entries , ClientConfigEntry { "Submission (SMTP)" , host , config . Port ( l . Submissions . Port , 465 ) , name , "with TLS" } )
}
if l . IMAPS . Enabled {
c . Entries = append ( c . Entries , ClientConfigEntry { "IMAP" , host , config . Port ( l . IMAPS . Port , 993 ) , name , "with TLS" } )
}
if l . Submission . Enabled {
c . Entries = append ( c . Entries , ClientConfigEntry { "Submission (SMTP)" , host , config . Port ( l . Submission . Port , 587 ) , name , note ( l . TLS != nil , ! l . Submission . NoRequireSTARTTLS ) } )
}
if l . IMAP . Enabled {
c . Entries = append ( c . Entries , ClientConfigEntry { "IMAP" , host , config . Port ( l . IMAPS . Port , 143 ) , name , note ( l . TLS != nil , ! l . IMAP . NoRequireSTARTTLS ) } )
}
}
return c , nil
}
2023-08-11 11:13:17 +03:00
// IPs returns ip addresses we may be listening/receiving mail on or
// connecting/sending from to the outside.
new feature: when delivering messages from the queue, make it possible to use a "transport"
the default transport is still just "direct delivery", where we connect to the
destination domain's MX servers.
other transports are:
- regular smtp without authentication, this is relaying to a smarthost.
- submission with authentication, e.g. to a third party email sending service.
- direct delivery, but with with connections going through a socks proxy. this
can be helpful if your ip is blocked, you need to get email out, and you have
another IP that isn't blocked.
keep in mind that for all of the above, appropriate SPF/DKIM settings have to
be configured. the "dnscheck" for a domain does a check for any SOCKS IP in the
SPF record. SPF for smtp/submission (ranges? includes?) and any DKIM
requirements cannot really be checked.
which transport is used can be configured through routes. routes can be set on
an account, a domain, or globally. the routes are evaluated in that order, with
the first match selecting the transport. these routes are evaluated for each
delivery attempt. common selection criteria are recipient domain and sender
domain, but also which delivery attempt this is. you could configured mox to
attempt sending through a 3rd party from the 4th attempt onwards.
routes and transports are optional. if no route matches, or an empty/zero
transport is selected, normal direct delivery is done.
we could already "submit" emails with 3rd party accounts with "sendmail". but
we now support more SASL authentication mechanisms with SMTP (not only PLAIN,
but also SCRAM-SHA-256, SCRAM-SHA-1 and CRAM-MD5), which sendmail now also
supports. sendmail will use the most secure mechanism supported by the server,
or the explicitly configured mechanism.
for issue #36 by dmikushin. also based on earlier discussion on hackernews.
2023-06-16 19:38:28 +03:00
func IPs ( ctx context . Context , receiveOnly bool ) ( [ ] net . IP , error ) {
2023-01-30 16:27:06 +03:00
log := xlog . WithContext ( ctx )
// Try to gather all IPs we are listening on by going through the config.
// If we encounter 0.0.0.0 or ::, we'll gather all local IPs afterwards.
var ips [ ] net . IP
var ipv4all , ipv6all bool
for _ , l := range Conf . Static . Listeners {
2023-03-09 17:24:06 +03:00
// If NATed, we don't know our external IPs.
if l . IPsNATed {
return nil , nil
}
2023-08-11 11:13:17 +03:00
check := l . IPs
if len ( l . NATIPs ) > 0 {
check = l . NATIPs
}
for _ , s := range check {
2023-01-30 16:27:06 +03:00
ip := net . ParseIP ( s )
if ip . IsUnspecified ( ) {
if ip . To4 ( ) != nil {
ipv4all = true
} else {
ipv6all = true
}
continue
}
ips = append ( ips , ip )
}
}
// We'll list the IPs on the interfaces. How useful is this? There is a good chance
2023-02-05 23:25:48 +03:00
// we're listening on all addresses because of a load balancer/firewall.
2023-01-30 16:27:06 +03:00
if ipv4all || ipv6all {
ifaces , err := net . Interfaces ( )
if err != nil {
return nil , fmt . Errorf ( "listing network interfaces: %v" , err )
}
for _ , iface := range ifaces {
if iface . Flags & net . FlagUp == 0 {
continue
}
addrs , err := iface . Addrs ( )
if err != nil {
return nil , fmt . Errorf ( "listing addresses for network interface: %v" , err )
}
if len ( addrs ) == 0 {
continue
}
for _ , addr := range addrs {
ip , _ , err := net . ParseCIDR ( addr . String ( ) )
if err != nil {
log . Errorx ( "bad interface addr" , err , mlog . Field ( "address" , addr ) )
continue
}
v4 := ip . To4 ( ) != nil
if ipv4all && v4 || ipv6all && ! v4 {
ips = append ( ips , ip )
}
}
}
}
new feature: when delivering messages from the queue, make it possible to use a "transport"
the default transport is still just "direct delivery", where we connect to the
destination domain's MX servers.
other transports are:
- regular smtp without authentication, this is relaying to a smarthost.
- submission with authentication, e.g. to a third party email sending service.
- direct delivery, but with with connections going through a socks proxy. this
can be helpful if your ip is blocked, you need to get email out, and you have
another IP that isn't blocked.
keep in mind that for all of the above, appropriate SPF/DKIM settings have to
be configured. the "dnscheck" for a domain does a check for any SOCKS IP in the
SPF record. SPF for smtp/submission (ranges? includes?) and any DKIM
requirements cannot really be checked.
which transport is used can be configured through routes. routes can be set on
an account, a domain, or globally. the routes are evaluated in that order, with
the first match selecting the transport. these routes are evaluated for each
delivery attempt. common selection criteria are recipient domain and sender
domain, but also which delivery attempt this is. you could configured mox to
attempt sending through a 3rd party from the 4th attempt onwards.
routes and transports are optional. if no route matches, or an empty/zero
transport is selected, normal direct delivery is done.
we could already "submit" emails with 3rd party accounts with "sendmail". but
we now support more SASL authentication mechanisms with SMTP (not only PLAIN,
but also SCRAM-SHA-256, SCRAM-SHA-1 and CRAM-MD5), which sendmail now also
supports. sendmail will use the most secure mechanism supported by the server,
or the explicitly configured mechanism.
for issue #36 by dmikushin. also based on earlier discussion on hackernews.
2023-06-16 19:38:28 +03:00
if receiveOnly {
return ips , nil
}
for _ , t := range Conf . Static . Transports {
if t . Socks != nil {
ips = append ( ips , t . Socks . IPs ... )
}
}
2023-01-30 16:27:06 +03:00
return ips , nil
}