mail::milter::wrapper::decodesrs(3pm) [debian man page]

Mail::Milter::Wrapper::DecodeSRS(3pm)			User Contributed Perl Documentation		     Mail::Milter::Wrapper::DecodeSRS(3pm)

NAME

       Mail::Milter::Wrapper::DecodeSRS - milter wrapper to decode SRS-encoded return path

SYNOPSIS

	   use Mail::Milter::Wrapper::DecodeSRS;

	   my $milter = ...;
	   my $wrapper = new Mail::Milter::Wrapper::DecodeSRS($milter);

	   my $wrapper2 = &DecodeSRS($milter); # convenience

DESCRIPTION

       Mail::Milter::Wrapper::DecodeSRS is a convenience milter wrapper which decodes MAIL FROM: return paths which have been encoded by the
       Sender Rewrite Scheme, SRS.  (More information:	http://www.libsrs2.org/) This wrapper internally understands both the SRS0 and SRS1 encod-
       ing schemes documented by the Mail::SRS author.

       The decoded address is made available to the contained milter via the "envfrom" callback, in the same way that a raw address would.

       NOTE:  If the address is not SRS encoded, the contained milter is NOT called for the duration of the message; instead, SMFIS_ACCEPT is
       returned.  This is because the milter writer is expected to use this wrapper in a chain that also includes the contained milter without
       wrapping, in order to prevent a malicious sender from using SRS to bypass access checks.

       For instance, the following is a proper usage of this wrapper in a chain:

	   my $envfrommilter = ...;

	   my $combinedmilter = new Mail::Milter::Chain(
	       new Mail::Milter::Wrapper::UnwrapSRS($envfrommilter),
	       $envfrommilter
	   );

       This behavior can also be used if, e.g., the MTA already does one form of MAIL FROM: check, and the contained milter repeats that same
       database check against SRS rewritten addresses.	(A good example would be a milter emulating Sendmail's access_db map.)

AUTHOR

       Todd Vierling, <tv@duh.org> <tv@pobox.com>

SEE ALSO

       Mail::Milter::Wrapper

perl v5.8.8							    2004-02-26				     Mail::Milter::Wrapper::DecodeSRS(3pm)

Mail::Milter::Module::ConnectRegex(3pm) 		User Contributed Perl Documentation		   Mail::Milter::Module::ConnectRegex(3pm)

NAME

       Mail::Milter::Module::ConnectRegex - milter to accept/reject connecting hosts matching regex(es)

SYNOPSIS

	   use Mail::Milter::Module::ConnectRegex;

	   my $milter = new Mail::Milter::Module::ConnectRegex('^foo$');

	   my $milter2 = &ConnectRegex(qw{^foo$ ^bar$}); # convenience

	   $milter2->set_message('Connections from %H disallowed');

DESCRIPTION

       This milter module rejects any connecting host whose hostname or IP address matches user-supplied regular expressions.  It can also func-
       tion as a whitelisting Chain element; see "accept_match()".

METHODS

       new(REGEX[, ...])
	   Accepts one or more regular expressions, as strings or qr// precompiled regexes.  They are tested in sequence, and the first match ter-
	   minates checking.  Note that all IP address literals will be enclosed in [square brackets]; so to test an IP address rather than a
	   hostname, ensure those brackets exist:

	       ^[ADDRESS]$

       accept_match(FLAG)
	   If FLAG is 0 (the default), a matching regex will cause the connection to be rejected.

	   If FLAG is 1, a matching regex will cause this module to return SMFIS_ACCEPT instead.  This allows a "ConnectRegex" to be used inside a
	   "Mail::Milter::Chain" container (in accept_break(1) mode), to function as a whitelist rather than a blacklist.

	   This method returns a reference to the object itself, allowing this method call to be chained.

       set_message(MESSAGE)
	   Sets the message used when rejecting connections.  This string may contain the substring %H, which will be replaced by the matching
	   hostname or IP address.

	   This method returns a reference to the object itself, allowing this method call to be chained.

BUGS

       In Sendmail 8.11 and 8.12, a milter rejection at "connect" stage does not allow the reply message to be set -- it simply becomes "not
       accepting messages".  However, this module still attempts to set the reply code and message in the hope that this will be fixed.

AUTHOR

       Todd Vierling, <tv@duh.org> <tv@pobox.com>

SEE ALSO

       Mail::Milter::Object

perl v5.8.8							    2004-02-26				   Mail::Milter::Module::ConnectRegex(3pm)