StreamingProxy ReadMe

> ## Streaming Proxy ReadMe

> The Darwin Streaming Proxy is an application-specific proxy which would normally be run in a border zone or perimeter network. It is used to give client machines within a protected network access to streaming servers outside that network, in the case when the firewall blocks RTSP connections or RTP/UDP data flow. The firewall perimeter network is usually configured to allow:

> - RTSP connections from within the network, as long as the destination is the proxy
> - RTSP connections to outside the network, as long as the source is the proxy
> - RTP datagrams to and from the proxy to the inner network
> - RTP datagrams to and from the proxy to the outside

> The proxy usually sits within the perimeter network, between an 'inner skin' and 'outer skin', which have different configurations, of course, to allow the flows above.

> Note that RTSP runs over TCP; the normal connection port is 554 (but see below). Note that if the URL supplied by the client to the proxy includes a port number, then the proxy will attempt to connect to the server using that port number rather than the default 554.

> RTP runs over UDP, and a range of ports may be used. Client-side ports are usually in a restricted range (starting at 6970), but servers cannot so easily restrict what ports they use. For safety, do not restrict port number access to the proxy; use only the IP address.

> Note that this proxy handles standard RTSP controlling standard RTP; RTSP can be used to control other media protocols, and is used by a number of companies to control proprietary media protocols. This proxy does not attempt to proxy those other protocols. For more information on these protocols, consult the Internet Engineering Task Force documentation:

> - RTSP <http://info.internet.isi.edu:80/in-notes/rfc/files/rfc2326.txt>
> - RTP <http://info.internet.isi.edu:80/in-notes/rfc/files/rfc1889.txt>

> ### License

> The Darwin Streaming Server and Streaming Proxy is distributed under the terms of the Apple Public Source License. For more information, refer to the license terms at www.publicsource.apple.com. Note that the Apple Public Source License does not allow you to use the terms "QuickTime" or "QuickTime Streaming Server" in descriptions of products developed using Darwin Streaming Server or Streaming Proxy open source code, nor use any Apple trademarks or logos associated with QuickTime and QuickTime Streaming Server.

> ### How To Use

> The application must reside on a machine that can see both the Internet, and your internal network. This would be your Bastion Host, or another machine in your Perimeter Network.

> 1. Install the Streaming Proxy in a reasonable place on your machine (For example, /usr/local/sbin ).
> 2. Edit the streamingproxy.conf file put place it in the /etc/streaming/ directory.
> 3. Launch the StreamingProxy application (ie. `#/usr/local/sbin/StreamingProxy -c /etc/streaming/streamingproxy.conf`)
> 4. Launch the StreamingProxy application using the -h command line option for a description of the other command line options.
> 5. NOTE: You must run as root to enable the default port 554 for reception.

> ### Configuring Client Machines

> 1. Open the QuickTime (Win32) or QuickTime Settings (Mac) control panel.
> 2. Select Streaming Proxy from the popup menu and then select the RTSP Proxy Server checkbox.
> 3. Type in the ip address or domain name of your proxy server in the Name: field, and the port you configured in the streamingproxy.conf file (or 554 as a default).

> ### How It Works

> The Streaming Proxy listens on ports you specify for a RTSP command sequence. It parses the commands and redirects the command to the desired server. It also rewrites the RTSP commands to reflect the new set of port numbers that the proxy must use.

> The Streaming Proxy will only relay data that comes from a server that the data was requested from.

> #### Credits

> This proxy includes software developed by the University of California, Berkeley and its contributors; that included software is the regular expression code developed by Henry Spencer.

> © 1999, 2000 2001 Apple Computer, Inc. All rights reserved. Apple, the Apple logo, Mac, Macintosh, PowerBook, Power Macintosh, and QuickTime are trademarks of Apple Computer, Inc., registered in the United States and other countries. iBook, iMac, and Power Mac are trademarks of Apple Computer, Inc. All other product names are trademarks or registered trademarks of their respective holders.