# <Proxy>

Use the Proxy element to specify access to web content through an HTTP proxy server that either requires no authentication or requires only Basic authentication.

## Full element example

      <Proxy>
        <UseProxy               value="no"/>
        <Address>proxyAddress</Address>
        <Port                   value="8080"/>
        <UserName>Joe</UserName>
        <Password>Joe's Password</Password>
        <UseHTTP10              value="no"/>
      </Proxy>

## Sub-element summary

Tag | Type | Default | Description
--- | --- | --- | ---
`<UseProxy>` | value | no | Whether to use a proxy server
`<Address>` | string | n/a | The proxy server address
`<Port>` | value | 8080 | The proxy server port
`<UserName>` | string | n/a | The user name to use for proxy authentication
`<Password>` | string | n/a | The password to use for proxy authentication
`<UseHTTP10>` | value | no | Whether to use HTTP/1.0

## Sub-element descriptions

### <UseProxy>

Description
Set the value attribute of the tag to `no` to not use a proxy server. Set the attribute to `yes` to use the proxy server whose address and port are specified in the Address and Port elements, respectively.
Examples
This example specifies that a proxy should not be used.

      <UseProxy             value="no"/>

This example specifies that a proxy should be used.

      <UseProxy             value="yes"/>

### <Address>

Description
Set the content of the element to the address of the proxy server to use. Note that you need to set the value attribute of the UseProxy tag to `yes` in order to utilize the proxy server. The address can be an IP address (i.e., 192.168.100.110) or the human-readable name (i.e., proxy.mycompany.com) of the proxy server. Make sure that you enter the address of the server only and do not enter a web address such as http://www.public.proxy.com/proxy.
Examples
This example specifies the address of the proxy server with an IP address.

      <Address>192.168.100.110</Address>

This example specifies the human-readable name of the proxy server.

      <Address>proxy.mycompany.com</Address>

### <Port>

Description
Set the value attribute of the tag to the port number on which the proxy server handles proxy clients. Note that you need to set the value attribute of the UseProxy tag to `yes` in order to utilize the proxy server.
Examples
This example specifies that the proxy server port is 3128.

      <Port                 value="3128"/>

This example specifies that the proxy server port is 8080.

      <Port                 value="8080"/>

### <UserName>
<Password>

Description
If the proxy server requires authentication, set the content of the UserName element to the user name to use for authentication and set the content of the Password element to the associated password. Note that only Basic Authentication is supported.
Examples
This example specifies the user name and password for access to the proxy.

      <UserName>JohnDoe</UserName>
      <Password>LeMoNtReE</Password>

### <UseHTTP10>

Description
Set the value attribute of the tag to `yes` to use HTTP/1.0 to communicate with the proxy. Set the value to `no` to use the default of HTTP/1.1.
Examples
This example specifies that HTTP/1.0 should be used.

      <UseHTTP10            value="yes"/>

This example specifies that the default of HTTP/1.1 should be used.

      <UseHTTP10            value="no"/>

©1999-2017 DC & Co. All rights reserved.