chromatic > Mail-TempAddress-0.62 > Mail::TempAddress

Download:
Mail-TempAddress-0.62.tar.gz

Dependencies

Annotate this POD

View/Report Bugs
Module Version: 0.62   Source  

NAME ^

Mail::TempAddress - module for managing simple, temporary mailing addresses

SYNOPSIS ^

    use Mail::TempAddress;
    my $mta = Mail::TempAddress->new( 'addresses' );
    $mta->process();

DESCRIPTION ^

Sometimes, you just need a really simple mailing address to last for a few days. You want it to be easy to create and easy to use, and you want it to be sufficiently anonymous that your real address isn't ever exposed.

Mail::TempAddress, Mail::TempAddress::Addresses, and Mail::TempAddress::Address make it easy to create a temporary mailing address system.

USING ADDRESSES ^

INSTALLING

Please see the README file in this distribution for installation and configuration instructions. You'll need to configure your mail server and your DNS, but you only need to do it once. The rest of these instructions assume you've installed Mail::TempAddress to handle all mail coming to addresses in the subdomain tempmail.example.com.

CREATING AN ADDRESS

To create a new temporary address, send an e-mail to the address new@tempmail.example.com. In the subject of the message, include the phrase *new*. You will receive a response informing you that the address has been created. The message will include the new address. In this case, it might be 3abfeec@tempmail.example.com.

Simply provide this address when required to register at a web site (for example).

You can specify additional directives when creating an address. Please see Directives for more information.

RECEIVING MESSAGES FROM A TEMPORARY ADDRESS

Every message sent to your temporary address will be resent to the address you used to create the address. The sender will not see your actual address.

REPLYING TO MESSAGES RECEIVED AT A TEMPORARY ADDRESS

Every message relayed to your actual address will contain a special Reply-To header keyed to the sender. Thus, a message from news@example.com may have a Reply-To header of 3abfeec+3f974d46@tempmail.example.com. Be sure to send any replies to this address so that the message may be relayed from your temporary address.

DIRECTIVES ^

Temporary addresses have two attributes. You can specify these attributes by including directives when you create a new address.

Directives go in the body of the creation message. They take the form:

    Directive: option

Expires

This directive governs how long the address will last. After its expiration date has passed, no one may send a message to the address. Everyone will then receive an error message indicating that the address does not exist.

This attribute is not set by default; addresses do not expire. To enable it, use the directive form:

    Expires: 7d2h

This directive will cause the address to expire in seven days and two hours. Valid time units are:

This should suffice for most purposes.

Description

This is a single line that describes the purpose of the address. If provided, it will be sent in the X-MTA-Description header in all messages sent to the address. By default, it is blank. To set a description, use the form:

    Description: This address was generated to enter a contest.

METHODS ^

AUTHOR ^

chromatic, chromatic@wgz.org.

BUGS ^

No known bugs.

TODO ^

COPYRIGHT ^

Copyright (c) 2003 - 2009 chromatic. Some rights reserved. You may use, modify, and distribute this module under the same terms as Perl 5.10 itself.

syntax highlighting: