* [pmg-devel] [PATCH pmg-docs v2] dkim: document dkim_use_domain
@ 2024-02-27 10:33 Maximiliano Sandoval
2024-02-28 9:34 ` [pmg-devel] applied: " Stoiko Ivanov
0 siblings, 1 reply; 2+ messages in thread
From: Maximiliano Sandoval @ 2024-02-27 10:33 UTC (permalink / raw)
To: pmg-devel
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
^ permalink raw reply [flat|nested] 2+ messages in thread
* [pmg-devel] applied: [PATCH pmg-docs v2] dkim: document dkim_use_domain
2024-02-27 10:33 [pmg-devel] [PATCH pmg-docs v2] dkim: document dkim_use_domain Maximiliano Sandoval
@ 2024-02-28 9:34 ` Stoiko Ivanov
0 siblings, 0 replies; 2+ messages in thread
From: Stoiko Ivanov @ 2024-02-28 9:34 UTC (permalink / raw)
To: Maximiliano Sandoval; +Cc: pmg-devel
Thanks!
applied, with the subject fixed up (s/_/-/)
added another commit with a rephrasing - would be glad for feedback if
anything is off/less clear with it)
additionally added the new setting to `gen-pmg.conf.5-opts.pl`
On Tue, 27 Feb 2024 11:33:35 +0100
Maximiliano Sandoval <m.sandoval@proxmox.com> wrote:
> 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:
>
^ permalink raw reply [flat|nested] 2+ messages in thread
end of thread, other threads:[~2024-02-28 9:34 UTC | newest]
Thread overview: 2+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2024-02-27 10:33 [pmg-devel] [PATCH pmg-docs v2] dkim: document dkim_use_domain Maximiliano Sandoval
2024-02-28 9:34 ` [pmg-devel] applied: " Stoiko Ivanov
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox