The payload that configures a global HTTP proxy.
| Setting | Type | Required | Default | Manual Install | Supported OS |
|---|---|---|---|---|---|
Proxy Type ProxyType 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. | string | optional | Manual | ✓Yes | iOS (6.0+)macOS (10.9+)tvOS (9.0+)visionOS (2.0+) |
Proxy Server ProxyServer 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`. | string | optional | — | ✓Yes | iOS (6.0+)macOS (10.9+)tvOS (9.0+)visionOS (2.0+) |
Proxy Server Port ProxyServerPort 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`. | integer | optional | — | ✓Yes | iOS (6.0+)macOS (10.9+)tvOS (9.0+)visionOS (2.0+) |
Proxy Username ProxyUsername 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`. | string | optional | — | ✓Yes | iOS (6.0+)macOS (10.9+)tvOS (9.0+)visionOS (2.0+) |
Proxy Password ProxyPassword 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`. | string | optional | — | ✓Yes | iOS (6.0+)macOS (10.9+)tvOS (9.0+)visionOS (2.0+) |
Proxy PAC URL ProxyPACURL 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`. | string | optional | — | ✓Yes | iOS (6.0+)macOS (10.9+)tvOS (9.0+)visionOS (2.0+) |
Proxy PAC Fallback Allowed ProxyPACFallbackAllowed If `true`, allows connecting directly to the destination if the proxy autoconfiguration (PAC) file is unreachable. | boolean | optional | false | ✓Yes | iOS (7.0+) |
Proxy Bypass Allowed ProxyCaptiveLoginAllowed If `true`, allows the device to bypass the proxy server to display the login page for captive networks. | boolean | optional | false | ✓Yes | iOS (7.0+) |
