IMAP ID Proxy Files

==== IMAP ID Proxy ====

---- Overview ----

The IMAP ID proxy sits between IMAP client and server, entirely 
transparently, except that it adds an IMAP ID command.
  
RFC 2971 "IMAP4 ID extension" states
- The sole purpose of the ID extension is to enable clients and servers
  to exchange information on their implementations for the purposes of
  statistical analysis and problem determination.
- Servers MUST NOT deny access to or refuse service for a client based on
  information from the ID command.
- Implementations MUST NOT send false information in an ID command.
 
This proxy counteracts servers that break the protocol, but note that it
breaks the protocol in turn.
 
WARNING: USE OF THIS PROXY MAY BREAK THE TERMS AND CONDITIONS OF YOUR
AGREEMENT WITH YOUR EMAIL PROVIDER.

---- Instructions ----

1) Unzip to a new directory.
2) Edit ImapIdProxy.properties following instructions in that file.
3) Start the proxy.  E.g. open a command prompt, cd to the directory you
created above, and type javaw -jar ImapIdProxy.jar
4) Configure your email client (e.g. Thunderbird) to point at the proxy.
 - Use your normal user name and password.
 - Server name = localhost
 - Port = 9143
 - Connection security = none

NB You may use a secure connection to your IMAP mail server.  However always
set "Connection security = none" because the LOCAL connection from your
email client to the proxy does not need to be secure (and you don't have 
the certificates to make a secure connection work).