IMAP ID Proxy Files

==== IMAP ID Proxy ====

NB Version 1.0 is identical to Version 0.3 Beta.  After 3 years of testing, 
it's definitely time to call it stable!

---- 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: Before using this program to access your email, please check the 
terms and conditions of your service agreement. 

---- Instructions ----

1) Unzip to a new directory.
2) The default settings work for Yahoo.  If you need different settings, 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 can configure IMAP ID Proxy to use a secure connection to your IMAP
mail server.  However always configure your email client with 
"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).