Explore the full catalogue of Apple Mobile Device Management (MDM) and Declarative Device Management (DDM) policies for macOS and iOS. Use the interactive explorer to search, filter, and reference policy keys for use with Microsoft Intune, Jamf, or any standards-compliant MDM solution.
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+) |
