HTTP Proxy Support for macOS

If you want the HYPR Workforce Access Client for macOS to communicate with the HYPR server via a proxy, you have two configuration options depending on your network setup: either configure the proxy directly in the HYPR application or set a system-wide proxy in macOS.

Configuring a Proxy in the HYPR Client App

Starting with version 6.13, you can configure a proxy directly in the HYPR Workforce Access Client by adding or modifying the ProxyServer and ProxyBypass parameters in the application's HyprOneService.plist file.

Parameter

Description

ProxyServer

The proxy server to be used, in the form proxy[:port]. For example:

proxy.myoffice.com:808

The port is optional and defaults to 8080.

ProxyBypass

A comma-separated list of host names to be excluded. If the URL matches any of the hosts in the list, the proxy will be bypassed and a direct connection made. Host names can include wildcards (e.g., .mycompany.com or 10.20.).

For more information on changing the HyprOneService.plist configuration settings, see Installation and Configuration. Remember to save the file and restart the computer for your changes to be applied.

Configuring a Proxy System-wide in the macOS Settings

Alternatively, use the following steps to configure a system-wide HTTP/HTTPS proxy in macOS.

  1. Open the System Preferences application and click on the “Network” icon.
  1. Depending on which network adapters are available (e.g., Ethernet or Wi-Fi), select the appropriate network adapter and then click the “Advanced…” button.
  1. Choose the “Proxies” tab at the top of the page.

There are three ways to configure a proxy: 1) manually, 2) specifying a URL for a proxy auto config (PAC) file, and 3) having the system discover the proxy automatically via DNS.

Manually Configuring the Proxy

Select “Secure Web Proxy (HTTPS)” and enter the host name or IP address of the proxy server along with the TCP port that the proxy server is listening on. For example, the following screenshot shows a proxy at 192.168.0.200 listening on port 808.

Specifying the URL of the Proxy Auto Config (PAC) File

Select “Automatic Proxy Configuration” and enter the URL for the Proxy Auto Config (PAC) file.

Discovering the Proxy Automatically via DNS

Select “Auto Proxy Discover” to have macOS discover the proxy automatically via DNS.