public inbox for pmg-devel@lists.proxmox.com
 help / color / mirror / Atom feed
From: Maximiliano Sandoval <m.sandoval@proxmox.com>
To: pmg-devel@lists.proxmox.com
Subject: [pmg-devel] [PATCH pmg-docs v2] dkim: document dkim_use_domain
Date: Tue, 27 Feb 2024 11:33:35 +0100	[thread overview]
Message-ID: <20240227103335.193474-1-m.sandoval@proxmox.com> (raw)

Signed-off-by: Maximiliano Sandoval <m.sandoval@proxmox.com>
---
Differences from v1:
 - Add links to RFCs
 - Use `+` for new lines in the same section

 asciidoc/asciidoc-pmg.conf |  3 +++
 pmgconfig.adoc             | 12 ++++++++++++
 2 files changed, 15 insertions(+)

diff --git a/asciidoc/asciidoc-pmg.conf b/asciidoc/asciidoc-pmg.conf
index 45ea7dd..6c9f0bb 100644
--- a/asciidoc/asciidoc-pmg.conf
+++ b/asciidoc/asciidoc-pmg.conf
@@ -21,7 +21,10 @@ clamav=https://www.clamav.net[ClamAV(R)]
 debian=https://www.debian.org[Debian]
 debian_nonfree_archive_area=https://www.debian.org/doc/debian-policy/ch-archive#the-non-free-archive-area[Debian's non-free archive area]
 tts=http://www.template-toolkit.org[Template Toolkit]
+smtp_rfc=https://tools.ietf.org/html/rfc5321[RFC 5321]
+rfc_5322=https://tools.ietf.org/html/rfc5322[RFC 5322]
 dkim_rfc=https://tools.ietf.org/html/rfc6376[RFC 6376]
+dmarc_rfc=https://tools.ietf.org/html/rfc7489[RFC 7489]
 ifndef::docinfo1[]
 author=Proxmox Server Solutions GmbH
 email=support@proxmox.com
diff --git a/pmgconfig.adoc b/pmgconfig.adoc
index bf3887e..33d35fb 100644
--- a/pmgconfig.adoc
+++ b/pmgconfig.adoc
@@ -585,6 +585,18 @@ Controls whether all outbound mail should get signed or only mails from domains
 listed in `/etc/pmg/dkim/domains`, if it exists and `/etc/pmg/domains`
 otherwise.
 
+Select Signing Domain::
+
+Determines whether to DKIM sign emails using the domain found in the envelope
+from or the from header in the body of the email. The envelope from is also
+known as reverse-path, see {smtp_rfc} section 3.3 and {rfc_5322} section 3.6.2.
++
+The envelop from of certain emails, bounces for example, can be empty. In these
+cases it is desirable to sign them using the domain found in the from header.
++
+Additionally, DMARC (see {dmarc_rfc} section 3.1.1) needs the domain found in
+the from header in certain situations.
+
 These settings are saved to the 'admin' subsection in `/etc/pmg/pmg.conf`,
 using the following configuration keys:
 
-- 
2.39.2





             reply	other threads:[~2024-02-27 10:33 UTC|newest]

Thread overview: 2+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2024-02-27 10:33 Maximiliano Sandoval [this message]
2024-02-28  9:34 ` [pmg-devel] applied: " Stoiko Ivanov

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=20240227103335.193474-1-m.sandoval@proxmox.com \
    --to=m.sandoval@proxmox.com \
    --cc=pmg-devel@lists.proxmox.com \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox
Service provided by Proxmox Server Solutions GmbH | Privacy | Legal