1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
|
<?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>
|
