userapps/opensource/reaim/html/index.html

   1 <html>
   2 <head>
   3   <title>ReAIM - A transparent AOL Instant Messenger Proxy</title>
   4   <link rel="stylesheet" href="doc-ns4.css" type="text/css" />
   5   <style type="text/css">
   6     @import url("doc.css");
   7   </style>
   8   <meta name="Author" content="Mark P. Cooke" />
   9   <meta name="Version" content="$Id: index.html,v 1.10 2002/12/09 23:30:21 mark-c Exp $" />
  10 </head>
  11 <body>
  12 <div class="page">
  13 <h1>ReAIM - AOL Instant Messenger Proxy</h1>
  14 <h2>What is ReAIM ?</h2>
  15
  16 <p>ReAIM is a compact transparent proxy designed to be run on or behind a
  17 Linux IPTables based firewall.  When run behind a simple address-translating
  18 firewall, the current AIM client software does not allow direct-connections
  19 between users to work.  AIM requires direct-connections for file and image
  20 transfers.</p>
  21
  22 <p>This proxy is designed to transparently intercept AIM client messages
  23 and pass them through a configurable filter/rewrite chain.  This allows
  24 selective modification of the source address provided in direct-connection
  25 setup packets, and so remote users can be told to use the global internet
  26 routable address, rather than the actual IP address of the client on the
  27 local network.</p>
  28
  29 <p>I have written a <a href="dcc.html">basic introduction</a> to how the
  30 AIM software sends messages, and the problems it encounters with address
  31 translation and firewalls.  It's worth looking over for a top level
  32 overview if the previous paragraph didn't make a lot of sense.</p>
  33
  34 <p class="last">Because the code seemed to be coming together nicely in a
  35 modular structure, I've added in support for MS Messenger's file transfer
  36 in a very similar way!</p>
  37
  38 <h2>Current Status</h2>
  39
  40 <p>The current code is alpha quality.  This means that it works for me,
  41 but has many rough edges and plenty of things still to finish and properly
  42 design.</p>
  43
  44 <p class="last">I regularly use the proxy for AIM messaging and file
  45 sharing.  It also has preliminary support for MS Messenger file
  46 transfers.</p>
  47
  48 <h2>Download</h2>
  49
  50 <p class="last">The <a href="http://sourceforge.net/project/showfiles.php?group_id=40800">File
  51 List page</a> at sourceforge holds links to all the released code.  In
  52 general you should use the most recent release, and if you are having
  53 trouble with an earlier release, please try the latest before filling out
  54 a bug report.</p>
  55
  56 <h2>Configuration</h2>
  57
  58 <p class="last">I have written a basic overview for setting up the
  59 <a href="setup.html">appropriate firewall rules</a>.  Included in the distribution is a
  60 sample firewall setup script.</p>
  61
  62 <h2>CVS</h2>
  63
  64 <p class="last">The current code can be downloaded from the CVS server at
  65 sourceforge in the usual way.  Instructions are <a
  66 href="http://sourceforge.net/cvs/?group_id=40800">available here</a>.</p>
  67
  68 <h2>Credits</h2>
  69
  70 <p>My thanks to everyone that has worked on decoding the OSCAR protocol
  71 used by AIM.  Without your work, this program would have taken much longer
  72 to produce.</p>
  73
  74 <p>To the Linux Hackers for providing transparent port interception and
  75 redirection - way to go!  iptables is an incredibly powerful framework.</p>
  76
  77 <p class="last">To my friends who introduced me to instant messaging, and
  78 the problems which exist in the current clients and their handling of
  79 firewalls and address translation.</p>
  80
  81 <h2>Contacting The Author</h2>
  82
  83 <p class="last">My name is Tyler Dur...err, I mean Mark Cooke.  Bugs,
  84 comments, feedback can be sent to me at <a href="mailto:mark-c@users.sourceforge.net">
  85 mark-c@users.sourceforge.net</a></p>
  86
  87 <br>
  88 <center><A href="http://sourceforge.net"><IMG src="http://sourceforge.net/sflogo.php?group_id=40800" width="88" height="31" border="0" alt="SourceForge Logo"></A></center>
  89
  90 </div>
  91 </body>
  92 </html>