summaryrefslogtreecommitdiffstats
path: root/doc/kcontrol/proxy/index.docbook
blob: ca427e926743db9ab8c9bc507005990313b352aa (plain)
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
<?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 % English "INCLUDE" > <!-- change language only here -->
]>

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


<authorgroup>
<author>&Krishna.Tateneni; &Krishna.Tateneni.mail;</author>
<!-- TRANS:ROLES_OF_TRANSLATORS -->
</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>

<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>

</sect2>

<sect2 id="proxies-use">

<title>Use</title>

<variablelist>
<varlistentry>
<term><guilabel>Connect to the Internet directly</guilabel></term>
<listitem>

<para>Select this option if you do <emphasis>not</emphasis> want to use a proxy server.</para>
</listitem>
</varlistentry>
</variablelist>

<para>If you have decided 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 dialog 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 labeled
<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>Authorization</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>TDEDIR</envar>/share/config/kionetrc</filename>
file.</para>

</sect2>

<sect2 id="options">
<title><guilabel>Options</guilabel></title>
<variablelist>
<varlistentry>
<term><guilabel>Use persistent connections to proxy</guilabel></term>
<listitem>
<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>
</listitem>
</varlistentry>
</variablelist>

</sect2>

&socks-kcontrol;

</sect1>

</article>