Proxies

com.apple.SystemConfiguration

The payload that configures network proxies for a device.

macOS 10.7+

Not available with User Enrollment · Only one instance per profile · macOS: device channel only

Configuration Keys (1)

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