postfix relay #3

Supports: trusty xenial bionic
Add to new model

Description

Postfix is the default mail transport agent on Ubuntu. This charm implements a mail relay for cloud instances.

Overview

This Postfix charm implements a naive mail relay for cloud instances. It is expected that it will be used as a simple transport to a more intelligent upstream relay.

This is a reactive rewrite of ~paulgear/trusty/postfix-relay-0 which is based on the postfix charm by: - Menno Smits menno.smits@canonical.com - Frank Mueller frank.mueller@canonical.com - Horacio Duran horacio.duran@canonical.com - John Weldon johnweldon4@gmail.com

Maintainers

Canonical IS root@admin.canonical.com

TODO

  • Provide juju actions to
  • add/remove/list postconf entries?
  • add/remove/list aliases
  • remove/list entries in the mail queue?

Configuration

disable_vrfy_command
(boolean) Disable the SMTP VRFY command. This isn't usually useful for relays.
True
domain_rewrite_map
(string) A list of domain:newdomain pairs to rewrite. Primarily used for allowing hosts with locally-resolvable domain names to send mail which appears to be from a real domain. Addresses in these domains will be rewritten from user@host.domain to user+host@newdomain.
myhostname
(string) The external hostname by which this mail relay is known. This value must be changed for the charm to be useful.
postfix-relay.example.com.
mynetworks
(string) A comma-separated list of networks for which this relay will allow sending mail.
127.0.0.0/8
relayhost
(string) An upstream mail relay, sometimes called "smart host". Enclose it in square brackets to skip MX lookup.
smtp_auth_password
(string) Password to auth against remote mail server using smtp_auth_username. Requires smtp_auth_username to take effect.
smtp_auth_username
(string) Username to auth against remote mail server. Requires smtp_auth_password to take effect.
smtpd_helo_required
(boolean) Require that a remote SMTP client sends HELO or EHLO before commencing a MAIL transaction.
True
smtpd_recipient_restrictions
(string) Optional restrictions which the Postfix SMTP server applies in the context of a client RCPT TO command.
permit_mynetworks, reject_non_fqdn_recipient, reject_unknown_recipient_domain, reject_unauth_pipelining
ssl_ca
(string) Base64-encoded SSL CA to use with the upstream relay host. If set postfix will assume the upstream host is using TLS and configure itself accordingly.