<!-- Created with - h.Scribe v1.0 - for BeOS -->
<HTML>
<HEAD>
<META HTTP-EQUIV="Content-Type"
CONTENT="text/html; charset=iso-8859-1">
<META NAME="GENERATOR" CONTENT="h.Scribe v1.0 (BeOS)">
<TITLE>HTTP Proxy</TITLE>
</HEAD>
<BODY  BGCOLOR="#ffffff">

<CENTER><H1>HTTP Proxy 1.0b</H1></CENTER>
<P ALIGN="left">Copyright &copy; 1998, Joe Kloss<BR>
This is a beta release of HTTP Proxy.<BR>Please send bug reports and comments to <A HREF="mailto:axly@deltanet.com">axly@deltanet.com</A> or <A HREF="mailto:KlossSoft@kagi.com">KlossSoft@kagi.com</A>.<BR> The latest info and version can be found at <A HREF="http://www.deltanet.com/users/axly/">http://www.deltanet.com/users/axly/</A>
</P>
<HR>
<P>HTTP Proxy is a proxy server for BeOS. A proxy server allows all the computers on your local network to share a single Internet account. HTTP Proxy supports HTTP Protocol and Generic TCP Proxies. Generic TCP Proxies can be used to provide access to NNTP, SMTP, POP3, IRC, telnet, other proxy servers, and most other TCP based services. HTTP Proxy can be monitored and configured from any computer with a web browser on your local network or the Internet if the username and password are known.
</P>

<H3>How to Setup HTTP Proxy</H3>
<UL>
	<LI>Setup networking with 2 or more network interfaces. See <A HREF="file:///boot/beos/documentation/User's Guide/HTML/08_internet_connect.html#10236">BeOS Users Guide</A>.</LI>
	<LI>At least one network interface must be connected to the Internet.</LI>
	<LI>Start HTTP Proxy.</LI>
	<LI><A HREF="#Configure">Configure HTTP Proxy.</A></LI>
	<UL>
		<LI><A HREF="#Ports">Common Services and Their Port Numbers</A></LI>
		<LI><A HREF="#ProxyProxy">Proxy Proxy?</A></LI>
	</UL>
	<LI>Configure your web browser for proxy access.</LI>
	<UL>
		<LI><A HREF="#NetPositive">NetPositive</A></LI>
		<LI><A HREF="#Netscape">Netscape</A></LI>
		<LI><A HREF="#IE">Internet Explorer</A></LI>
	</UL>
	<LI><A HREF="#Other">Configure other software for proxy access.</A></LI>
	<UL>
		<LI><A HREF="#RealAudio">Real Audio</A></LI>
		<LI><A HREF="#NetShow">NetShow / MS Media Player</A></LI>
		<LI><A HREF="#OtherServices">Mail, News, Proxy Proxy, and Other TCP Services.</A></LI>
	</UL>
	<LI><A HREF="#Notes">Notes</A></LI>
	<UL>
		<LI><A HREF="#Startup">How do I make it startup automatically when the computer boots?</A></LI>
	</UL>
	<LI><A HREF="#Copyright">Copyright Info</A></LI>
	<LI><A HREF="#Legal">Disclaimer: <B>Read before using</B></A></LI>
	<LI><A HREF="#Contact">Contact Info</A></LI>
</UL>

<H3><A NAME="Configure"></A>Configuring HTTP Proxy</H3>
<UL>
<P><A HREF="http://127.0.0.1:25000/">Connect to Proxy Admin Server</A><BR>
Note: This link will only work if HTTP Proxy is running on the machine your are viewing this document from.</P>
<P>HTTP Proxy can be configured from any computer with a web browser connected to the network. The Admin. Server runs on port 25000 of the proxy server and requires a username and password to gain access. The username and password are configured with the "Network" control panel ( the same ones used for ftp and telnet access to your machine ). If you should enter the wrong name or password from NetPositive, you will have to quit NetPositive before you can try again. To connect to the Admin Server, use the url "http://IP:25000/" where IP is the IP name or address of the proxy server.</P>
<P>The Admin. Server will display the currently running proxy services, an interface to add new services, and control commands. By default, only one service will be running until you configure more ( HTTP Proxy @ 8080 ). Under "Proxy Services" the following information is displayed:</P>
<LI>Proxy Name: The name of the proxy service.</LI>
<LI>Local Port: The TCP port this service is available on.</LI>
<LI>Hits: The total number of connections to this service.</LI>
<LI>Connections: Current connections and maximum connections.</LI>
<LI>Remote Host: The host name and port number this proxy will connect to. A HTTP Proxy will display "N/A" because this is dynamically determined from the HTTP Request.</LI>
<LI>delete: Clicking this link will remove the sevice from the list.</LI>
<H4>Add Proxy Service</H4>
<P>This section is used to add new services. To use it, fill out the fields and click the "Add Service" button. The fields include:</P>
<LI>Type: This menu selects the proxy type. Currently only two types are supported: HTTP Proxy and Generic Proxy. The HTTP Proxy type dynamically determines the remote host address and port from the HTTP Request, while the Generic type is staticly determined by the "Remote Host" and "Port" fields.</LI>
<LI>Name: The name of the proxy serice. This should be descriptive.</LI>
<LI>Local Port: The TCP port used by the proxy server.</LI>
<LI>Max Conn: The maximum simultaneous connections to this service. This can be used to limit the CPU load on the proxy server.</LI>
<LI>Remote Host: The IP name or address of the remote server. Ignored by "HTTP Proxy" type.</LI>
<LI>Remote Port: The TCP port on the remote server. Ignored by "HTTP Proxy" type.</LI>
<H4>Commands</H4>
<LI>Restart Services: Restarts all proxy services. This can be used to clear the hit count and disconnect any lingering connections to the server.</LI>
<LI>Shutdown Proxy Server: This quits the proxy server and the admin server. You will not be able to access services until you start the server again.</LI>
<LI>Auto Refresh: Tells the web browser to refresh the list of services automatically every 15 seconds. This does not work with NetPositive. ( try Netscape or IE ).
<LI>Mail Author: Send E-mail to the author of HTTP Proxy to ask support questions or make comments.</LI>
<H4><A NAME="Configure"></A>Common Services and Their Port Numbers</H4>
<P>The local port does not have to be the same as the remote port, unless the TCP client does not have the ability to connect to other ports.</P>
<LI>Proxy Server: 8080</LI>
<LI>NNTP ( News ): 119</LI>
<LI>POP3 ( Incomming Mail ): 110</LI>
<LI>SMTP ( Outgoing Mail ): 25</LI>
<LI>IRC: 6667</LI>
<LI>HTTP: 80 Not very usefull; Just use a HTTP Proxy.</LI>
<LI>Telnet: 23 Make sure your local port does not conflict with telnetd if you have enabled telnet access to your machine.</LI>
<LI>FTP: 21 This can be a problem. FTP opens a seperate TCP connection to transfer data. You will also have to setup a proxy for the data connection. Make sure the local port does not conflict with ftpd if you have enabled ftp access to your machine.</LI>
<H4><A NAME="ProxyProxy"></A>Proxy Proxy?</H4>
<P>Why would anyone want to create a proxy connection to a proxy server? Your ISP probably runs a proxy server. This proxy server usually services a large number of customers and caches recently accessed files. This can speed up resource access and conserve Internet bandwidth. Your ISPs proxy server probably also supports FTP, which HTTP Proxy does not natively support yet. This means you can dynamically access ftp sites from your web browser. Unfortunately NetPositive does not properly implement FTP proxy access, but you will be able to use Netscape and IE to ftp files.</P>

</UL>

<H3><A NAME="NetPositive"></A>How to Configure NetPositive</H3>
<UL>
	<LI>Start NetPositive.</LI>
	<LI>Select "Preferences..." from "Options menu."</LI>
	<LI>Check "Enable Proxies."</LI>
	<LI>Set "HTTP:" to the IP address of proxy server as seen from the local network.</LI>
	<LI>Set "Port:" to 8080<\LI>
	<LI>Close Preferences and surf!</LI>
</UL>

<H3><A NAME="Netscape"></A>How to Configure Netscape</H3>
<UL>
	<LI>Start Netscape.</LI>
	<LI>Netscape 3.x: Select "Network Preferences..." from the "Options" menu.</LI>
	<UL>
		<LI>Click on the "Proxies" tab.</LI>
	</UL>
	<LI>Netscape 4.x: Select "Preferences..." from the "Edit" menu.</LI>
	<UL>
		<LI>Click the "Advanced" arrow ( plus under Windows ).</LI>
		<LI>Select "Proxies."</LI>
	</UL>
	<LI>Select "Manual Proxy Configuration."</LI>
	<LI>Click the "View..." button.</LI>
	<LI>Set "HTTP Proxy:" to the IP address of proxy server as seen from the local network.</LI>
	<LI>Set "Port:" to 8080<\LI>
	<LI>Close Preferences and surf!</LI>
</UL>

<H3><A NAME="IE"></A>How to Configure Internet Explorer</H3>
<UL>
	<LI>Start Internet Explorer.</LI>
	<LI>Select "Internet Options..." from the "View" menu.</LI>
	<LI>Click the "Connection" tab.</LI>
	<LI>Check the "Access the Internet using a proxy server" box in the "Proxy Server" group.</LI>
	<LI>Optional: Check the "Bypass proxy server for local addresses" box in the "Proxy Server" group.</LI>
	<LI>Click the "Advanced..." button in the "Proxy Server" group.</LI>
	<LI>Set "HTTP Proxy:" to the IP address of the proxy server as seen from the local network.</LI>
	<LI>Set "Port:" to 8080<\LI>
	<LI>Close Preferences and surf!</LI>
</UL>

<H3><A NAME="Other"></A>Other Software</H3>
<UL>
<H4>What about other web browsers?</H4>
<P>Other web browsers should work, but you will have to figure out how to configure them. You need to know the IP address of the proxy server and the port number (8080).</P>
<H4><A NAME="RealAudio"></A>Real Audio Setup</H4>
<UL>
	<LI>Launch "RealPlayer."</LI>
	<LI>Select "Preferences..." from the "View" menu.</LI>
	<LI>Click the "Transport" tab.</LI>
	<LI>Click the "Use specified transports" radio-button.</LI>
	<LI>Click the "Specify transports..." button.</LI>
	<LI>Click the "Use HTTP Only" radio-button and press the "OK" button.</LI>
	<LI>Click the "Proxy" tab.</LI>
	<LI>Check the "Use Proxy" box.</LI>
	<LI>Set "Http Proxy:" to the IP address of the proxy server as seen from the local network.</LI>
	<LI>Set "Port:" to 8080<\LI>
	<LI>Click the "OK" button and your done.</LI>
	<LI>Note: This only works with RealPlayer 5.0 and the remote RealAudio server has to be configured for http access for this to work.</LI>
</UL>
<H4><A NAME="NetShow"></A>Microsoft Media Player / NetShow</H4>
<UL>
	<LI>Start "Media Player."</LI>
	<LI>Select "Options..." from the "View" menu.</LI>
	<LI>Click the "Advanced" tab.</LI>
	<LI>Select "Streaming Media (NetShow)"</LI>
	<LI>Click the "Change..." button.</LI>
	<LI>Make sure the "HTTP" protocol is the only one enabled.</LI>
	<LI>Under "HTTP", click the "Use proxy" radio-button.</LI>
	<LI>Set the proxy IP address and port to the address and port of your proxy server</LI>
</UL>
<H4><A NAME="OtherServices"></A>Mail, News, Proxy Proxy, and Other TCP Services.</H4>
<UL>
	<LI><A HREF="#Configure">Configure HTTP Proxy for other services.</A></LI>
	<LI>Set the client software to connect to the proxy server. It will not know that it's not directly connected to the remote server.</LI>
</UL>
</UL>

<H3><A NAME="Notes"></A>Notes</H3>
<UL>
<LI>HTTP Proxy does not cache any of the resources that it transfers. It relies on the web browser to handle caching. You can use a <A HREF="#ProxyProxy">Proxy Proxy</A> if you wish to access a caching proxy server.</LI>
<LI>The proxy services are not secure. If someone knows the address of your server, they can access it ( with the exception of the Admin Server, which is password protected ). This means other people could possible use it to gain access to http servers within your intranet.</LI>
<LI>HTTP Proxy will survive a network restart. When this occurs, it automatically restarts proxy services</LI>
<LI>FTP Proxy support is not implemented yet. You can use a <A HREF="#ProxyProxy">Proxy Proxy</A> for ftp services if your ISP runs a FTP proxy server. NetPositive does not properly implement FTP proxy access yet, so this would only be of benefit to Netscape or IE at this time.
</UL>
<H4><A NAME="Startup"></A>How do I make it startup automatically when the computer boots?</H4>
<P>Modify your UserBootScript ( located in home/config/boot/ ) to include "path/httpproxy &" where path is where httpproxy is located. For example, if httpproxy was in the apps folder, you would add "/boot/apps/httpproxy &" to UserBootScript.
</P>

<H3><A NAME="Copyright"></A>Copyright Status</H3>
<P>HTTP Proxy 1.0b is Copyright &copy; 1998, Joe Kloss
</P>
<PRE>
Ownership of Software
&nbsp;
Title, ownership rights, and intellectual property rights in and to the 
Software belong to Joe Kloss. The Software is protected by the copyright laws 
of the United States and international copyright treaties.  Title, ownership 
rights, and intellectual property rights in and to the content accessed 
through the Software is the property of the applicable content owner and 
may be protected by applicable copyright or other law. This License gives 
you no rights to such content.
&nbsp;

Copy Restrictions
&nbsp;
This software may be distributed freely with the following provisions.
&nbsp;
- All documentation must be distributed with the Software.
&nbsp;
- You may not distribute modified versions of this Software or documentation 
without the written permission of Joe Kloss.
&nbsp;
</PRE>

<H3><A NAME="Legal"></A>Disclaimer</H3>
<PRE>DISCLAIMER OF WARRANTY

The Software is provided on an "AS IS" basis, without warranty of any 
kind, including without limitation the warranties of merchantability, 
fitness for a particular purpose and non-infringement. The entire risk 
as to the quality and performance of the Software is borne by you. 
SOME STATES DO NOT ALLOW EXCLUSIONS OF AN IMPLIED WARRANTY, 
SO THIS DISCLAIMER MAY NOT APPLY TO YOU AND YOU MAY HAVE OTHER LEGAL 
RIGHTS THAT VARY FROM STATE TO STATE OR BY JURISDICTION.

LIMITATION OF LIABILITY

IN NO EVENT WILL JOE KLOSS BE LIABLE FOR ANY DIRECT, CONSEQUENTIAL OR 
INCIDENTAL DAMAGES ( INCLUDING, BUT NOT LIMITED TO DAMAGES FOR LOSS OF 
BUSINESS PROFITS, LOSS OF INFORMATION, COMPUTER FAILURE OR MALFUNCTION, 
OR USE ), EVEN IF JOE KLOSS HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH 
DAMAGES. SOME STATES DO NOT ALLOW THE EXCLUSION OR LIMITATION OF LIABILITY 
FOR CONSEQUENTIAL OR INCIDENTAL DAMAGES, SO THE ABOVE LIMITATION OR EXCLUSION 
MAY NOT APPLY TO YOU.
</PRE>

<P>All product names mentioned are trademarks or registered trademarks of their respective holders. Mention of these products is for informational purposes and constitutes neither an endorsement nor a recommendation. Joe Kloss assumes no responsibility with regard to the selection, performance, or use of these products.</P>
<HR>
<P ALIGN=CENTER><A NAME="Contact"></A><A HREF="http://www.deltanet.com/users/axly/">http://www.deltanet.com/users/axly/</A><BR><BR>

Joe Kloss<BR>

13700 Alton Parkway, Ste. 154<BR>

Irvine, CA 92718<BR>

<A HREF="mailto:KlossSoft@kagi.com">KlossSoft@kagi.com</A></P>
</BODY>
</HTML>

