<?xml version="1.0" ?>
<!DOCTYPE article PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN"
"dtd/kdex.dtd" [
<!ENTITY socks-kcontrol SYSTEM "socks.docbook">
<!ENTITY % addindex "IGNORE">
<!ENTITY % British-English "INCLUDE"
> <!-- change language only here -->
]>

<article lang="&language;">
<articleinfo>


<authorgroup>
<author
>&Krishna.Tateneni; &Krishna.Tateneni.mail;</author>
<othercredit role="translator"
><firstname
>Jonathan</firstname
><surname
>Riddell</surname
><affiliation
><address
><email
>kde-en-gb@jriddell.org</email
></address
></affiliation
><contrib
>Conversion to British English</contrib
></othercredit
> 
</authorgroup>

<date
>2002-02-11</date>
<releaseinfo
>3.00.00</releaseinfo>

<keywordset>
<keyword
>KDE</keyword>
<keyword
>KControl</keyword>
<keyword
>proxy</keyword>
<keyword
>proxies</keyword>
</keywordset>

</articleinfo>
<sect1 id="proxies">
<title
>Proxies</title>

<sect2 id="proxies-intro">

<title
>Introduction</title>

<para
>Proxies are programs running on a computer that acts a server on the network you are connected to (whether by modem or other means). These programs receive &HTTP; and &FTP; requests, retrieve the relevant files from the internet, and pass them on to the client computer that made the requests.</para>

<para
>When you have configured a proxy, &HTTP; and/or &FTP; requests are re-routed through the computer that is acting as a proxy server. However, you can also select specific hosts which should be contacted directly, rather than through the proxy server. If you are on a local network, for example, access to local hosts probably doesn't need to go through a proxy server.</para>

<para
>You should only need to configure a proxy server if your network administrator requires it (if you are a dial-up user, that would be your internet service provider or <acronym
>ISP</acronym
>). Otherwise, especially if you are feeling a bit confused about this proxy business, but everything seems to be fine with your internet connection, you don't need to change anything.</para>

</sect2>

<sect2 id="proxies-use">

<title
>Use</title>

<para
>The first option on the page is a checkbox labelled <guilabel
>Use proxy</guilabel
>.</para>

<para
>Check this box to enable the use of proxy servers for your internet connection.</para>

<para
>Please note that using proxy servers is optional, but has the benefit or advantage of giving you faster access to data on the internet.</para>

<para
>If you are uncertain whether or not you need to use a proxy server to connect to the internet, please consult with your internet service provider's setup guide or your system administrator.</para>

<para
>If you have selected to use a proxy, you have several methods to configure the settings for it.</para>

<variablelist>
<varlistentry>
<term
><guilabel
>Automatically detected script file</guilabel
></term>
<listitem>

<para
>Select this option if you want the proxy setup configuration script file to be automatically detected and downloaded.</para>
<para
>This option only differs from the next choice in that it <emphasis
>does not</emphasis
> require you to supply the location of the configuration script file. Instead, it will be automatically downloaded using <quote
>Web Access Protocol Discovery</quote
> (<acronym
>WAPD</acronym
>).</para>

<note
><para
>If you have a problem using this setup, please consult the <acronym
>FAQ</acronym
> section at <ulink url="http://www.konqueror.org"
>http://www.konqueror.org</ulink
> for more information.</para
></note>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Specified script file</guilabel
></term>
<listitem>
<para
>Select this option if your proxy support is provided through a script file located at a specific address. You can then enter the address in the location text box, or use the <guiicon
>folder</guiicon
> icon to browse to it.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Preset environment variables</guilabel
></term>
<listitem>
<para
>Some systems are setup with $<envar
>HTTP_PROXY</envar
> to allow graphical as well as non-graphical applications to share the same proxy configuration information.</para>
<para
>If you know this applies to you, select this option and click on the <guibutton
>Setup...</guibutton
> button to provide the environment variable names used to set the address of the proxy server(s).</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Manually specified settings</guilabel
></term>
<listitem>
<para
>Select this option, and click on the <guibutton
>Setup...</guibutton
> to manually setup the location of the proxy servers to be used.</para>

<para
>If you choose this option, another dialogue will pop up.</para>

<para
>The complete addressing information for the proxy includes both the internet address and a port number. You should enter these into the relevant text boxes. The <guiicon
>arrow</guiicon
> button copies the information from the <guilabel
>HTTP</guilabel
> line to the <guilabel
>FTP</guilabel
> line, in order to help save some typing.</para>

<para
>If there are hosts which you can connect to without going through the proxy server, you can press <guibutton
>Add</guibutton
> to add the names of these hosts, separated by in the text box labelled <guilabel
>No Proxy For:</guilabel
>. For example, hosts that are on your local network can probably be contacted directly.</para>

<para
>You can also choose <guilabel
>Only use proxy for entries in this list</guilabel
>.</para>

<para
>Check this box to reverse the use of the exception list, &ie; the proxy servers will only be used when the requested &URL; matches one of the addresses listed here.</para>

<para
>This features is useful if all you need is a proxy to access a few specific sites, for example, an internal intranet. If you have more complex requirements you might want to use a configuration script.</para>
</listitem>
</varlistentry>
</variablelist>

</sect2>

<sect2 id="authorization">
<title
><guilabel
>Authorisation</guilabel
></title>

<para
>Here you can choose between two types of authentication, if your proxy requires it. You can have <guilabel
>Prompt as needed</guilabel
>, the default, in which case &konqueror; will only ask for a username or password if it needs to.</para>

<para
>The other option is <guilabel
>Use automatic login</guilabel
>. Select this option if you have already set up a login entry for your proxy server in the <filename
>$<envar
>KDEDIR</envar
>/share/config/kionetrc</filename
> file.</para>

</sect2>
&socks-kcontrol; </sect1>

</article>