The Island enterprise browser provides built-in traffic filtering and monitoring. Its integration with AppGate ZTNA adds the ability to route internet traffic from other sources — such as browsers and terminals — through a secure web gateway, while excluding enterprise browser traffic from that filtering. This removes duplicate filtering, reduces latency, and reduces load on the gateway.
Traffic is routed differently based on two factors: whether it is internet-bound or private access traffic, and whether it originates from the enterprise browser or another source.
Enterprise browser, internet-bound traffic. Filtered by the browser's built-in tools. Bypasses the AppGate ZTNA default Gateway tunnel, reducing network traffic, Gateway load, and the volume of traffic processed by the Secure Web Gateway (SWG).

Enterprise browser, private access traffic. Routed through AppGate ZTNA tunnels. The enterprise browser applies its own controls while reaching internal resources through the AppGate ZTNA direct-routed model.

Non-enterprise browser, internet-bound traffic. Routed through the AppGate ZTNA default Gateway. This traffic can be filtered and monitored by a third-party SWG solution.

Non-enterprise browser, private access. Routed through AppGate tunnels as normal.

Enterprise browser traffic is routed through a SOCKS proxy on the AppGate ZTNA client driver. The SOCKS proxy rejects all traffic that does not originate from the enterprise browser process, preventing non-enterprise browser traffic from bypassing the default Gateway and its filtering and monitoring.

Enterprise browser management traffic must not be routed through the SOCKS proxy. Configure this exclusion in the Island.io management console to ensure the enterprise browser can still receive configuration updates if the SOCKS proxy fails to start..

Configuring the client
NOTE
These steps apply to all clients except Windows lite clients. After making these changes, restart the AppGate ZTNA driver service to apply them. To allow multiple executables, separate them with a pipe (
|).
Windows
Open the registry editor.
Edit the
HKEY_LOCAL_MACHINE\SOFTWARE\Appgate\Driverkey.Add a string value named
SocksProxyAllowedExeswith the path to the browser executable. For example:C:\Program Files\Island\Island\Application\Island.exe.Restart the driver service:
Restart-Service -Name appgatedriver
macos
Open a terminal.
Run the following command:
sudo defaults write com.appgate.sdp.tun SocksProxyAllowedExes "/Applications/Island.app/Contents/Frameworks/Island Framework.framework/Helpers/Island Helper.app/Contents/MacOS/Island Helper"Restart the driver service:
sudo launchctl kickstart -k system/com.appgate.sdp.tun
Configuring the AppGate ZTNA default Gateway
The AppGate ZTNA default Gateway configuration is described in detail in Routing client traffic. Configure filtering and monitoring behind the default Gateway, such as an SWG, according to your organization’s requirements.
Configuring the island.io enterprise browser
Sign in to the Island Management Console.
Navigate to the Network Access module.
Open the Network settings and go to the Proxy section.
Create a new rule for the applicable sources—for example,
User=firstname.lastname—with the following proxy settings:
{
"ProxyMode": "fixed_servers",
"ProxyServer": "socks5://127.0.0.1:1080",
"ProxyBypassList": "*.island.io"
}This configuration routes all traffic except *.island.io through the SOCKS proxy. The bypass entry ensures the Island browser can still receive configuration updates if the SOCKS proxy fails or is misconfigured.
Troubleshooting
Verify the configuration
Confirm that SocksProxyAllowedExes is correctly defined for your operating system. This setting is required to start the SOCKS proxy.
Check log files
Review the SOCKS proxy log files for information about proxy access attempts and traffic flow:
Windows:
C:\ProgramData\Appgate\socksproxy.logmacOS:
/var/log/appgate/socksproxy.log
These logs confirm whether the SOCKS proxy started, which applications are accessing it, and whether traffic is flowing through it correctly.