Back to browser

Global HTTP Proxy

com.apple.proxy.http.global

The payload that configures a global HTTP proxy.

iOSmacOStvOS

macOS 10.9+iOS 6.0+exclusive

Configuration Keys (8)

Key	Type	Title	Description	Default	Range
`ProxyType`required	string	Proxy Type	The proxy type. For a manual proxy type, the profile contains the proxy server address, including its port, and optionally a user name and password. For an auto proxy type, you can enter a PAC URL.	"Manual"
`ProxyServer`required	string	Proxy Server	The proxy server's network address. The device requires this if 'ProxyType' is set to 'Manual', and ignores it if 'ProxyType' is set to 'Automatic'. Depends on: ProxyType ∈ [Manual]	—	—
`ProxyServerPort`	integer	Proxy Server Port	The proxy server's port number. The device requires this if 'ProxyType' is set to 'Manual', and ignores this if 'ProxyType' is set to 'Automatic'. Depends on: ProxyType ∈ [Manual]	—	—
`ProxyUsername`	string	Proxy Username	The user name used to authenticate to the proxy server. The device only uses this if 'ProxyType' is set to 'Manual', and ignores it if 'ProxyType' is set to 'Automatic'.	—	—
`ProxyPassword`	string	Proxy Password	The password used to authenticate to the proxy server. The device only uses this if 'ProxyType' is set to 'Manual', and ignores it if 'ProxyType' is set to 'Automatic'.	—	—
`ProxyPACURL`	string	Proxy PAC URL	The URL of the PAC file that defines the proxy configuration. Starting in iOS 13 and macOS 10.15, only URLs that begin with 'http://' or 'https://' are allowed. This is only used if 'ProxyType' is set to 'Automatic', and is ignored if 'ProxyType' is set to 'Manual'.	—	—
`ProxyPACFallbackAllowed`	boolean	Proxy PAC Fallback Allowed	If 'true', allows connecting directly to the destination if the proxy autoconfiguration (PAC) file is unreachable.	false	—
`ProxyCaptiveLoginAllowed`	boolean	Proxy Bypass Allowed	If 'true', allows the device to bypass the proxy server to display the login page for captive networks.	false	—