Proxy Settings

Leverage the Proxy feature for sending requests via your HTTP Proxy server of choice.

Unlike other tools like Postman where you can only have one proxy server for your entire workspace, each folder in Testfully can have their own proxy settings. When applied to a parent folder, all of the sub-folders inherit the settings, unless a sub-folder is set to not use a Proxy Server or has dedicated proxy server settings.

When sending requests, Testfully uses the provided proxy server settings based on the parent folder(s) of requests.

Using your LAN/Wi-Fi proxy settings

If you have configured your LAN/Wi-Fi network to use a proxy server, you don't need to do anything extra as Testfully honours your LAN/Wi-Fi proxy settings. The below options are provided for further customisation. It is worth to mention that Testfully cannot bypass your LAN/Wi-Fi settings at all.

Setting a Proxy Server

To set proxy settings for a folder, please follow the below steps:

• Hover over the folder name, and click on the "..." icon
• Click on the "Settings" menu
• Use the "Proxy" section to set the proxy settings
• Click "Save" button to permanently save changes

Proxy Types

The Proxy feature comes with four options.

Not Set

The "Not Set" option means that you have not explicitly set proxy settings for the selected folder.

When the type of a proxy is "Not Set", Testfully tries to inherit the proxy settings from the parent folders (if there is a parent folder) or defaults to your LAN/Wi-Fi proxy settings for sending requests. When your LAN/Wi-Fi does not have a proxy set, Testfully sends the requests without using a Proxy Server.

Use Environment Variables

The "Use Environment Variables" type instructs Testfully to leverage the industry standard environment variables (mentioned below) to load the Proxy Server settings.

It is worth to mention that setting environment variables for your terminal does not necessarily mean that Testfully would be able to read the values. To correctly set environment variables for a GUI application, please consult documentation of your current OS.

You can customise Testfully's proxy server using the following environment variable. Each variable comes in two variations: lower_case and UPPER_CASE.

As the rule of thumb:

• Pick one variation, lower_case or UPPER_CASE; do not use both variations at the same time.
• When Testfully identifies both lower_case and UPPER_CASE for an environment variable, the lower_case will be used and UPPER_CASE will be ignored.
• Testfully ignores environment variables that do not hold a value (empty string).
• To refresh environment variable values, reload the Testfully app by closing and opening it again.

http_proxy & HTTP_PROXY

Both http_proxy and HTTP_PROXY environment variables can be used to set proxy server address.

• Unless https_proxy or HTTPS_PROXY variables have value, both HTTP and HTTPS requests will be proxied using http_proxy or HTTP_PROXY variable values.
• Both variables must follow the {protocol}://{host}:{port} or {protocol}://{username}:{password}@{host}:{port} format. When your proxy server requires authentication, you can use the later format to pass your username and password to the proxy server.

https_proxy & HTTPS_PROXY

A way to provide proxy server address for HTTPS requests only. Both environment variables follow the rules outlined for the http_proxy and HTTP_PROXY environment variables.

all_proxy & ALL_PROXY

A way to provide proxy server address for both HTTP and HTTPS requests. Both environment variables follow the rules outlined for the http_proxy and HTTP_PROXY environment variables.

• When http_proxy or HTTP_PROXY environment variables have a value, Testfully ignores both ALL_PROXY and all_proxy environment variables altogether.
• When https_proxy or HTTPS_PROXY environment variables have a value, Testfully ignores both ALL_PROXY and all_proxy environment variables altogether.

no_proxy & NO_PROXY

A way to provide a list of domains (comma separated) to not be proxied.

• Provide a list of comma-separated domains. E.g. stripe.com,therickandmortyapi.com
• Exclude multiple subdomains using the * character. E.g. *.stripe.com
• Set no_proxy or NO_PROXY but not both; when both environment variables have a value, Testfully uses no_proxy only (we do not merge the values).

Use Custom Settings

An easy way to set proxy settings via Testfully GUI and leverage the values for sending requests.

The table below briefs the purpose of each field.

No Proxy

The "No Proxy" option means that you do not want to use Environment Variables or Custom Settings for a Proxy. Please keep in mind that it does not mean that Testfully will skip the proxy settings of your LAN or Wi-Fi network; Testfully does not have access to those settings and cannot bypass them neither.

Troubleshooting Proxy Issues

As the rule of thumb, make sure you have configured your Proxy Server correctly. We highly recommend testing your proxy server using the Custom Proxy Server settings. To help you identify the root cause of proxy-related issued, we have put together a list of common issues and a way to fix them.

My Proxy Server does not receive requests from Testfully

• If your endpint starts with http, make sure you have instructed Testfully to proxy HTTP requests.
• If your endpoint starts with https, make sure you have disabled SSL Verification.