WinProxy Configuration
This web page provides on-line documentation for WinProxy configuration. Please refer to the WinProxy User's Manual for more detailed information.
Configuration for WinProxy is provided as web pages accessed through your browser. To change configuration options, select the desired area from the menu on the left. Set the desired values in the right hand pane, then press the Save button. If an incorrect value has been entered, this will be changed to the closest correct value, so check the data after saving.
For the changes to have immediate effect, select the restart button from the left hand pane. If restart is not used, the changed options will not take effect until the next time WinProxy is run. After a restart, check the error logs from the main administration menu for possible problems. If there are no error messages recorded then WinProxy is operating correctly.
The configuration forms are best viewed with a screen resolution of 800 x 600 or better.
Proxy Port
This is the port number on which WinProxy listens for requests.
The default value is 3128. Use this number in the proxy setting
within the browser, along with the WinProxy computer name or IP
address.
Enable Logging
When enabled, WinProxy writes a log entry about
each http-proxy request into the proxy-http.log file.
Cache Directory
The disk cache location.
Cache Enabled
With the cache enabled, most recently
used web pages and file transfers are stored locally and are used
to follow repeated requests far more quickly than an Internet
transfer.
Cache Size
The maximum size of the cache, in Megabytes.
Continue Aborted
When the user breaks a connection by
using the browser stop button or by selecting a new page before the
current page has been completely loaded, WinProxy can continue
loading the page into the cache. Then if the user returns to this
page it can be presented quickly from the cache. With this option
enabled, it is easy to build up a large number of connections
while skipping between pages.
Keep Aborted
When enabled, WinProxy will store
incomplete objects (pages).
Cache Ftp directory only
For FTP transfers only directory listings will be
cached.
Max. HTTP Size
Maximum size of objects downloaded
through http (web) protocol. Objects larger than this limit will
not be cached.
Max. FTP Size
Maximum size of objects downloaded through ftp (file transfer)
protocol. Objects larger than this limit will not be cached.
Max. GOPHER Size
Maximum size of objects downloaded through gopher protocol.
Objects larger than this limit will not be cached.
HTTP Time-To-Live
This value determines the number of
days that HTTP objects (web pages) are kept in the cache. Any requests
for objects in the cache older than this are reloaded from the
Internet.
FTP Time-To-Live
This value determines the number of
days that FTP objects (file transfers) are kept in the cache. Any requests
for objects in the cache older than this are reloaded from the
Internet.
GOPHER Time-To-Live
This value determines the number of
days that GOPHER objects are kept in the cache. Any requests for objects
in the cache older than this are reloaded from the Internet.
You can set the number of days any object is kept in the cache
based on the object's URL. URLs can be added or removed with the
respective buttons. Each entry is of the form days@url, where url
can include asterisks to specify a group or related URLs.
Examples :
12@*www* sets a cache life of 12 days for all objects with
a URL containing www.
2@ftp://*.zip sets a cache life of 2 days for all objects
downloaded via FTP and terminated with .zip
Telnet Gateway
If you intend to use Telnet with the
Internet, this option must be enabled.
Ftp Gateway
Enable this feature to provide ftp gateway services. The Ftp
gateway looks like username@host[:port].
RealAudio Gateway
Enable this feature to provide RealAudio gateway (proxy) service.
Port
Appropriate port number.
DNS server
This is the IP address of the DNS server, if one is
available. With this value set, WinProxy will appear as a DNS
server to connected local computers, while forwarding DNS
requests to the DNS server specified here. This option is
effective in conjunction with SOCKS4 server.
News server
This is the name or IP address of the Internet News server. With
this value set, WinProxy will appear as the News server to local
computers while forwarding News requests to the server specified
here. This name is usually provided by your ISP.
SOCKS Server
When enabled, WinProxy behaves as a SOCKS server.
SOCKS Port
This is the port number of the SOCKS server. The default value is
1080.
Use SOCKS5 Authentication
When enabled, WinProxy require user's authentication
with access control. The access is controlled by the Access List.
Mapped Links direct connections on a particular port
to a selected computer/port. It allows (in some cases) to cross proxy with not directly supported
protocols. For example you can add IRC support by adding following link :
TCP 6667 my.irc.server:6667.
Connection Name Username Password Hang up After
The name used for the Internet connection. It is usually the name created
in the dial-up networking (RAS) phone book for your ISP.
This is the user name provided by your ISP when you arranged your Internet
connection.
This is the password you provided to your ISP when you arranged
your Internet connection.
If no traffic occurs on the line after this period of time the
connection will automatically be closed. If you are paying an
hourly rate for Internet connection, set this value to 5 or 10
minutes.
Demand dial can be used to establish Internet connection automatically when
a user tries to access a resource located on the Internet.
This can for example happen, when a user tries to access a web page.
You can precisely specify the time when demand dial is enabled.
User List
A list of WinProxy users. The password
field is optional and can be left blank. Users can change their
passwords once logged on to WinPoxy.
WinProxy supports up to 900
users.
Group List
WinProxy users can be organized into groups. Add and remove these groups
here. WinProxy has a built-in group called Admins which
cannot be deleted. Users belonging to the Admins group
have no access restrictions.
WinProxy supports up to 100 groups.
WinProxy can handle e-mail traffic
in two different ways.
Choose one that suites your
requirements. The simplest one is SMTP/POP3 Gateway.
None
E-mail traffic will not be handled.
SMTP/POP3
Gateway
WinProxy will forward SMTP/POP3
requests to specified SMTP and POP3 servers.
Mail Server
Users will send and receive e-mail via
SMTP/POP3 server running on WinProxy. Further WinProxy will download
their Internet e-mail from specified POP3 servers and send
outgoing e-mails to the Internet.. Sending/receiving will take
place in specified intervals.
Moreover, received e-mails can be sorted according to To:
e-mail header.
Remote SMTP
Server
The Internet SMTP server. The outgoing
e-mails will be forwarded to this server.
Remote POP3
Server
The Internet POP3 server. By default
this server will be used to forward POP3 requests. If you need to
use different server, set username and server delimited by
"#" charecter in POP3 username field in you mail client configuration.
Examples: user#popserver.domain.net
Eudora is a special case, you would set it's POP account as
follows: user#popserver.domain.net@proxy_host
Mail Directory
The path name of the folder (or
directory) that contains users' mail-boxes and temporary mail
files.
Remote SMTP
Server
The outgoing e-mails will be sent to
this server.
Send/Receive
Mail
E-mail is sent and received from the
Internet in specified intervals. If you choose every,
e-mail will be processed each time the time value elapse. Time is
of the form hh:mm, hh for hours
and mm for minutes.
Examples: 3:45 means every 3 hours and
45 minutes, 00:15 means every 15 minutes.
If you choose at, e-mail will be processed at
specified time. You can provide more values, separated by space.
Examle : 08:00 12:30 14:45 18:00
Allow to Dial
If you turn this option on you will
enable WinProxy to dial-up if it is needed for mail processing.
(To reach remote SMTP and POP3 servers)
Enable Logging
When enabled, WinProxy writes information about Mail Server activity into the mail.log file.
Account List
Contain information about users'
Internet mail boxes, users' e-mail addresses and local WinProxy
mail boxes. Items can be added and removed from the list with the
appropriate buttons.
Remote POP3
Account
Specify remote username and POP3
server. The entry is of the form username@pop.server.
Password
The remote POP3 account password.
E-Mail
User's e-mail address. You can leave it
blank if your e-mail address is the same as your POP3 account.
This value WinProxy uses to distinguish whether an e-mail is for
local user or for remote user in the Internet.
Move to Local
Account
Specify WinProxy mailbox. Received
e-mails will be inserted to this mailbox. If you choose a group,
e-mails will be copied to all users mailboxes in the group. If
you select {RULE}, received e-mails will go through sorting rules
to find out appropriate mailbox. This is useful when e-mail for
whole domain is stored in one mailbox.
Rule List
A list of rules controlling sorting
e-mails to appropriate WinProxy mailboxes according to the e-mail
header To:. Items can be added and removed from the
list with the appropriate buttons.
If Mail header
To: contains
Specify content of e-mail header To:.
If e-mail header contain this string it will be copied to
associated WinProxy mailbox.
Move to
WinProxy Account
Associated WinProxy mailbox.
In the first edit window set IP addresses in your LAN (or whatever IP address you want to grant unlimited
mailing through the mail server), for example if your LAN
uses addresses from range 192.168.1.0 - 192.168.1.255, you would enter:
192.168.1.0/255.255.255.0
In the second window you must enter your (local) domain.
Users, whose IP addresses do not match the IP list, are allowed to send emails only
to local domain.
Access List Access restrictions also apply to the WinProxy
web interface. The host name of the computer running WinProxy is
converted to WinProxy before testing the Access List. To
limit users' access to the WinProxy administration web interface
add the following line to the Access List: Enable Logging Secure Interfaces IP List You can also specify a range IP addresses via a number of bits in the netmask, e.g. :
192.168.1.160/28.
Timeout Connect Retry Internal DNS Resolver Reverse DNS Logs Directory Autoconfig File Parent Proxy Parent Proxy Port
This is a list of URLs restricted to specific users or
groups.Each entry is in the format scheme://host/path. Asterisks
may be used an arbitrary string.
http://WinProxy/admin/*
When enabled, WinProxy writes a log entry into the security.log file about
attempts to access WinProxy from computers not listed in the IP List or
about attempts to access WinProxy via insecure interface.
Use this field to enter the IP
addresses of local network interfaces. Only the requests comming
through these interfaces will be accepted. If this field is left
blank, all computers can use WinProxy.
Usually you set this value to the IP address of network adapter linking
your LAN to WinProxy machine.
A List of IP addresses of computers which are
allowed to access WinProxy. You can enter either a single IP address or a range
of IP addresses. If the IP List is empty than all computers can use WinProxy.
A connection will close when it has
been inactive for this period of time. It is then available for
use by another process or user.
Determinates the number of attempts to establish a connection
When set, WinProxy performs DNS queries
itself instead of asking operating system.
Note: You have to set a DNS server on the page Network first.
When set, permits a reverse conversion
of IP addresses to DNS names allowing the reporting of host names
to the access log.
The directory that contains logs files.
This field is used for WinProxy
configuration in conjunction with Netscape Navigator. The file
must be edited to insert the computer name and port of the
computer running WinProxy. Set the configuration location to
http://<host>:3129/autoconfig where <host> is the
name of the computer running WinProxy.
This is the DNS name or IP address and
port number of a parent proxy, if one exists. When set, all
requests will be forwarded.
The port number of the parent proxy.