Global HTTP Proxy
com.apple.proxy.http.global
The payload that configures a global HTTP proxy.
Requires supervision on iOS, tvOS, visionOS · Only one instance per profile · macOS: device channel only
Configuration Keys (8)
| Key | Type | Description | Default | Range |
|---|---|---|---|---|
| string | 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. | Default: "Manual" | Range: Manual, Auto | |
| string | 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] | Default: — | Range: — | |
ProxyServerPortintegerProxy server port | integer | 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] | Default: — | Range: — |
ProxyUsernamestringProxy username | string | 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'. | Default: — | Range: — |
ProxyPasswordstringProxy password | string | 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'. | Default: — | Range: — |
ProxyPACURLstringProxy PAC URL | string | 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'. | Default: — | Range: — |
| boolean | If 'true', allows connecting directly to the destination if the proxy autoconfiguration (PAC) file is unreachable. | Default: false | Range: — | |
| boolean | If 'true', allows the device to bypass the proxy server to display the login page for captive networks. | Default: false | Range: — |