Proxies

com.apple.SystemConfiguration

The payload that configures network proxies for a device.

macOS

macOS 10.7+exclusive

Configuration Keys (1)

Key	Type	Title	Description	Default	Range
`Proxies`required	dict	Proxy Configuration	The dictionary containing all the proxies for this device.	—	—
`HTTPEnable`	integer	Enable HTTP Proxy	If 'true', enables web proxy.	0	—
`HTTPProxy`	string	HTTP Proxy Hostname	The host name or IP address for the web proxy.	—	—
`HTTPPort`	integer	HTTP Proxy Port	The web proxy port.	80	—
`HTTPSEnable`	integer	Enable HTTPS Proxy	If 'true', enables secure web proxy.	0	—
`HTTPSProxy`	string	HTTPS Proxy Hostname	The host name or IP address for the secure web proxy.	—	—
`HTTPSPort`	integer	HTTPS Proxy Port	The secure web proxy port.	80	—
`FTPEnable`	integer	Enable FTP Proxy	If 'true', enables FTP proxy.	0	—
`FTPPassive`	integer	Use Passive FTP Mode (PASV)	If 'true', enables passive FTP mode.	0	—
`FTPProxy`	string	FTP Proxy Hostname	The host name or IP address for the FTP proxy.	—	—
`FTPPort`	integer	FTP Proxy Port	The FTP proxy port.	80	—
`SOCKSEnable`	integer	Enable SOCKS Proxy	If 'true', enable the SOCKS proxy.	0	—
`SOCKSProxy`	string	SOCKS Proxy Hostname	The host name or IP address for the SOCKS proxy.	—	—
`SOCKSPortInteger`	integer	SOCKS Proxy Port	The port on which to connect to the socks proxy server.	80	—
`RTSPEnable`	integer	Enable RTSP Steaming Proxy	If 'true', enable streaming proxy.	0	—
`RTSPProxy`	string	RTSP Proxy Hostname	The host name or IP address for the streaming proxy.	—	—
`RTSPPort`	integer	RTSP Proxy Port	The streaming proxy port.	80	—
`GopherEnable`	integer	Enable Gopher Proxy	If 'true', enables gopher proxy.	0	—
`GopherProxy`	string	Gopher Proxy Hostname	The host name or IP address for the gopher proxy.	—	—
`GopherPort`	integer	Gopher Proxy Port	The gopher proxy port.	80	—
`ExceptionsList`	array	Exceptions	The list of hosts and domains that should bypass proxy settings.	—	—
`Exception`required	string	Bypassed Domain	Bypass proxy settings for these Hosts & Domains	—	—
`ProxyAutoConfigEnable`	integer	Enable Automatic Proxy Configuration	If 'true', enables automatic proxy configuration.	0	—
`ProxyAutoConfigURLString`	string	Automatic Proxy Configuration URL	The automatic proxy configuration URL. Depends on: Proxies.ProxyAutoConfigEnable ∈ [1]	—	—
`FallBackAllowed`	integer	Allow Proxy PAC Fallback	If '1', enables fallback. Default is '1'. For managed devices, if not supplied, the default is '0'.	—	—
`ProxyCaptiveLoginAllowed`	integer	Allow Proxy Bypass for Captive Portal Logins	If 1, allows client to log into captive portal network.	false	—
`SOCKSPortinteger`	integer	SOCKS Port	The SOCKS proxy port.	—	—
`Exception`required	string	Bypassed Domain	Bypass proxy settings for these Hosts & Domains	—	—
`HTTPEnable`	integer	Enable HTTP Proxy	If 'true', enables web proxy.	0	—
`HTTPProxy`	string	HTTP Proxy Hostname	The host name or IP address for the web proxy.	—	—
`HTTPPort`	integer	HTTP Proxy Port	The web proxy port.	80	—
`HTTPSEnable`	integer	Enable HTTPS Proxy	If 'true', enables secure web proxy.	0	—
`HTTPSProxy`	string	HTTPS Proxy Hostname	The host name or IP address for the secure web proxy.	—	—
`HTTPSPort`	integer	HTTPS Proxy Port	The secure web proxy port.	80	—
`FTPEnable`	integer	Enable FTP Proxy	If 'true', enables FTP proxy.	0	—
`FTPPassive`	integer	Use Passive FTP Mode (PASV)	If 'true', enables passive FTP mode.	0	—
`FTPProxy`	string	FTP Proxy Hostname	The host name or IP address for the FTP proxy.	—	—
`FTPPort`	integer	FTP Proxy Port	The FTP proxy port.	80	—
`SOCKSEnable`	integer	Enable SOCKS Proxy	If 'true', enable the SOCKS proxy.	0	—
`SOCKSProxy`	string	SOCKS Proxy Hostname	The host name or IP address for the SOCKS proxy.	—	—
`SOCKSPortInteger`	integer	SOCKS Proxy Port	The port on which to connect to the socks proxy server.	80	—
`RTSPEnable`	integer	Enable RTSP Steaming Proxy	If 'true', enable streaming proxy.	0	—
`RTSPProxy`	string	RTSP Proxy Hostname	The host name or IP address for the streaming proxy.	—	—
`RTSPPort`	integer	RTSP Proxy Port	The streaming proxy port.	80	—
`GopherEnable`	integer	Enable Gopher Proxy	If 'true', enables gopher proxy.	0	—
`GopherProxy`	string	Gopher Proxy Hostname	The host name or IP address for the gopher proxy.	—	—
`GopherPort`	integer	Gopher Proxy Port	The gopher proxy port.	80	—
`ExceptionsList`	array	Exceptions	The list of hosts and domains that should bypass proxy settings.	—	—
`Exception`required	string	Bypassed Domain	Bypass proxy settings for these Hosts & Domains	—	—
`ProxyAutoConfigEnable`	integer	Enable Automatic Proxy Configuration	If 'true', enables automatic proxy configuration.	0	—
`ProxyAutoConfigURLString`	string	Automatic Proxy Configuration URL	The automatic proxy configuration URL. Depends on: Proxies.ProxyAutoConfigEnable ∈ [1]	—	—
`FallBackAllowed`	integer	Allow Proxy PAC Fallback	If '1', enables fallback. Default is '1'. For managed devices, if not supplied, the default is '0'.	—	—
`ProxyCaptiveLoginAllowed`	integer	Allow Proxy Bypass for Captive Portal Logins	If 1, allows client to log into captive portal network.	false	—
`SOCKSPortinteger`	integer	SOCKS Port	The SOCKS proxy port.	—	—
`Exception`required	string	Bypassed Domain	Bypass proxy settings for these Hosts & Domains	—	—