runtime/doc/kcontrol/proxy/index.docbook

   1 <?xml version="1.0" ?>
   2 <!DOCTYPE article PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN"
   3 "dtd/kdex.dtd" [
   4 <!ENTITY socks-kcontrol SYSTEM "socks.docbook">
   5 <!ENTITY % addindex "IGNORE">
   6 <!ENTITY % English "INCLUDE" > <!-- change language only here -->
   7 ]>
   8
   9 <article lang="&language;">
  10 <articleinfo>
  11
  12
  13 <authorgroup>
  14 <author>&Krishna.Tateneni; &Krishna.Tateneni.mail;</author>
  15 <!-- TRANS:ROLES_OF_TRANSLATORS -->
  16 </authorgroup>
  17
  18 <date>2002-02-11</date>
  19 <releaseinfo>3.00.00</releaseinfo>
  20
  21 <keywordset>
  22 <keyword>KDE</keyword>
  23 <keyword>KControl</keyword>
  24 <keyword>proxy</keyword>
  25 <keyword>proxies</keyword>
  26 </keywordset>
  27
  28 </articleinfo>
  29 <sect1 id="proxies">
  30 <title>Proxies</title>
  31
  32 <sect2 id="proxies-intro">
  33
  34 <title>Introduction</title>
  35
  36 <para>Proxies are programs running on a computer that acts a server on
  37 the network you are connected to (whether by modem or other
  38 means). These programs receive &HTTP; and &FTP; requests, retrieve the
  39 relevant files from the internet, and pass them on to the client
  40 computer that made the requests.</para>
  41
  42 <para>When you have configured a proxy, &HTTP; and/or &FTP; requests
  43 are re-routed through the computer that is acting as a proxy server.
  44 However, you can also select specific hosts which should be contacted
  45 directly, rather than through the proxy server. If you are on a local
  46 network, for example, access to local hosts probably doesn't need to
  47 go through a proxy server.</para>
  48
  49 <para>You should only need to configure a proxy server if your network
  50 administrator requires it (if you are a dial-up user, that would be
  51 your internet service provider or <acronym>ISP</acronym>). Otherwise,
  52 especially if you are feeling a bit confused about this proxy
  53 business, but everything seems to be fine with your internet
  54 connection, you don't need to change anything.</para>
  55
  56 <para>Please note that using proxy servers is optional, but has the
  57 benefit or advantage of giving you faster access to data on the
  58 internet.</para>
  59
  60 <para>If you are uncertain whether or not you need to use a proxy
  61 server to connect to the internet, please consult with your internet
  62 service provider's setup guide or your system administrator.</para>
  63
  64 </sect2>
  65
  66 <sect2 id="proxies-use">
  67
  68 <title>Use</title>
  69
  70 <variablelist>
  71 <varlistentry>
  72 <term><guilabel>Connect to the Internet directly</guilabel></term>
  73 <listitem>
  74
  75 <para>Select this option if you do <emphasis>not</emphasis> want to use a proxy server.</para>
  76 </listitem>
  77 </varlistentry>
  78 </variablelist>
  79
  80 <para>If you have decided to use a proxy, you have several methods to
  81 configure the settings for it.</para>
  82
  83 <variablelist>
  84 <varlistentry>
  85 <term><guilabel>Automatically detected script file</guilabel></term>
  86 <listitem>
  87
  88 <para>Select this option if you want the proxy setup configuration
  89 script file to be automatically detected and downloaded.</para>
  90 <para>This option only differs from the next choice in that it
  91 <emphasis>does not</emphasis> require you to supply the location of
  92 the configuration script file. Instead, it will be automatically
  93 downloaded using <quote>Web Access Protocol Discovery</quote>
  94 (<acronym>WAPD</acronym>).</para>
  95
  96 <note><para>If you have a problem using this setup, please consult the
  97 <acronym>FAQ</acronym> section at <ulink
  98 url="http://www.konqueror.org">http://www.konqueror.org</ulink> for
  99 more information.</para></note>
 100 </listitem>
 101 </varlistentry>
 102
 103 <varlistentry>
 104 <term><guilabel>Specified script file</guilabel></term>
 105 <listitem>
 106 <para>Select this option if your proxy support is provided through a
 107 script file located at a specific address.  You can then enter the
 108 address in the location text box, or use the <guiicon>folder</guiicon>
 109 icon to browse to it.</para>
 110 </listitem>
 111 </varlistentry>
 112
 113 <varlistentry>
 114 <term><guilabel>Preset environment variables</guilabel></term>
 115 <listitem>
 116 <para>Some systems are setup with $<envar>HTTP_PROXY</envar> to allow
 117 graphical as well as non-graphical applications to share the same
 118 proxy configuration information.</para>
 119 <para>If you know this applies to you, select this option and click on
 120 the <guibutton>Setup...</guibutton> button to provide the environment
 121 variable names used to set the address of the proxy server(s).</para>
 122 </listitem>
 123 </varlistentry>
 124
 125 <varlistentry>
 126 <term><guilabel>Manually specified settings</guilabel></term>
 127 <listitem>
 128 <para>Select this option, and click on the
 129 <guibutton>Setup...</guibutton> to manually setup the location of the
 130 proxy servers to be used.</para>
 131
 132 <para>If you choose this option, another dialog will pop up.</para>
 133
 134 <para>The complete addressing information for the proxy includes both
 135 the internet address and a port number. You should enter these into
 136 the relevant text boxes. The <guiicon>arrow</guiicon> button copies
 137 the information from the <guilabel>HTTP</guilabel> line to the
 138 <guilabel>FTP</guilabel> line, in order to help save some
 139 typing.</para>
 140
 141 <para>If there are hosts which you can connect to without going
 142 through the proxy server, you can press <guibutton>Add</guibutton> to
 143 add the names of these hosts, separated by in the text box labeled
 144 <guilabel>No Proxy For:</guilabel>. For example, hosts that are on
 145 your local network can probably be contacted directly.</para>
 146
 147 <para>You can also choose <guilabel>Only use proxy for entries in this
 148 list</guilabel>.</para>
 149
 150 <para>Check this box to reverse the use of the exception list, &ie;
 151 the proxy servers will only be used when the requested &URL; matches
 152 one of the addresses listed here.</para>
 153
 154 <para>This features is useful if all you need is a proxy to access a
 155 few specific sites, for example, an internal intranet.  If you have
 156 more complex requirements you might want to use a configuration
 157 script.</para>
 158 </listitem>
 159 </varlistentry>
 160 </variablelist>
 161
 162 </sect2>
 163
 164 <sect2 id="authorization">
 165 <title><guilabel>Authorization</guilabel></title>
 166
 167 <para>Here you can choose between two types of authentication, if your
 168 proxy requires it.  You can have <guilabel>Prompt as
 169 needed</guilabel>, the default, in which case &konqueror; will only
 170 ask for a username or password if it needs to.</para>
 171
 172 <para>The other option is <guilabel>Use automatic login</guilabel>.
 173 Select this option if you have already set up a login entry for your
 174 proxy server in the
 175 <filename>$<envar>KDEDIR</envar>/share/config/kionetrc</filename>
 176 file.</para>
 177
 178 </sect2>
 179
 180 <sect2 id="options">
 181 <title><guilabel>Options</guilabel></title>
 182 <variablelist>
 183 <varlistentry>
 184 <term><guilabel>Use persistent connections to proxy</guilabel></term>
 185 <listitem>
 186 <para>Use persistent connection to your proxy server. Keeps connection to proxy open, helps lower bandwidth/speed up connection. Enabling this option will require the proxy server's cooperation, if the proxy server does not support this, it will bring your internet to a stop. </para>
 187 </listitem>
 188 </varlistentry>
 189 </variablelist>
 190
 191 </sect2>
 192
 193 &socks-kcontrol;
 194
 195 </sect1>
 196
 197 </article>