## Setproxy Task

### Description

Sets Java's web proxy properties, so that tasks and code run in the same JVM can have through-the-firewall access to remote web sites, and remote FTP sites. You can nominate an HTTP and FTP proxy, or a SOCKS server, reset the server settings, or do nothing at all.

### Parameters

Attribute | Description | Type | Required
--- | --- | --- | ---
nonproxyhosts | A list of hosts to bypass the proxy on. These should be separated with the vertical bar character |. Only in Java 1.4 does FTP use this list. e.g. `fozbot.corp.sun.com|*.eng.sun.com` | String | No
proxyhost | the HTTP/FTP proxy host. Set this to for the HTTP proxy option to be disabled. | String | No
proxypassword | Set the password for the proxy. Used only if the proxyUser is set. | String | No
proxyport | the HTTP/FTP proxy port number | int | No; default is 80
proxyuser | set the proxy user. Probably requires a password to accompany this setting. | String | No; default is
socksproxyhost | The name of a SOCKS server. Set to to turn SOCKS proxying off. | String | No
socksproxyport | Set the ProxyPort for SOCKS connections. | int | No; default is 1080

### Examples

Do nothing

    <setproxy/>

Set the proxy to `firewall:80`

    <setproxy proxyhost="firewall"/>

Set the proxy to `firewall:81`

    <setproxy proxyhost="firewall" proxyport="81"/>

Stop using HTTP proxy; don't change SOCKS settings

    <setproxy proxyhost=""/>

Use SOCKS via `socksy:1080`

    <setproxy socksproxyhost="socksy"/>

Stop using the SOCKS server

    <setproxy socksproxyhost=""/>

You can set a username and password for HTTP with the proxyHost and proxyPassword attributes. On Java 1.4 and above, these can also be used against SOCKS 5 servers.