# tSetProxy

Sets the relevant information for proxy setup.

## tSetProxy Standard properties

These properties are used to configure tSetProxy running in the Standard Job framework.

The Standard tSetProxy component belongs to the Internet family.

The component in this framework is available in all Talend products.

Information noteWarning: tSetProxy should not to be used in ESB cases because it has an impact across the whole ESB Runtime.

To set ESB Runtime HTTP(S) proxy, you only need to add the matching -Djvm parameters for proxyHost, proxyPort, proxyUser and proxyUsername for both http. and https. in the wrapper.conf file of Runtime and restart it. This also limits to only one HTTP proxy per ESB runtime.

Alternatively, you can set proxy at the Runtime level by adding proxy properties in the &lt;Runtime-home&gt;\etc\system.properties file, and then restart Runtime. For example:

```
http.proxyHost=proxyhttpcentral.monoprix.lan
http.proxyPort=8081
http.nonProxyHosts=localhost|.monoprix.lan|.local|127.0.0.1|10.0.0.0/8|172.16.0.0/12|192.168.0.0/16"
```

## Basic settings

| Properties | Description |
| --- | --- |
| Use Java Virtual Machine Proxy<br>Configuration | Select this option to use the following<br>proxy configuration for all the network accesses from the JVM.<br><br>If this option is cleared, the proxy configuration is used only<br>when the JVM accesses the URIs specified in URIs to<br>use proxy.<br><br>This option is selected by default. |
| Proxy type | List of proxy protocols. Four options<br>are available: Http Proxy, Https Proxy, Socks<br>Proxy, and FTP Proxy.<br><br>Information noteNote:<br>FTP Proxy is not available if Use Java Virtual Machine Proxy Configuration is<br>cleared. |
| Proxy<br>host | Address of the proxy server. |
| Proxy<br>port | Number of the proxy port. |
| Use authentication | Select this option if authentication is enabled on the Https proxy<br>server.<br><br>Information noteNote: This option is available when Https Proxy is selected<br>from Proxy type drop-down list. |
| Proxy<br>user | Username for proxy authentication. |
| Proxy<br>password | Password for proxy authentication.<br><br>To enter the password, click the [...] button<br>next to the password field, enter the password in double quotes in the pop-up dialog box,<br>and click OK to save the settings. |
| URIs to use<br>proxy | Specify the URIs for which the proxy is used by providing<br>the corresponding host names/host addresses and port numbers in the table.<br><br>Information noteNote:<br><br><ul> <li>This table is available if <span>Use Java Virtual Machine Proxy Configuration</span> is                           cleared.</li> <li>For the <span>Port</span>                           column, a value of <kbd>-1</kbd> specifies                           to use the proxy when the JVM accesses any ports of the host.</li> </ul> |
| No Proxy<br>for | The hosts which should be connected to<br>directly and not through the proxy server. The value can be a list of hosts,<br>each separated by a \|, and in addition a wildcard character (\*) can be used for<br>matching, e.g. "192.168.0.\* \| localhost".<br><br>This option is<br>available when you select HTTP Proxy or<br>FTP Proxy from the Proxy type drop-down list. |

## Advanced settings

| Properties | Description |
| --- | --- |
| Thread isolated<br>proxy | Select this option to make the proxy available only to the<br>thread that invokes the tSetProxy component. |
| tStatCatcher<br>Statistics | Select this check box to gather the Job processing metadata<br>at a Job level as well as at each component level. |
| Enable Basic Authentication<br>Header | Select this option to pass the username and password<br>provided in the Basic settings view to a<br>basic authentication-enabled https proxy server through the http authentication<br>request header.<br><br>Because the authentication information<br>may get revealed, select this option when the https proxy server is in a<br>trusted environment.<br><br>This option is available when you select Https Proxy from the Proxy type drop-down list and select Use authentication in the Basic<br>settings view.<br><br>Information noteWarning: Enabling this option will set the system property jdk.http.auth.tunneling.disabledSchemes to<br>empty. |

## Global Variables

| Variables | Description |
| --- | --- |
| Global Variables | ERROR\_MESSAGE: the error message generated by the<br>component when an error occurs. This is an After variable and it returns a string. This<br>variable functions only if the Die on error checkbox is<br>cleared, if the component has this checkbox.<br><br>A Flow variable functions during the execution of a component<br>while an After variable functions after the execution of the component.<br><br>To fill up a field or expression with a variable, press Ctrl+Space to access the variable list and choose the variable to use from<br>it.<br><br>For more information about variables, see [Using contexts and variables](https://help.qlik.com/talend/r/en-US/8.0/studio-user-guide/contexts-and-variables). |

## Usage

| Usage guidance | Description |
| --- | --- |
| **Usage rule** | Typically used as a subJob by itself,<br>tSetProxy is deployed<br>along with other Internet components. |