Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
policy-spf.peruser(5)	      File Formats Manual	 policy-spf.peruser(5)

NAME
       policyd-spf - policyd-spf python	per-user configuration

VERSION
       2.0.0

USAGE
       Usage:
	 policyd-spf [/usr/local/etc/postfix-policyd-spf-python/policyd-
       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 policyd-spf provides general operation documentation for this
       package.

       See man 5 policyd-spf.conf for configuration file information.

SYNOPSIS
       python-policyd-spf operates with	a default installed configuration file
       and set of default configuration	options	that are used if the configu-
       ration file cannot be found.  These options can be changed by changing
       the installed configuration files or through giving a path to an	alter-
       nate configuration file.

       Additionally, different configurations can be provided on a per user
       basis.  This man	page describes setup and user of per user (mail	recip-
       ient) 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 per-user configuration is	defined	in the application configura-
       tion file with the setting "Per_User".  The value of the	setting	gives
       the type	and location of	the per-user configuration information.	 Cur-
       rently 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 policyd-
       spf.conf) can be	adjusted on a per-user basis.  Per-user	checks can
       only be done as part of smtpd_recipient_restrictions.  Per-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 per-user	con-
       figurations are used when recipient information is not available, warn-
       ings will be logged and the per-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, de-
       bugLevel, and Mock.

       In addition to specifying individual users, regular expression matching
       is also available, but may have performance implications	since the en-
       tire user table has to be traversed for each message recipient.

OPTIONS

Text Per-User Configuration File
       The text	file option is useful for testing and when only	a small	number
       of users	require	per-user configurations.  It is	specified in the main
       configuration file:

       "Per_User = text,/usr/local/etc/postfix-policyd-spf-python/userconf"

       Lines beginning with "#"	are treated as comments	and ignored.  The lo-
       cation of the file is determined	by the system administrator. No	de-
       fault 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_re-
       ject=False|HELO_reject=SPF_Not_Pass|TestOnly=1|debugLevel=5|skip_ad-
       dresses=127.0.0.0/8,::ffff:127.0.0.0//104,::1//128|TempError_De-
       fer=False strict@example.com,PermError_reject=True|HELO_re-
       ject=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 policyd-spf, man 5	policyd-spf.conf, python-spf,
       <http://www.openspf.org>, RFC 7208

AUTHORS
       This version of policyd-spf was written by Copyright A(C) 2007-2016,
       Scott Kitterman <scott@kitterman.com>.  It is derived from Tumgreyspf,
       written by Sean Reifschneider, tummy.com, ltd <jafo@tummy.com>.

       This man-page was created by Scott Kitterman <scott@kitterman.com> and
       is licensed under the same terms	as the program.

							 policy-spf.peruser(5)

NAME | VERSION | USAGE | OTHER DOCUMENTATION | SYNOPSIS | DESCRIPTION | OPTIONS | Text Per-User Configuration File | SEE ALSO | AUTHORS

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=policyd-spf.peruser&sektion=5&manpath=FreeBSD+12.2-RELEASE+and+Ports>

home | help