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