polic-spf.peruser
Section: File Formats (5)
Index
Return to Main Contents
NAME
policy-spf
-
policy-spf python pe-user configuration
VERSION
3.1.0
USAGE
Usage:
policy-spf [/etc/policy-spf/policy-spf.conf]
OTHER DOCUMENTATION
This documentation assumes you have read Postfix's README_FILES/
SMTPD_POLICY_README and are generally familiar with Sender Policy Framework
(SPF). See RFC 7208 for details.
man 1 policy-spf provides general operation documentation for this
package.
See man 5 policy-spf.conf for configuration file information.
SYNOPSIS
pytho-policy-spf operates with a default installed configuration file and
set of default configuration options that are used if the configuration file
cannot be found. These options can be changed by changing the installed
configuration files or through giving a path to an alternate configuration
file.
Additionally, different configurations can be provided on a per user basis.
This man page describes setup and user of per user (mail recipient)
configurations. Currently these configurations can only be stored in a text
file. If there is sufficient interest, other data storage methods may be
supported in the future.
DESCRIPTION
Use of pe-user configuration is defined in the application configuration
file with the setting "Per_User". The value of the setting gives the type and
location of the pe-user configuration information. Currently supported types
is text. User is defined an email address of a recipient of the message.
Most options available at the application level (See man 5 policy-spf.conf)
can be adjusted on a pe-user basis. Pe-user checks can only be done as part
of smtpd_recipient_restrictions. Pe-user actions are not possible at other
stages of the SMTP dialogue. The user is not yet known for
smtpd_client_restrictions, smtpd_helo_restrictions, or
smtpd_sender_restrictions. If used during smtpd_data_restrictions or
smtpd_end_of_data_restrictions, the entire message will be available only if
the message was only to a single recipient. If pe-user configurations are
used when recipient information is not available, warnings will be logged and
the pe-user information will be ignored.
The following options cannot be modified on a per user basis: Lookup_Time,
Header_Type, Hide_Receiver, Authserv_Id, Prospective, debugLevel, and Mock.
In addition to specifying individual users, regular expression matching is
also available, but may have performance implications since the entire
user table has to be traversed for each message recipient.
OPTIONS
X'ps:'
Text Pe-User Configuration File
The text file option is useful for testing and when only a small number of
users require pe-user configurations. It is specified in the main
configuration file:
"Per_User = text,/etc/pypolicy-spf/userconf"
Lines beginning with "#" are treated as comments and ignored. The location of
the file is determined by the system administrator. No default file is
provided in or installed by the package.
The configuration of the file is a comma separated combination of user and
configuration information, with one line per user's configuration information
(NOTE: due to man page formatting requirements, these lines may be wrapped in
your pager- in the config file, it must be one line per user):
postmaster@example.com,Mail_From_reject=No_Check|PermError_reject=False|HELO_reject=SPF_Not_Pass|TestOnly=1|debugLevel=5|skip_addresses=127.0.0.0/8,::ffff:127.0.0.0//104,::1//128|TempError_Defer=False
strict@example.com,PermError_reject=True|HELO_reject=SPF_Not_Pass|TempError_Defer=True
It is not necessary to specify all configuration parameters for each user,
only those that are different than the overall configuration need to be
specified.
If the specified per user configuration file is missing, an error is logged
and the global configuration is used instead.
SEE ALSO
man 1 policy-spf, man 5 policy-spf.conf, pytho-spf,
<
http://www.openspf.org>, RFC 7208
AUTHORS
This version of
policy-spf was written by Copyright © 200-2016,
Scott Kitterman <
scott@kitterman.com>. It is derived from Tumgreyspf,
written by Sean Reifschneider, tummy.com, ltd <
jafo@tummy.com>.
This ma-page was created by Scott Kitterman <scott@kitterman.com> and is
licensed under the same terms as the program.
Index
- NAME
-
- VERSION
-
- USAGE
-
- OTHER DOCUMENTATION
-
- SYNOPSIS
-
- DESCRIPTION
-
- OPTIONS
-
- Text Per-User Configuration File
-
- SEE ALSO
-
- AUTHORS
-
|
|
- Running on 
-
:
