# Endpoint Agent Proxy Configuration for Scheduled Tests

{% hint style="warning" %}
Due to recent platform-wide naming, navigation, and URL changes in the ThousandEyes product, you may notice some discrepancies between the product and the screenshots displayed in our technical documentation. The instructions and actual pages in the product are still valid and haven’t changed. Please bear with us as we update our screenshots to better match the in-product experience. See the full scope of changes on [Naming and Navigation Menu changes - Summary List](https://docs.thousandeyes.com/whats-new/naming-and-nav-phase-2-changes).
{% endhint %}

In addition to user-triggered data collection, Endpoint Agents can also execute scheduled tests. These tests can be configured to use custom proxy settings.\
For more information about how proxies operate and how proxy settings can be configured, head over to the [proxy configuration guide for Enterprise Agents](https://docs.thousandeyes.com/product-documentation/global-vantage-points/enterprise-agents/proxy/configuring-an-enterprise-agent-to-use-a-proxy-server) and consult the Introduction section.

## Adding an Endpoint Agent Proxy Configuration

Endpoint Agent's proxy settings can be configured in the ThousandEyes UI at **Endpoint Experience > Agent Settings > Proxy Settings**, where all existing proxy configurations are listed as below:

![](https://1112912342-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M4QARF6s57qxMrOHDTZ%2Fuploads%2Fgit-blob-f1e0b9bdd7c63bc1d52c8a81ec233b623f398742%2Fproduct-documentation_endpoint-agent_endpoint-agent-proxy-configuration-for-scheduled-tests-1.png?alt=media\&token=862242d2-c421-4f19-88ad-fb44d8fdb403)

These proxy settings apply only to Endpoint Agent scheduled tests and do not impact agents' connection to ThousandEyes services.

Click the **Add New Proxy Config** button here to add a new proxy setting. Endpoint Agents can also be optionally configured to use **Basic** or **NTLM** **Authentication Type** when connecting to a proxy server. If not using authentication select **None**.

Below are the two types of proxy an Endpoint Agent can be configured to use:

### Static

Configuring an Endpoint Agent to use a proxy server statically. For routing traffic to the destination directly skipping proxy, add them to **Bypass List.**

Here is an example of a completed static proxy configuration with Basic Authentication to route packets through the proxy server at 1.1.1.1:2233 as configured in **Host** and **Port** fields.

Traffic to 3.3.3.3 is set to skip proxy as per the **Bypass List**.

![](https://1112912342-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M4QARF6s57qxMrOHDTZ%2Fuploads%2Fgit-blob-71061c9a682fbad723a2037ddb10b0398ad6a3e2%2Fproduct-documentation_endpoint-agent_endpoint-agent-proxy-configuration-for-scheduled-tests-2.png?alt=media\&token=0ffa3d9a-6933-4db8-a89a-34b9b1d3861f)

**Host** and **Port** are required fields. If not using an authentication select **None** in **Authentication Type.** **Endpoint Agents** and **Bypass List** are optional fields and can also be configured later in the UI at **Endpoint Experience > Agent Settings > Proxy Settings**.

### PAC

Configure the Endpoint Agent to fetch a [Proxy auto-config](https://en.wikipedia.org/wiki/Proxy_auto-config) file from **PAC File URL** and accordingly choose a proxy server.

Here is a completed configuration of Endpoint Agent PAC proxy configuration with NTLM authentication to fetch a PAC File from http://www.internet.com/proxy.pac:

![](https://1112912342-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M4QARF6s57qxMrOHDTZ%2Fuploads%2Fgit-blob-5ac9038d2c75e8d44bd7e2c00aacf05392489646%2Fproduct-documentation_endpoint-agent_endpoint-agent-proxy-configuration-for-scheduled-tests-3.png?alt=media\&token=82f3b056-ddc3-43b9-a953-44f65d90d0bb)

Endpoint Agent will fetch the proxy PAC File from URL configured in **PAC File URL** field on every request.

### Additional Management Options

Additional management options are available in the UI on the **Endpoint Experience > Agent Settings > Proxy Settings** section

![](https://1112912342-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M4QARF6s57qxMrOHDTZ%2Fuploads%2Fgit-blob-4335428a775641f4d035ad8068f98848d052eeaa%2Fproduct-documentation_endpoint-agent_endpoint-agent-proxy-configuration-for-scheduled-tests-4.png?alt=media\&token=62642ddd-eed4-4ca9-9c80-5dac91d9f258)

1. The current configuration will be displayed on selecting a proxy configuration, changes can be made to an existing proxy configuration from here.
2. Clicking the options(![](https://1112912342-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M4QARF6s57qxMrOHDTZ%2Fuploads%2Fgit-blob-b9669536ab628c3dc5c968664386c2d502037ecb%2Fproduct-documentation_endpoint-agent_configuring-endpoint-agent-setup-6.png?alt=media\&token=d37b6660-86de-4190-bf80-d432a670f6ef)) button will reveal controls to **Duplicate** or **Delete** configured proxy settings.

## Applying Proxy Settings to an Endpoint Scheduled Test

Proxy settings created by the above process can also be applied to existing scheduled tests (HTTP Server only) from the ThousandEyes UI at **Endpoint Experience > Test Settings**. Test-based proxy configuration receives precedence over an in-app proxy configuration of Endpoint Agent, which in turn is given precedence over the proxy configuration of Endpoint Agent host. By default, a test would use the Endpoint Agent's proxy configuration with the **System Proxy** setting. The below screenshot explains how:

![](https://1112912342-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M4QARF6s57qxMrOHDTZ%2Fuploads%2Fgit-blob-5973fc56729b39ce013b8458b3bf80500199b4c1%2Fproduct-documentation_endpoint-agent_endpoint-agent-proxy-configuration-for-scheduled-tests-6.png?alt=media\&token=f04e575a-eccd-4ddd-9821-c0f54b5b1345)
