]> git.ipfire.org Git - thirdparty/postfix.git/commitdiff
postfix-3.6.10 v3.6.10
authorWietse Venema <wietse@porcupine.org>
Mon, 5 Jun 2023 05:00:00 +0000 (00:00 -0500)
committerViktor Dukhovni <ietf-dane@dukhovni.org>
Tue, 6 Jun 2023 14:33:35 +0000 (10:33 -0400)
28 files changed:
postfix/HISTORY
postfix/RELEASE_NOTES
postfix/html/lmtp.8.html
postfix/html/postconf.5.html
postfix/html/smtp.8.html
postfix/html/smtpd.8.html
postfix/html/tlsproxy.8.html
postfix/man/man5/postconf.5
postfix/man/man8/smtp.8
postfix/man/man8/smtpd.8
postfix/man/man8/tlsproxy.8
postfix/mantools/postlink
postfix/proto/postconf.proto
postfix/src/global/mail_params.h
postfix/src/global/mail_version.h
postfix/src/postconf/postconf_edit.c
postfix/src/postconf/postconf_master.c
postfix/src/smtp/smtp.c
postfix/src/smtpd/smtpd.c
postfix/src/tls/tls.h
postfix/src/tls/tls_client.c
postfix/src/tls/tls_misc.c
postfix/src/tls/tls_proxy.h
postfix/src/tls/tls_proxy_client_misc.c
postfix/src/tls/tls_proxy_client_print.c
postfix/src/tls/tls_proxy_client_scan.c
postfix/src/tls/tls_server.c
postfix/src/tlsproxy/tlsproxy.c

index 19eb9d8a2d4ce400dd28f872ab57ff4989501794..4f5b2edcd981b1b7a557beb470ac89f00108f6ca 100644 (file)
@@ -25896,3 +25896,90 @@ Apologies for any names omitted.
        return "not found" instead of "error" during the time that
        all MySQL server connections were turned down after error.
        Found during code maintenance. File: global/dict_mysql.c.
+
+20230428
+
+       Bugfix (defect introduced: Postfix 1.0): the command "postconf
+       .. name=v1 .. name=v2 .." (multiple instances of the same
+       parameter name) created multiple name=value entries with
+       the same parameter name. It now logs a warning and skips
+       the earlier update. Found during code maintenance. File:
+       postconf/postconf_edit.c
+
+       Bugfix (defect introduced: Postfix 3.3): the command "postconf
+       -M name1/type1='name2 type2 ...'" died with a segmentation
+       violation when the request matched multiple master.cf
+       entries. The master.cf file was not damaged. Problem reported
+       by SATOH Fumiyasu. File: postconf/postconf_master.c.
+
+20230502
+
+       Bugfix (defect introduced: Postfix 2.11): the command
+       "postconf -M name1/type1='name2 type2 ...'" could add a
+       service definition to master.cf that conflicted with an
+       already existing service definition. It now replaces all
+       existing service definitions that match the service pattern
+       'name1/type1' or the service name and type in 'name2 type2
+       ...' with a single service definition 'name2 type2 ...'.
+       Problem reported by SATOH Fumiyasu. File: postconf/postconf_edit.c.
+
+20230519
+
+       Bitrot: preliminary support for OpenSSL configuration files,
+       primarily OpenSSL 1.1.1b and later. This introduces new
+       parameters "tls_config_file" and "tls_config_name", which
+       can be used to limit collateral damage from OS distributions
+       that crank up security to 11, increasing the number of
+       plaintext email deliveries. Details are in the postconf(5)
+       manpage under "tls_config_file" and "tls_config_name".
+       Viktor Dukhovni. Files: mantools/postlink, proto/postconf.proto,
+       global/mail_params.h, posttls-finger/posttls-finger.c,
+       smtp/smtp.c, smtp/smtp_proto.c, tls/tls_client.c, tls/tls.h,
+       tls/tls_misc.c, tls/tls_proxy_client_print.c,
+       tls/tls_proxy_client_scan.c, tls/tls_proxy.h, tls/tls_server.c,
+       tlsproxy/tlsproxy.c.
+
+20230523
+
+       Cleanup: use TLS_CLIENT_PARAMS to pass the OpensSSL 'init'
+       configurations. This information is independent from the
+       client or server TLS context, and therefore does not belong
+       in tls_*_init() or tls_*_start() calls. The tlsproxy(8)
+       server uses TLS_CLIENT_PARAMS to report differences between
+       its own global TLS settings, and those from its clients.
+       Files: posttls-finger/posttls-finger.c, smtp/smtp.c,
+       smtp/smtp_proto.c, tls/tls.h, tls/tls_proxy_client_misc.c,
+       tls/tls_proxy_client_print.c, tls/tls_proxy_client_scan.c,
+       tls/tls_proxy.h, tlsproxy/tlsproxy.c.
+
+20230524
+
+       Cleanup: reverted cosmetic-only changes to minimize the
+       patch footprint for OpenSSL INI file support; updated daemon
+       manpages with the new tls_config_file and tls_config_name
+       configuration parameters. Files: smtp/smtp.c, smtpd/smtpd.c,
+       tls/tls_client.c, tls/tls.h, tls/tls_server.c, tlsproxy/tlsproxy.c,
+
+20230529
+
+       Cleanup: made OpenSSL 'default' INI file support error
+       handling consistent with OpenSSL default behavior. Viktor
+       Dukhovni. Files: proto/postconf.proto, tls/tls_misc.c.
+
+20230602
+
+       Backwards compatibility for stable releases that originally
+       had no OpenSSL INI support. Skip the new OpenSSL INI support
+       code, unless the Postfix configuration actually specifies
+       non-default tls_config_xxx settings. File: tls/tls_misc.c.
+
+       Cleanup: added a multiple initialization guard in the
+       tls_library_init() function, and made an initialization
+       error sticky. File: tls/tls_misc.c.
+
+20230605
+
+       Security: new parameter smtpd_forbid_unauth_pipelining
+       (default: no) to disconnect remote SMTP clients that violate
+       RFC 2920 (or 5321) command pipelining constraints. Files:
+       global/mail_params.h, smtpd/smtpd.c, proto/postconf.proto.
index d8ac90cc7151e391c2a6344d5466ca8532faf6d1..63d395d3fcb073ccb3be6c3ae33c07c24b677e19 100644 (file)
@@ -25,6 +25,23 @@ more recent Eclipse Public License 2.0. Recipients can choose to take
 the software under the license of their choice. Those who are more
 comfortable with the IPL can continue with that license.
 
+Major changes with Postfix 3.6.10
+=================================
+
+Security: the Postfix SMTP server optionally disconnects remote
+SMTP clients that violate RFC 2920 (or 5321) command pipelining
+constraints. The server replies with "554 5.5.0 Error: SMTP protocol
+synchronization" and logs the unexpected remote SMTP client input.
+Specify "smtpd_forbid_unauth_pipelining = yes" to enable. This
+feature is enabled by default in Postfix 3.9 and later.
+
+Workaround to limit collateral damage from OS distributions that
+crank up security to 11, increasing the number of plaintext email
+deliveries. This introduces basic OpenSSL configuration file support,
+with two new parameters "tls_config_file" and "tls_config_name".
+Details are in the postconf(5) manpage under "tls_config_file" and
+"tls_config_name".
+
 Major changes - internal protocol identification
 ------------------------------------------------
 
index f8bde52a3fa3efb4ffb75e84aae450c3a39a3282..a9d512dda29247426368964a3f50042608372532 100644 (file)
@@ -668,6 +668,15 @@ SMTP(8)                                                                SMTP(8)
               A  workaround  for implementations that hang Postfix while shut-
               ting down a TLS session, until Postfix times out.
 
+       Available in Postfix 3.9, 3.8.1, 3.7.6, 3.6.10, 3.5.20 and later:
+
+       <b><a href="postconf.5.html#tls_config_file">tls_config_file</a> (default)</b>
+              Optional configuration file with baseline OpenSSL settings.
+
+       <b><a href="postconf.5.html#tls_config_name">tls_config_name</a> (empty)</b>
+              The application name passed by Postfix to OpenSSL  library  ini-
+              tialization functions.
+
 <b>OBSOLETE STARTTLS CONTROLS</b>
        The following configuration parameters  exist  for  compatibility  with
        Postfix  versions  before  2.3.  Support for these will be removed in a
index 2d1875aa577eb8b6629ac2fbb4e6b1b90c1a86e1..b66b20bd0c264320056ca994d914dc6f70ca7cbd 100644 (file)
@@ -15296,6 +15296,22 @@ This feature is available in Postfix 2.0 and later.
 </p>
 
 
+</DD>
+
+<DT><b><a name="smtpd_forbid_unauth_pipelining">smtpd_forbid_unauth_pipelining</a>
+(default: Postfix &ge; 3.9: yes)</b></DT><DD>
+
+<p> Disconnect remote SMTP clients that violate <a href="http://tools.ietf.org/html/rfc2920">RFC 2920</a> (or 5321)
+command pipelining constraints. The server replies with "554 5.5.0
+Error: SMTP protocol synchronization" and logs the unexpected remote
+SMTP client input. Specify "<a href="postconf.5.html#smtpd_forbid_unauth_pipelining">smtpd_forbid_unauth_pipelining</a> = yes"
+to enable. This feature is enabled by default with Postfix &ge;
+3.9.  </p>
+
+<p> This feature is available in Postfix &ge; 3.9, 3.8.1, 3.7.6,
+3.6.10, and 3.5.20. </p>
+
+
 </DD>
 
 <DT><b><a name="smtpd_forbidden_commands">smtpd_forbidden_commands</a>
@@ -18723,6 +18739,113 @@ backwards compatibility, to avoid breaking certificate verification
 with sites that don't use <a href="postconf.5.html#permit_tls_all_clientcerts">permit_tls_all_clientcerts</a>. </p>
 
 
+</DD>
+
+<DT><b><a name="tls_config_file">tls_config_file</a>
+(default: default)</b></DT><DD>
+
+<p> Optional configuration file with baseline OpenSSL settings.
+OpenSSL loads any SSL settings found in the configuration file for
+the selected application name (see <a href="postconf.5.html#tls_config_name">tls_config_name</a>) or else the
+built-in application name "openssl_conf" when no application name is
+specified, or no corresponding configuration section is present.
+</p>
+
+<p> With OpenSSL releases 1.1.1 and 1.1.1a, applications (including
+Postfix) can neither specify an alternative configuration file, nor
+avoid loading the default configuration file.  </p>
+
+<p> With OpenSSL 1.1.1b or later, this parameter may be set to one of:
+</p>
+
+<dl>
+
+<dt> <b>default</b> (default) </dt> <dd> Load the system-wide
+"openssl.cnf" configuration file.  </dd>
+
+<dt> <b>none</b> (recommended, OpenSSL 1.1.1b or later only) </dt>
+<dd> This setting disables loading of  the system-wide "openssl.cnf"
+file.  </dd>
+
+<dt> <b><i>/absolute-path</i></b> (OpenSSL 1.1.1b or later only) </dt>
+<dd> Load the configuration file specified by <i>/absolute-path</i>.
+With this setting it is an error for the file to not contain any
+settings for the selected <a href="postconf.5.html#tls_config_name">tls_config_name</a>.  There is no fallback to
+the default "openssl_conf" name. </dd>
+
+</dl>
+
+<p> Failures in processing of the built-in default configuration file,
+are silently ignored.  Any errors in loading a non-default configuration
+file are detected by Postfix, and cause TLS support to be disabled.
+</p>
+
+<p> The OpenSSL configuration file format is not documented here,
+beyond giving two examples. <p>
+
+<p> Example: Default settings for all applications. </p>
+
+<blockquote>
+<pre>
+# The name 'openssl_conf' is the default application name
+# The section name to the right of the '=' sign is arbitrary,
+# any name will do, so long as it refers to the desired section.
+#
+# The name 'system_default' selects the settings applied internally
+# by the SSL library as part of SSL object creation.  Applications
+# can then apply any additional settings of their choice.
+#
+# In this example, TLS versions prior to 1.2 are disabled by default.
+#
+openssl_conf = system_wide_settings
+[system_wide_settings]
+ssl_conf = ssl_library_settings
+[ssl_library_settings]
+system_default = initial_ssl_settings
+[initial_ssl_settings]
+MinProtocol = TLSv1.2
+</pre>
+</blockquote>
+
+<p> Example: Custom settings for an application named "postfix". </p>
+
+<blockquote>
+<pre>
+# The mapping from an application name to the corresponding configuration
+# section must appear near the top of the file, (in what is sometimes called
+# the "default section") prior to the start of any explicitly named
+# "[sections]".  The named sections can appear in any order and don't nest.
+#
+postfix = postfix_settings
+[postfix_settings]
+ssl_conf = postfix_ssl_settings
+[postfix_ssl_settings]
+system_default = baseline_postfix_settings
+[baseline_postfix_settings]
+MinProtocol = TLSv1
+</pre>
+</blockquote>
+
+<p> This feature is available in Postfix &ge; 3.9, 3.8.1, 3.7.6,
+3.6.10, and 3.5.20. </p>
+
+
+</DD>
+
+<DT><b><a name="tls_config_name">tls_config_name</a>
+(default: empty)</b></DT><DD>
+
+<p> The application name passed by Postfix to OpenSSL library
+initialization functions.  This name is used to select the desired
+configuration "section" in the OpenSSL configuration file specified
+via the <a href="postconf.5.html#tls_config_file">tls_config_file</a> parameter.  When empty, or when the
+selected name is not present in the configuration file, the default
+application name ("openssl_conf") is used as a fallback.  </p>
+
+<p> This feature is available in Postfix &ge; 3.9, 3.8.1, 3.7.6,
+3.6.10, and 3.5.20. </p>
+
+
 </DD>
 
 <DT><b><a name="tls_daemon_random_bytes">tls_daemon_random_bytes</a>
index f8bde52a3fa3efb4ffb75e84aae450c3a39a3282..a9d512dda29247426368964a3f50042608372532 100644 (file)
@@ -668,6 +668,15 @@ SMTP(8)                                                                SMTP(8)
               A  workaround  for implementations that hang Postfix while shut-
               ting down a TLS session, until Postfix times out.
 
+       Available in Postfix 3.9, 3.8.1, 3.7.6, 3.6.10, 3.5.20 and later:
+
+       <b><a href="postconf.5.html#tls_config_file">tls_config_file</a> (default)</b>
+              Optional configuration file with baseline OpenSSL settings.
+
+       <b><a href="postconf.5.html#tls_config_name">tls_config_name</a> (empty)</b>
+              The application name passed by Postfix to OpenSSL  library  ini-
+              tialization functions.
+
 <b>OBSOLETE STARTTLS CONTROLS</b>
        The following configuration parameters  exist  for  compatibility  with
        Postfix  versions  before  2.3.  Support for these will be removed in a
index ef9d7fd37a316497527d2071bbc452bbbf30c2dd..4277b89f4714aafada46aaf95dc20a7e6491e615 100644 (file)
@@ -619,6 +619,15 @@ SMTPD(8)                                                              SMTPD(8)
               The email address form that will be used  in  non-debug  logging
               (info, warning, etc.).
 
+       Available in Postfix 3.9, 3.8.1, 3.7.6, 3.6.10, 3.5.20 and later:
+
+       <b><a href="postconf.5.html#tls_config_file">tls_config_file</a> (default)</b>
+              Optional configuration file with baseline OpenSSL settings.
+
+       <b><a href="postconf.5.html#tls_config_name">tls_config_name</a> (empty)</b>
+              The  application  name passed by Postfix to OpenSSL library ini-
+              tialization functions.
+
 <b>OBSOLETE STARTTLS CONTROLS</b>
        The  following  configuration  parameters  exist for compatibility with
        Postfix versions before 2.3. Support for these will  be  removed  in  a
@@ -921,6 +930,12 @@ SMTPD(8)                                                              SMTPD(8)
               to  send to this service per time unit, regardless of whether or
               not Postfix actually accepts those commands.
 
+       Available in Postfix 3.9, 3.8.1, 3.7.6, 3.6.10, 3.5.20 and later:
+
+       <b><a href="postconf.5.html#smtpd_forbid_unauth_pipelining">smtpd_forbid_unauth_pipelining</a> (Postfix</b> &gt;<b>= 3.9: yes)</b>
+              Disconnect  remote  SMTP clients that violate <a href="https://tools.ietf.org/html/rfc2920">RFC 2920</a> (or 5321)
+              command pipelining constraints.
+
 <b>TARPIT CONTROLS</b>
        When a remote SMTP client makes errors, the  Postfix  SMTP  server  can
        insert  delays  before  responding. This can help to slow down run-away
index 1c6ec5576d56118ea8e731fdb762528e7c088b34..75d1a65a785ee92da2e6ef38d86a1ac41a833341 100644 (file)
@@ -150,6 +150,15 @@ TLSPROXY(8)                                                        TLSPROXY(8)
               A  workaround  for implementations that hang Postfix while shut-
               ting down a TLS session, until Postfix times out.
 
+       Available in Postfix 3.9, 3.8.1, 3.7.6, 3.6.10, 3.5.20 and later:
+
+       <b><a href="postconf.5.html#tls_config_file">tls_config_file</a> (default)</b>
+              Optional configuration file with baseline OpenSSL settings.
+
+       <b><a href="postconf.5.html#tls_config_name">tls_config_name</a> (empty)</b>
+              The application name passed by Postfix to OpenSSL  library  ini-
+              tialization functions.
+
 <b>STARTTLS SERVER CONTROLS</b>
        These settings are clones of Postfix SMTP server settings.  They  allow
        <a href="tlsproxy.8.html"><b>tlsproxy</b>(8)</a> to load the same certificate and private key information as
index b91b908c4526c553db3d556b5102a9e7b2d777e0..8d42405d3dc9e59f6c00899d50e84a1b92bbe0c1 100644 (file)
@@ -10412,6 +10412,16 @@ The smtpd_expansion_filter value is not subject to Postfix configuration
 parameter $name expansion.
 .PP
 This feature is available in Postfix 2.0 and later.
+.SH smtpd_forbid_unauth_pipelining (default: Postfix >= 3.9: yes)
+Disconnect remote SMTP clients that violate RFC 2920 (or 5321)
+command pipelining constraints. The server replies with "554 5.5.0
+Error: SMTP protocol synchronization" and logs the unexpected remote
+SMTP client input. Specify "smtpd_forbid_unauth_pipelining = yes"
+to enable. This feature is enabled by default with Postfix >=
+3.9.
+.PP
+This feature is available in Postfix >= 3.9, 3.8.1, 3.7.6,
+3.6.10, and 3.5.20.
 .SH smtpd_forbidden_commands (default: CONNECT, GET, POST)
 List of commands that cause the Postfix SMTP server to immediately
 terminate the session with a 221 code. This can be used to disconnect
@@ -13122,6 +13132,104 @@ This feature is available in Postfix 2.4.15, 2.5.11, 2.6.8,
 2.7.2 and later versions. Specify "tls_append_default_CA = yes" for
 backwards compatibility, to avoid breaking certificate verification
 with sites that don't use permit_tls_all_clientcerts.
+.SH tls_config_file (default: default)
+Optional configuration file with baseline OpenSSL settings.
+OpenSSL loads any SSL settings found in the configuration file for
+the selected application name (see tls_config_name) or else the
+built\-in application name "openssl_conf" when no application name is
+specified, or no corresponding configuration section is present.
+.PP
+With OpenSSL releases 1.1.1 and 1.1.1a, applications (including
+Postfix) can neither specify an alternative configuration file, nor
+avoid loading the default configuration file.
+.PP
+With OpenSSL 1.1.1b or later, this parameter may be set to one of:
+.IP "\fBdefault\fR (default)"
+Load the system\-wide
+"openssl.cnf" configuration file.
+.br
+.IP "\fBnone\fR (recommended, OpenSSL 1.1.1b or later only)"
+This setting disables loading of  the system\-wide "openssl.cnf"
+file.
+.br
+.IP "\fB\fI/absolute\-path\fR\fR (OpenSSL 1.1.1b or later only)"
+Load the configuration file specified by \fI/absolute\-path\fR.
+With this setting it is an error for the file to not contain any
+settings for the selected tls_config_name.  There is no fallback to
+the default "openssl_conf" name.
+.br
+.br
+.PP
+Failures in processing of the built\-in default configuration file,
+are silently ignored.  Any errors in loading a non\-default configuration
+file are detected by Postfix, and cause TLS support to be disabled.
+.PP
+The OpenSSL configuration file format is not documented here,
+beyond giving two examples.
+.PP
+Example: Default settings for all applications.
+.sp
+.in +4
+.nf
+.na
+.ft C
+# The name 'openssl_conf' is the default application name
+# The section name to the right of the '=' sign is arbitrary,
+# any name will do, so long as it refers to the desired section.
+#
+# The name 'system_default' selects the settings applied internally
+# by the SSL library as part of SSL object creation.  Applications
+# can then apply any additional settings of their choice.
+#
+# In this example, TLS versions prior to 1.2 are disabled by default.
+#
+openssl_conf = system_wide_settings
+[system_wide_settings]
+ssl_conf = ssl_library_settings
+[ssl_library_settings]
+system_default = initial_ssl_settings
+[initial_ssl_settings]
+MinProtocol = TLSv1.2
+.fi
+.ad
+.ft R
+.in -4
+.PP
+Example: Custom settings for an application named "postfix".
+.sp
+.in +4
+.nf
+.na
+.ft C
+# The mapping from an application name to the corresponding configuration
+# section must appear near the top of the file, (in what is sometimes called
+# the "default section") prior to the start of any explicitly named
+# "[sections]".  The named sections can appear in any order and don't nest.
+#
+postfix = postfix_settings
+[postfix_settings]
+ssl_conf = postfix_ssl_settings
+[postfix_ssl_settings]
+system_default = baseline_postfix_settings
+[baseline_postfix_settings]
+MinProtocol = TLSv1
+.fi
+.ad
+.ft R
+.in -4
+.PP
+This feature is available in Postfix >= 3.9, 3.8.1, 3.7.6,
+3.6.10, and 3.5.20.
+.SH tls_config_name (default: empty)
+The application name passed by Postfix to OpenSSL library
+initialization functions.  This name is used to select the desired
+configuration "section" in the OpenSSL configuration file specified
+via the tls_config_file parameter.  When empty, or when the
+selected name is not present in the configuration file, the default
+application name ("openssl_conf") is used as a fallback.
+.PP
+This feature is available in Postfix >= 3.9, 3.8.1, 3.7.6,
+3.6.10, and 3.5.20.
 .SH tls_daemon_random_bytes (default: 32)
 The number of pseudo\-random bytes that an \fBsmtp\fR(8) or \fBsmtpd\fR(8)
 process requests from the \fBtlsmgr\fR(8) server in order to seed its
index 0472b9cad45893307a7d3250c04f556a015c554b..9194e406bf881ffcf5561099e570cdd190f2fc1c 100644 (file)
@@ -603,6 +603,13 @@ Available in Postfix 3.5, 3.4.6, 3.3.5, 3.2.10, 3.1.13 and later:
 .IP "\fBtls_fast_shutdown_enable (yes)\fR"
 A workaround for implementations that hang Postfix while shutting
 down a TLS session, until Postfix times out.
+.PP
+Available in Postfix 3.9, 3.8.1, 3.7.6, 3.6.10, 3.5.20 and later:
+.IP "\fBtls_config_file (default)\fR"
+Optional configuration file with baseline OpenSSL settings.
+.IP "\fBtls_config_name (empty)\fR"
+The application name passed by Postfix to OpenSSL library
+initialization functions.
 .SH "OBSOLETE STARTTLS CONTROLS"
 .na
 .nf
index f016451c72a802507cd31ef336c630664b353fa9..0af4d8ae577684045c2fbe820d04653850e01eed 100644 (file)
@@ -548,6 +548,13 @@ Available in Postfix 3.5 and later:
 .IP "\fBinfo_log_address_format (external)\fR"
 The email address form that will be used in non\-debug logging
 (info, warning, etc.).
+.PP
+Available in Postfix 3.9, 3.8.1, 3.7.6, 3.6.10, 3.5.20 and later:
+.IP "\fBtls_config_file (default)\fR"
+Optional configuration file with baseline OpenSSL settings.
+.IP "\fBtls_config_name (empty)\fR"
+The application name passed by Postfix to OpenSSL library
+initialization functions.
 .SH "OBSOLETE STARTTLS CONTROLS"
 .na
 .nf
@@ -808,6 +815,11 @@ Available in Postfix version 3.1 and later:
 The maximal number of AUTH commands that any client is allowed to
 send to this service per time unit, regardless of whether or not
 Postfix actually accepts those commands.
+.PP
+Available in Postfix 3.9, 3.8.1, 3.7.6, 3.6.10, 3.5.20 and later:
+.IP "\fBsmtpd_forbid_unauth_pipelining (Postfix >= 3.9: yes)\fR"
+Disconnect remote SMTP clients that violate RFC 2920 (or 5321)
+command pipelining constraints.
 .SH "TARPIT CONTROLS"
 .na
 .nf
index bec3f8588da0884fff21161ee492eec67e32c3d6..c61bdb6c705d798ab7c04793bd69708e9a47669e 100644 (file)
@@ -150,6 +150,13 @@ Available in Postfix 3.5, 3.4.6, 3.3.5, 3.2.10, 3.1.13 and later:
 .IP "\fBtls_fast_shutdown_enable (yes)\fR"
 A workaround for implementations that hang Postfix while shutting
 down a TLS session, until Postfix times out.
+.PP
+Available in Postfix 3.9, 3.8.1, 3.7.6, 3.6.10, 3.5.20 and later:
+.IP "\fBtls_config_file (default)\fR"
+Optional configuration file with baseline OpenSSL settings.
+.IP "\fBtls_config_name (empty)\fR"
+The application name passed by Postfix to OpenSSL library
+initialization functions.
 .SH "STARTTLS SERVER CONTROLS"
 .na
 .nf
index b69a9e400ad4077bbebdf0d409f331d7279acba6..27c423cef3f8516a206441ed4b2afa038ec5ed70 100755 (executable)
@@ -548,6 +548,7 @@ while (<>) {
     s;\bsmtpd_etrn_restrictions\b;<a href="postconf.5.html#smtpd_etrn_restrictions">$&</a>;g;
     s;\bsmtpd_expansion_filter\b;<a href="postconf.5.html#smtpd_expansion_filter">$&</a>;g;
     s;\bsmtpd_for[-</bB>]*\n*[ <bB>]*bidden_commands\b;<a href="postconf.5.html#smtpd_forbidden_commands">$&</a>;g;
+    s;\bsmtpd_for[-</bB>]*\n*[ <bB>]*bid_unauth_pipelining\b;<a href="postconf.5.html#smtpd_forbid_unauth_pipelining">$&</a>;g;
     s;\bsmtpd_hard_error_limit\b;<a href="postconf.5.html#smtpd_hard_error_limit">$&</a>;g;
     s;\bsmtpd_helo_required\b;<a href="postconf.5.html#smtpd_helo_required">$&</a>;g;
     s;\bsmtpd_helo_restrictions\b;<a href="postconf.5.html#smtpd_helo_restrictions">$&</a>;g;
@@ -767,6 +768,8 @@ while (<>) {
     s;\btls_session_ticket_cipher\b;<a href="postconf.5.html#tls_session_ticket_cipher">$&</a>;g;
     s;\btls_server_sni_maps\b;<a href="postconf.5.html#tls_server_sni_maps">$&</a>;g;
     s;\btls_ssl_options\b;<a href="postconf.5.html#tls_ssl_options">$&</a>;g;
+    s;\btls_config_name\b;<a href="postconf.5.html#tls_config_name">$&</a>;g;
+    s;\btls_config_file\b;<a href="postconf.5.html#tls_config_file">$&</a>;g;
     s;\btls_dane_digest_agility\b;<a href="postconf.5.html#tls_dane_digest_agility">$&</a>;g;
     s;\btls_dane_trust_anchor_digest_enable\b;<a href="postconf.5.html#tls_dane_trust_anchor_digest_enable">$&</a>;g;
     s;\btls_fast_shutdown_enable\b;<a href="postconf.5.html#tls_fast_shutdown_enable">$&</a>;g;
index 12e1cc5c71e3f824815d2ffc89a7b31772404da5..c3a958aa7b413e50c9264c890fc1d7dc4450709e 100644 (file)
@@ -18058,3 +18058,114 @@ name-to-port = 1*(service-name "=') port-number
 name or port number. </p>
 
 <p> This feature is available in Postfix 3.6 and later. </p>
+%PARAM tls_config_name
+
+<p> The application name passed by Postfix to OpenSSL library
+initialization functions.  This name is used to select the desired
+configuration "section" in the OpenSSL configuration file specified
+via the tls_config_file parameter.  When empty, or when the
+selected name is not present in the configuration file, the default
+application name ("openssl_conf") is used as a fallback.  </p>
+
+<p> This feature is available in Postfix &ge; 3.9, 3.8.1, 3.7.6,
+3.6.10, and 3.5.20. </p>
+
+%PARAM tls_config_file default
+
+<p> Optional configuration file with baseline OpenSSL settings.
+OpenSSL loads any SSL settings found in the configuration file for
+the selected application name (see tls_config_name) or else the
+built-in application name "openssl_conf" when no application name is
+specified, or no corresponding configuration section is present.
+</p>
+
+<p> With OpenSSL releases 1.1.1 and 1.1.1a, applications (including
+Postfix) can neither specify an alternative configuration file, nor
+avoid loading the default configuration file.  </p>
+
+<p> With OpenSSL 1.1.1b or later, this parameter may be set to one of:
+</p>
+
+<dl>
+
+<dt> <b>default</b> (default) </dt> <dd> Load the system-wide
+"openssl.cnf" configuration file.  </dd>
+
+<dt> <b>none</b> (recommended, OpenSSL 1.1.1b or later only) </dt>
+<dd> This setting disables loading of  the system-wide "openssl.cnf"
+file.  </dd>
+
+<dt> <b><i>/absolute-path</i></b> (OpenSSL 1.1.1b or later only) </dt>
+<dd> Load the configuration file specified by <i>/absolute-path</i>.
+With this setting it is an error for the file to not contain any
+settings for the selected tls_config_name.  There is no fallback to
+the default "openssl_conf" name. </dd>
+
+</dl>
+
+<p> Failures in processing of the built-in default configuration file,
+are silently ignored.  Any errors in loading a non-default configuration
+file are detected by Postfix, and cause TLS support to be disabled.
+</p>
+
+<p> The OpenSSL configuration file format is not documented here,
+beyond giving two examples. <p>
+
+<p> Example: Default settings for all applications. </p>
+
+<blockquote>
+<pre>
+# The name 'openssl_conf' is the default application name
+# The section name to the right of the '=' sign is arbitrary,
+# any name will do, so long as it refers to the desired section.
+#
+# The name 'system_default' selects the settings applied internally
+# by the SSL library as part of SSL object creation.  Applications
+# can then apply any additional settings of their choice.
+#
+# In this example, TLS versions prior to 1.2 are disabled by default.
+#
+openssl_conf = system_wide_settings
+[system_wide_settings]
+ssl_conf = ssl_library_settings
+[ssl_library_settings]
+system_default = initial_ssl_settings
+[initial_ssl_settings]
+MinProtocol = TLSv1.2
+</pre>
+</blockquote>
+
+<p> Example: Custom settings for an application named "postfix". </p>
+
+<blockquote>
+<pre>
+# The mapping from an application name to the corresponding configuration
+# section must appear near the top of the file, (in what is sometimes called
+# the "default section") prior to the start of any explicitly named
+# "[sections]".  The named sections can appear in any order and don't nest.
+#
+postfix = postfix_settings
+[postfix_settings]
+ssl_conf = postfix_ssl_settings
+[postfix_ssl_settings]
+system_default = baseline_postfix_settings
+[baseline_postfix_settings]
+MinProtocol = TLSv1
+</pre>
+</blockquote>
+
+<p> This feature is available in Postfix &ge; 3.9, 3.8.1, 3.7.6,
+3.6.10, and 3.5.20. </p>
+
+%PARAM smtpd_forbid_unauth_pipelining Postfix &ge; 3.9: yes
+
+<p> Disconnect remote SMTP clients that violate RFC 2920 (or 5321)
+command pipelining constraints. The server replies with "554 5.5.0
+Error: SMTP protocol synchronization" and logs the unexpected remote
+SMTP client input. Specify "smtpd_forbid_unauth_pipelining = yes"
+to enable. This feature is enabled by default with Postfix &ge;
+3.9.  </p>
+
+<p> This feature is available in Postfix &ge; 3.9, 3.8.1, 3.7.6,
+3.6.10, and 3.5.20. </p>
index 44ddf5369b86e4cde4839114a3287d475d8b487a..8697899dcb0009423eeb2f13c99bfcbb273073c0 100644 (file)
@@ -2430,6 +2430,10 @@ extern char *var_smtpd_exp_filter;
 #define DEF_SMTPD_PEERNAME_LOOKUP      1
 extern bool var_smtpd_peername_lookup;
 
+#define VAR_SMTPD_FORBID_UNAUTH_PIPE   "smtpd_forbid_unauth_pipelining"
+#define DEF_SMTPD_FORBID_UNAUTH_PIPE   0
+extern bool var_smtpd_forbid_unauth_pipe;
+
  /*
   * Heuristic to reject unknown local recipients at the SMTP port.
   */
@@ -3313,8 +3317,17 @@ extern bool var_smtp_sender_auth;
 extern bool var_smtp_cname_overr;
 
  /*
-  * TLS cipherlists
+  * TLS library settings
   */
+#define VAR_TLS_CNF_FILE       "tls_config_file"
+#define DEF_TLS_CNF_FILE       "default"
+extern char *var_tls_cnf_file;
+
+#define VAR_TLS_CNF_NAME       "tls_config_name"
+#define DEF_TLS_CNF_NAME       ""
+extern char *var_tls_cnf_name;
+
+
 #define VAR_TLS_HIGH_CLIST     "tls_high_cipherlist"
 #define DEF_TLS_HIGH_CLIST     "aNULL:-aNULL:HIGH:@STRENGTH"
 extern char *var_tls_high_clist;
index 17cef036db645a2d5bccae8231321415dab2156d..a54432e62a2af12d5861207b9dfdf05306fbf688 100644 (file)
@@ -20,8 +20,8 @@
   * Patches change both the patchlevel and the release date. Snapshots have no
   * patchlevel; they change the release date only.
   */
-#define MAIL_RELEASE_DATE      "20230418"
-#define MAIL_VERSION_NUMBER    "3.6.9"
+#define MAIL_RELEASE_DATE      "20230605"
+#define MAIL_VERSION_NUMBER    "3.6.10"
 
 #ifdef SNAPSHOT
 #define MAIL_VERSION_DATE      "-" MAIL_RELEASE_DATE
index c60cb06f5da946556fb05d3b95832427a046b1bd..2f9a607318494236911872df5d11a124d6d562e0 100644 (file)
@@ -192,6 +192,11 @@ void    pcf_edit_main(int mode, int argc, char **argv)
        } else {
            msg_panic("pcf_edit_main: unknown mode %d", mode);
        }
+       if ((cvalue = htable_find(table, pattern)) != 0) {
+           msg_warn("ignoring earlier request: '%s = %s'",
+                    pattern, cvalue->value);
+           htable_delete(table, pattern, myfree);
+       }
        cvalue = (struct cvalue *) mymalloc(sizeof(*cvalue));
        cvalue->value = edit_value;
        cvalue->found = 0;
@@ -459,8 +464,38 @@ void    pcf_edit_master(int mode, int argc, char **argv)
 
            /*
             * Match each service pattern.
+            * 
+            * Additional care is needed when a request adds or replaces an
+            * entire service definition, instead of a specific field or
+            * parameter. Given a command "postconf -M name1/type1='name2
+            * type2 ...'", where name1 and name2 may differ, and likewise
+            * for type1 and type2:
+            * 
+            * - First, if an existing service definition a) matches the service
+            * pattern 'name1/type1', or b) matches the name and type in the
+            * new service definition 'name2 type2 ...', remove the service
+            * definition.
+            * 
+            * - Then, after an a) or b) type match, add a new service
+            * definition for 'name2 type2 ...', but only after the first
+            * match.
+            * 
+            * - Finally, if a request had no a) or b) type match for any
+            * master.cf service definition, add a new service definition for
+            * 'name2 type2 ...'.
             */
            for (req = edit_reqs; req < edit_reqs + num_reqs; req++) {
+               PCF_MASTER_ENT *tentative_entry = 0;
+               int     use_tentative_entry = 0;
+
+               /* Additional care for whole service definition requests. */
+               if ((mode & PCF_MASTER_ENTRY) && (mode & PCF_EDIT_CONF)) {
+                   tentative_entry = (PCF_MASTER_ENT *)
+                       mymalloc(sizeof(*tentative_entry));
+                   if ((err = pcf_parse_master_entry(tentative_entry,
+                                                     req->edit_value)) != 0)
+                       msg_fatal("%s: \"%s\"", err, req->raw_text);
+               }
                if (PCF_MATCH_SERVICE_PATTERN(req->service_pattern,
                                              service_name,
                                              service_type)) {
@@ -506,18 +541,30 @@ void    pcf_edit_master(int mode, int argc, char **argv)
                             * Replace entire master.cf entry.
                             */
                        case PCF_MASTER_ENTRY:
-                           if (new_entry != 0)
-                               pcf_free_master_entry(new_entry);
-                           new_entry = (PCF_MASTER_ENT *)
-                               mymalloc(sizeof(*new_entry));
-                           if ((err = pcf_parse_master_entry(new_entry,
-                                                    req->edit_value)) != 0)
-                               msg_fatal("%s: \"%s\"", err, req->raw_text);
+                           if (req->match_count == 1)
+                               use_tentative_entry = 1;
                            break;
                        default:
                            msg_panic("%s: unknown edit mode %d", myname, mode);
                        }
                    }
+               } else if (tentative_entry != 0
+                        && PCF_MATCH_SERVICE_PATTERN(tentative_entry->argv,
+                                                     service_name,
+                                                     service_type)) {
+                   service_name_type_matched = 1;      /* Sticky flag */
+                   req->match_count += 1;
+                   if (req->match_count == 1)
+                       use_tentative_entry = 1;
+               }
+               if (tentative_entry != 0) {
+                   if (use_tentative_entry) {
+                       if (new_entry != 0)
+                           pcf_free_master_entry(new_entry);
+                       new_entry = tentative_entry;
+                   } else {
+                       pcf_free_master_entry(tentative_entry);
+                   }
                }
            }
 
index 1a70b5dcfc4acfd0ed4a312c95635f46c9974ba0..e571d5e3a4a11d346d6df7c0537fca9cf83ee7d3 100644 (file)
 #include <readlline.h>
 #include <stringops.h>
 #include <split_at.h>
+#include <dict_ht.h>
 
 /* Global library. */
 
@@ -393,12 +394,12 @@ const char *pcf_parse_master_entry(PCF_MASTER_ENT *masterp, const char *buf)
        concatenate("ro", PCF_NAMESP_SEP_STR, masterp->name_space, (char *) 0);
     masterp->argv = argv;
     masterp->valid_names = 0;
+    masterp->ro_params = dict_ht_open(ro_name_space, O_CREAT | O_RDWR, 0);
     process_name = basename(argv->argv[PCF_MASTER_FLD_CMD]);
-    dict_update(ro_name_space, VAR_PROCNAME, process_name);
-    dict_update(ro_name_space, VAR_SERVNAME,
-               strcmp(process_name, argv->argv[0]) != 0 ?
-               argv->argv[0] : process_name);
-    masterp->ro_params = dict_handle(ro_name_space);
+    dict_put(masterp->ro_params, VAR_PROCNAME, process_name);
+    dict_put(masterp->ro_params, VAR_SERVNAME,
+            strcmp(process_name, argv->argv[0]) != 0 ?
+            argv->argv[0] : process_name);
     myfree(ro_name_space);
     masterp->all_params = 0;
     return (0);
index 5e39a0a567a58ece0d50be7bf523540eb87ffb5f..165870c874862436d51fe7c029e67363a3890694 100644 (file)
 /* .IP "\fBtls_fast_shutdown_enable (yes)\fR"
 /*     A workaround for implementations that hang Postfix while shutting
 /*     down a TLS session, until Postfix times out.
+/* .PP
+/*     Available in Postfix 3.9, 3.8.1, 3.7.6, 3.6.10, 3.5.20 and later:
+/* .IP "\fBtls_config_file (default)\fR"
+/*     Optional configuration file with baseline OpenSSL settings.
+/* .IP "\fBtls_config_name (empty)\fR"
+/*     The application name passed by Postfix to OpenSSL library
+/*     initialization functions.
 /* OBSOLETE STARTTLS CONTROLS
 /* .ad
 /* .fi
index 7e95b32fd69b13e9b0b86a9cc6b2740bf35fe2c2..b3b7e7369d689190933665845987744949973e03 100644 (file)
 /* .IP "\fBinfo_log_address_format (external)\fR"
 /*     The email address form that will be used in non-debug logging
 /*     (info, warning, etc.).
+/* .PP
+/*     Available in Postfix 3.9, 3.8.1, 3.7.6, 3.6.10, 3.5.20 and later:
+/* .IP "\fBtls_config_file (default)\fR"
+/*     Optional configuration file with baseline OpenSSL settings.
+/* .IP "\fBtls_config_name (empty)\fR"
+/*     The application name passed by Postfix to OpenSSL library
+/*     initialization functions.
 /* OBSOLETE STARTTLS CONTROLS
 /* .ad
 /* .fi
 /*     The maximal number of AUTH commands that any client is allowed to
 /*     send to this service per time unit, regardless of whether or not
 /*     Postfix actually accepts those commands.
+/* .PP
+/*     Available in Postfix 3.9, 3.8.1, 3.7.6, 3.6.10, 3.5.20 and later:
+/* .IP "\fBsmtpd_forbid_unauth_pipelining (Postfix >= 3.9: yes)\fR"
+/*     Disconnect remote SMTP clients that violate RFC 2920 (or 5321)
+/*     command pipelining constraints.
 /* TARPIT CONTROLS
 /* .ad
 /* .fi
@@ -1447,6 +1459,7 @@ char   *var_milt_eod_macros;
 char   *var_milt_unk_macros;
 char   *var_milt_macro_deflts;
 bool    var_smtpd_client_port_log;
+bool    var_smtpd_forbid_unauth_pipe;
 char   *var_stress;
 
 char   *var_reject_tmpf_act;
@@ -5375,6 +5388,32 @@ static SMTPD_CMD smtpd_cmd_table[] = {
 static STRING_LIST *smtpd_noop_cmds;
 static STRING_LIST *smtpd_forbid_cmds;
 
+/* smtpd_flag_ill_pipelining - flag pipelining protocol violation */
+
+static int smtpd_flag_ill_pipelining(SMTPD_STATE *state)
+{
+
+    /*
+     * This code will not return after I/O error, timeout, or EOF. VSTREAM
+     * exceptions must be enabled in advance with smtp_stream_setup().
+     */
+    if (vstream_peek(state->client) == 0
+       && peekfd(vstream_fileno(state->client)) > 0)
+       (void) vstream_ungetc(state->client, smtp_fgetc(state->client));
+    if (vstream_peek(state->client) > 0) {
+       if (state->expand_buf == 0)
+           state->expand_buf = vstring_alloc(100);
+       escape(state->expand_buf, vstream_peek_data(state->client),
+              vstream_peek(state->client) < 100 ?
+              vstream_peek(state->client) : 100);
+       msg_info("improper command pipelining after %s from %s: %s",
+                state->where, state->namaddr, STR(state->expand_buf));
+       state->flags |= SMTPD_FLAG_ILL_PIPELINING;
+       return (1);
+    }
+    return (0);
+}
+
 /* smtpd_proto - talk the SMTP protocol */
 
 static void smtpd_proto(SMTPD_STATE *state)
@@ -5513,6 +5552,21 @@ static void smtpd_proto(SMTPD_STATE *state)
        }
 #endif
 
+       /*
+        * If the client spoke before the server sends the initial greeting,
+        * raise a flag and log the content of the protocol violation. This
+        * check MUST NOT apply to TLS wrappermode connections.
+        */
+       if (SMTPD_STAND_ALONE(state) == 0
+           && vstream_context(state->client) == 0      /* not postscreen */
+           && (state->flags & SMTPD_FLAG_ILL_PIPELINING) == 0
+           && smtpd_flag_ill_pipelining(state)
+           && var_smtpd_forbid_unauth_pipe) {
+           smtpd_chat_reply(state,
+                         "554 5.5.0 Error: SMTP protocol synchronization");
+           break;
+       }
+
        /*
         * XXX The client connection count/rate control must be consistent in
         * its use of client address information in connect and disconnect
@@ -5740,16 +5794,11 @@ static void smtpd_proto(SMTPD_STATE *state)
                && (strcasecmp(state->protocol, MAIL_PROTO_ESMTP) != 0
                    || (cmdp->flags & SMTPD_CMD_FLAG_LAST))
                && (state->flags & SMTPD_FLAG_ILL_PIPELINING) == 0
-               && (vstream_peek(state->client) > 0
-                   || peekfd(vstream_fileno(state->client)) > 0)) {
-               if (state->expand_buf == 0)
-                   state->expand_buf = vstring_alloc(100);
-               escape(state->expand_buf, vstream_peek_data(state->client),
-                      vstream_peek(state->client) < 100 ?
-                      vstream_peek(state->client) : 100);
-               msg_info("improper command pipelining after %s from %s: %s",
-                        cmdp->name, state->namaddr, STR(state->expand_buf));
-               state->flags |= SMTPD_FLAG_ILL_PIPELINING;
+               && smtpd_flag_ill_pipelining(state)
+               && var_smtpd_forbid_unauth_pipe) {
+               smtpd_chat_reply(state,
+                         "554 5.5.0 Error: SMTP protocol synchronization");
+               break;
            }
            if (cmdp->action(state, argc, argv) != 0)
                state->error_count++;
@@ -6412,6 +6461,7 @@ int     main(int argc, char **argv)
        VAR_SMTPD_PEERNAME_LOOKUP, DEF_SMTPD_PEERNAME_LOOKUP, &var_smtpd_peername_lookup,
        VAR_SMTPD_DELAY_OPEN, DEF_SMTPD_DELAY_OPEN, &var_smtpd_delay_open,
        VAR_SMTPD_CLIENT_PORT_LOG, DEF_SMTPD_CLIENT_PORT_LOG, &var_smtpd_client_port_log,
+       VAR_SMTPD_FORBID_UNAUTH_PIPE, DEF_SMTPD_FORBID_UNAUTH_PIPE, &var_smtpd_forbid_unauth_pipe,
        0,
     };
     static const CONFIG_NBOOL_TABLE nbool_table[] = {
index 11eade61b13a673fc831077a0f97300fba8790a0..3361447869ab538a31a99a298c795a5f4688ebe2 100644 (file)
@@ -76,6 +76,7 @@ extern const char *str_tls_level(int);
 #include <openssl/crypto.h>            /* Legacy SSLEAY_VERSION_NUMBER */
 #include <openssl/opensslv.h>          /* OPENSSL_VERSION_NUMBER */
 #include <openssl/ssl.h>
+#include <openssl/conf.h>
 
  /* Appease indent(1) */
 #define x509_stack_t STACK_OF(X509)
@@ -311,6 +312,7 @@ extern void tls_free_app_context(TLS_APPL_STATE *);
   * tls_misc.c
   */
 extern void tls_param_init(void);
+extern int tls_library_init(void);
 
  /*
   * Protocol selection.
index dcd7975c55e7d2da58c016328c07f7a2c19af3f6..3984c044a0fa73f3c4646eb46dabf16c045cab4f 100644 (file)
@@ -640,6 +640,13 @@ TLS_APPL_STATE *tls_client_init(const TLS_CLIENT_INIT_PROPS *props)
      */
     tls_check_version();
 
+    /*
+     * Initialize the OpenSSL library, possibly loading its configuration
+     * file.
+     */
+    if (tls_library_init() == 0)
+       return (0);
+
     /*
      * Create an application data index for SSL objects, so that we can
      * attach TLScontext information; this information is needed inside
index f82916b56eaecdef23c939cf388e657568b79c47..af6a2fdc184c658c97b1db110d712bfb91dbdd2c 100644 (file)
@@ -29,6 +29,8 @@
 /*     #define TLS_INTERNAL
 /*     #include <tls.h>
 /*
+/*     char    *var_tls_cnf_file;
+/*     char    *var_tls_cnf_name;
 /*     char    *var_tls_high_clist;
 /*     char    *var_tls_medium_clist;
 /*     char    *var_tls_low_clist;
@@ -69,6 +71,8 @@
 /*
 /*     void    tls_param_init()
 /*
+/*     int     tls_library_init(void)
+/*
 /*     int     tls_proto_mask_lims(plist, floor, ceiling)
 /*     const char *plist;
 /*     int     *floor;
 /*     tls_param_init() loads main.cf parameters used internally in
 /*     TLS library. Any errors are fatal.
 /*
+/*     tls_library_init() initializes the OpenSSL library, optionally
+/*     loading an OpenSSL configuration file.
+/*
 /*     tls_pre_jail_init() opens any tables that need to be opened before
 /*     entering a chroot jail. The "role" parameter must be TLS_ROLE_CLIENT
 /*     for clients and TLS_ROLE_SERVER for servers. Any errors are fatal.
  /*
   * Tunable parameters.
   */
+char   *var_tls_cnf_file;
+char   *var_tls_cnf_name;
 char   *var_tls_high_clist;
 char   *var_tls_medium_clist;
 char   *var_tls_low_clist;
@@ -642,6 +651,8 @@ void    tls_param_init(void)
 {
     /* If this changes, update TLS_CLIENT_PARAMS in tls_proxy.h. */
     static const CONFIG_STR_TABLE str_table[] = {
+       VAR_TLS_CNF_FILE, DEF_TLS_CNF_FILE, &var_tls_cnf_file, 0, 0,
+       VAR_TLS_CNF_NAME, DEF_TLS_CNF_NAME, &var_tls_cnf_name, 0, 0,
        VAR_TLS_HIGH_CLIST, DEF_TLS_HIGH_CLIST, &var_tls_high_clist, 1, 0,
        VAR_TLS_MEDIUM_CLIST, DEF_TLS_MEDIUM_CLIST, &var_tls_medium_clist, 1, 0,
        VAR_TLS_LOW_CLIST, DEF_TLS_LOW_CLIST, &var_tls_low_clist, 1, 0,
@@ -685,6 +696,118 @@ void    tls_param_init(void)
     get_mail_conf_bool_table(bool_table);
 }
 
+/* tls_library_init - perform OpenSSL library initialization */
+
+int     tls_library_init(void)
+{
+    OPENSSL_INIT_SETTINGS *init_settings;
+    char   *conf_name = *var_tls_cnf_name ? var_tls_cnf_name : 0;
+    char   *conf_file = 0;
+    unsigned long init_opts = 0;
+
+#define TLS_LIB_INIT_TODO      (-1)
+#define TLS_LIB_INIT_ERR       (0)
+#define TLS_LIB_INIT_OK                (1)
+
+    static int init_res = TLS_LIB_INIT_TODO;
+
+    if (init_res != TLS_LIB_INIT_TODO)
+       return (init_res);
+
+    /*
+     * Backwards compatibility: skip this function unless the Postfix
+     * configuration actually has non-default tls_config_xxx settings.
+     */
+    if (strcmp(var_tls_cnf_file, DEF_TLS_CNF_FILE) == 0
+       && strcmp(var_tls_cnf_name, DEF_TLS_CNF_NAME) == 0) {
+       if (msg_verbose)
+           msg_info("tls_library_init: using backwards-compatible defaults");
+       return (init_res = TLS_LIB_INIT_OK);
+    }
+    if ((init_settings = OPENSSL_INIT_new()) == 0) {
+       msg_warn("error allocating OpenSSL init settings, "
+                "disabling TLS support");
+       return (init_res = TLS_LIB_INIT_ERR);
+    }
+#define TLS_LIB_INIT_RETURN(x) \
+    do { OPENSSL_INIT_free(init_settings); return (init_res = (x)); } while(0)
+
+#if OPENSSL_VERSION_NUMBER < 0x1010102fL
+
+    /*
+     * OpenSSL 1.1.0 through 1.1.1a, no support for custom configuration
+     * files, disabling loading of the file, or getting strict error
+     * handling.  Thus, the only supported configuration file is "default".
+     */
+    if (strcmp(var_tls_cnf_file, "default") != 0) {
+       msg_warn("non-default %s = %s requires OpenSSL 1.1.1b or later, "
+              "disabling TLS support", VAR_TLS_CNF_FILE, var_tls_cnf_file);
+       TLS_LIB_INIT_RETURN(TLS_LIB_INIT_ERR);
+    }
+#else
+    {
+       unsigned long file_flags = 0;
+
+       /*-
+        * OpenSSL 1.1.1b or later:
+        * We can now use a non-default configuration file, or
+        * use none at all.  We can also request strict error
+        * reporting.
+        */
+       if (strcmp(var_tls_cnf_file, "none") == 0) {
+           init_opts |= OPENSSL_INIT_NO_LOAD_CONFIG;
+       } else if (strcmp(var_tls_cnf_file, "default") == 0) {
+
+           /*
+            * The default global config file is optional.  With "default"
+            * initialisation we don't insist on a match for the requested
+            * application name, allowing fallback to the default application
+            * name, even when a non-default application name is specified.
+            * Errors in loading the default configuration are ignored.
+            */
+           conf_file = 0;
+           file_flags |= CONF_MFLAGS_IGNORE_MISSING_FILE;
+           file_flags |= CONF_MFLAGS_DEFAULT_SECTION;
+           file_flags |= CONF_MFLAGS_IGNORE_RETURN_CODES | CONF_MFLAGS_SILENT;
+       } else if (*var_tls_cnf_file == '/') {
+
+           /*
+            * A custom config file must be present, error reporting is
+            * strict and the configuration section for the requested
+            * application name does not fall back to "openssl_conf" when
+            * missing.
+            */
+           conf_file = var_tls_cnf_file;
+       } else {
+           msg_warn("non-default %s = %s is not an absolute pathname, "
+              "disabling TLS support", VAR_TLS_CNF_FILE, var_tls_cnf_file);
+           TLS_LIB_INIT_RETURN(TLS_LIB_INIT_ERR);
+       }
+
+       OPENSSL_INIT_set_config_file_flags(init_settings, file_flags);
+    }
+#endif
+
+    if (conf_file)
+       OPENSSL_INIT_set_config_filename(init_settings, conf_file);
+    if (conf_name)
+       OPENSSL_INIT_set_config_appname(init_settings, conf_name);
+
+    if (OPENSSL_init_ssl(init_opts, init_settings) <= 0) {
+       if ((init_opts & OPENSSL_INIT_NO_LOAD_CONFIG) == 0)
+           msg_warn("error loading the '%s' settings from the %s OpenSSL "
+                    "configuration file, disabling TLS support",
+                    conf_name ? conf_name : "global",
+                    conf_file ? conf_file : "default");
+       else
+           msg_warn("error initializing the OpenSSL library, "
+                    "disabling TLS support");
+       tls_print_errors();
+       TLS_LIB_INIT_RETURN(TLS_LIB_INIT_ERR);
+    }
+    TLS_LIB_INIT_RETURN(TLS_LIB_INIT_OK);
+}
+
 /* tls_pre_jail_init - Load TLS related pre-jail tables */
 
 void    tls_pre_jail_init(TLS_ROLE role)
index f32f9a0c8494c8e829bf35f53fd132a35686b886..030053c650dbf55d6bd5081992be604611009a6d 100644 (file)
@@ -44,6 +44,8 @@
   * VAR_TLS_SERVER_SNI_MAPS.
   */
 typedef struct TLS_CLIENT_PARAMS {
+    char   *tls_cnf_file;
+    char   *tls_cnf_name;
     char   *tls_high_clist;
     char   *tls_medium_clist;
     char   *tls_low_clist;
@@ -65,12 +67,13 @@ typedef struct TLS_CLIENT_PARAMS {
 } TLS_CLIENT_PARAMS;
 
 #define TLS_PROXY_PARAMS(params, a1, a2, a3, a4, a5, a6, a7, a8, \
-    a9, a10, a11, a12, a13, a14, a15, a16, a17, a18) \
+    a9, a10, a11, a12, a13, a14, a15, a16, a17, a18, a19, a20) \
     (((params)->a1), ((params)->a2), ((params)->a3), \
     ((params)->a4), ((params)->a5), ((params)->a6), ((params)->a7), \
     ((params)->a8), ((params)->a9), ((params)->a10), ((params)->a11), \
     ((params)->a12), ((params)->a13), ((params)->a14), ((params)->a15), \
-    ((params)->a16), ((params)->a17), ((params)->a18))
+    ((params)->a16), ((params)->a17), ((params)->a18), ((params)->a19), \
+    ((params)->a20))
 
  /*
   * tls_proxy_client_param_misc.c, tls_proxy_client_param_print.c, and
@@ -217,6 +220,8 @@ extern void tls_proxy_server_start_free(TLS_SERVER_START_PROPS *);
  /*
   * TLS_CLIENT_INIT_PROPS attributes.
   */
+#define TLS_ATTR_CNF_FILE      "config_file"
+#define TLS_ATTR_CNF_NAME      "config_name"
 #define TLS_ATTR_LOG_PARAM     "log_param"
 #define TLS_ATTR_LOG_LEVEL     "log_level"
 #define TLS_ATTR_VERIFYDEPTH   "verifydepth"
index 6c4158563a63896e13c736f5cf95ecd4a42f1263..3bf7369a7fe88d4b42d0c4a94797d257b7df0234 100644 (file)
@@ -78,6 +78,8 @@
 TLS_CLIENT_PARAMS *tls_proxy_client_param_from_config(TLS_CLIENT_PARAMS *params)
 {
     TLS_PROXY_PARAMS(params,
+                    tls_cnf_file = var_tls_cnf_file,
+                    tls_cnf_name = var_tls_cnf_name,
                     tls_high_clist = var_tls_high_clist,
                     tls_medium_clist = var_tls_medium_clist,
                     tls_low_clist = var_tls_low_clist,
index ac628502e469860270985411c2777969e770bbb2..a45ff8a46879e5692c8fb72846f45dc8a9e744e0 100644 (file)
@@ -95,6 +95,8 @@ int     tls_proxy_client_param_print(ATTR_PRINT_COMMON_FN print_fn, VSTREAM *fp,
        msg_info("begin tls_proxy_client_param_print");
 
     ret = print_fn(fp, flags | ATTR_FLAG_MORE,
+                  SEND_ATTR_STR(TLS_ATTR_CNF_FILE, params->tls_cnf_file),
+                  SEND_ATTR_STR(TLS_ATTR_CNF_NAME,  params->tls_cnf_name),
                   SEND_ATTR_STR(VAR_TLS_HIGH_CLIST, params->tls_high_clist),
                   SEND_ATTR_STR(VAR_TLS_MEDIUM_CLIST,
                                 params->tls_medium_clist),
index 06a63765161ee24ebc6801be53dad1e0487ce999..70833538b7e768addd2f44c2260f95bec53ea583 100644 (file)
 
 void    tls_proxy_client_param_free(TLS_CLIENT_PARAMS *params)
 {
+    myfree(params->tls_cnf_file);
+    myfree(params->tls_cnf_name);
     myfree(params->tls_high_clist);
     myfree(params->tls_medium_clist);
     myfree(params->tls_low_clist);
@@ -145,6 +147,8 @@ int     tls_proxy_client_param_scan(ATTR_SCAN_COMMON_FN scan_fn, VSTREAM *fp,
     TLS_CLIENT_PARAMS *params
     = (TLS_CLIENT_PARAMS *) mymalloc(sizeof(*params));
     int     ret;
+    VSTRING *cnf_file = vstring_alloc(25);
+    VSTRING *cnf_name = vstring_alloc(25);
     VSTRING *tls_high_clist = vstring_alloc(25);
     VSTRING *tls_medium_clist = vstring_alloc(25);
     VSTRING *tls_low_clist = vstring_alloc(25);
@@ -167,6 +171,8 @@ int     tls_proxy_client_param_scan(ATTR_SCAN_COMMON_FN scan_fn, VSTREAM *fp,
      */
     memset(params, 0, sizeof(*params));
     ret = scan_fn(fp, flags | ATTR_FLAG_MORE,
+                 RECV_ATTR_STR(TLS_ATTR_CNF_FILE, cnf_file),
+                 RECV_ATTR_STR(TLS_ATTR_CNF_NAME, cnf_name),
                  RECV_ATTR_STR(VAR_TLS_HIGH_CLIST, tls_high_clist),
                  RECV_ATTR_STR(VAR_TLS_MEDIUM_CLIST, tls_medium_clist),
                  RECV_ATTR_STR(VAR_TLS_LOW_CLIST, tls_low_clist),
@@ -192,6 +198,8 @@ int     tls_proxy_client_param_scan(ATTR_SCAN_COMMON_FN scan_fn, VSTREAM *fp,
                                &params->tls_multi_wildcard),
                  ATTR_TYPE_END);
     /* Always construct a well-formed structure. */
+    params->tls_cnf_file = vstring_export(cnf_file);
+    params->tls_cnf_name = vstring_export(cnf_name);
     params->tls_high_clist = vstring_export(tls_high_clist);
     params->tls_medium_clist = vstring_export(tls_medium_clist);
     params->tls_low_clist = vstring_export(tls_low_clist);
@@ -206,7 +214,7 @@ int     tls_proxy_client_param_scan(ATTR_SCAN_COMMON_FN scan_fn, VSTREAM *fp,
     params->tls_mgr_service = vstring_export(tls_mgr_service);
     params->tls_tkt_cipher = vstring_export(tls_tkt_cipher);
 
-    ret = (ret == 18 ? 1 : -1);
+    ret = (ret == 20 ? 1 : -1);
     if (ret != 1) {
        tls_proxy_client_param_free(params);
        params = 0;
index 8fcf6441458ba2d8773a1d02116f8bb46b76f69b..b17e111cabdacf65b6d792fc6b336a1677919c6e 100644 (file)
@@ -370,6 +370,13 @@ TLS_APPL_STATE *tls_server_init(const TLS_SERVER_INIT_PROPS *props)
      */
     tls_check_version();
 
+    /*
+     * Initialize the OpenSSL library, possibly loading its configuration
+     * file.
+     */
+    if (tls_library_init() == 0)
+       return (0);
+
     /*
      * First validate the protocols. If these are invalid, we can't continue.
      */
index 5ad7784f4fc6cb5a614f27483e328721643fb3c9..6c6ad45a461519ce8d3c150e752afc2d553ef802 100644 (file)
 /* .IP "\fBtls_fast_shutdown_enable (yes)\fR"
 /*     A workaround for implementations that hang Postfix while shutting
 /*     down a TLS session, until Postfix times out.
+/* .PP
+/*     Available in Postfix 3.9, 3.8.1, 3.7.6, 3.6.10, 3.5.20 and later:
+/* .IP "\fBtls_config_file (default)\fR"
+/*     Optional configuration file with baseline OpenSSL settings.
+/* .IP "\fBtls_config_name (empty)\fR"
+/*     The application name passed by Postfix to OpenSSL library
+/*     initialization functions.
 /* STARTTLS SERVER CONTROLS
 /* .ad
 /* .fi