Apple Platform Deployment
- Welcome
- Intro to Apple platform deployment
- What’s new
-
-
- Accessibility payload settings
- Active Directory Certificate payload settings
- AirPlay payload settings
- AirPlay Security payload settings
- AirPrint payload settings
- App Lock payload settings
- Associated Domains payload settings
- Automated Certificate Management Environment (ACME) payload settings
- Autonomous Single App Mode payload settings
- Calendar payload settings
- Mobile payload settings
- Mobile Private Network payload settings
- Certificate Preference payload settings
- Certificate Revocation payload settings
- Certificate Transparency payload settings
- Certificates payload settings
- Conference Room Display payload settings
- Contacts payload settings
- Content Caching payload settings
- Directory Service payload settings
- DNS Proxy payload settings
- DNS Settings payload settings
- Dock payload settings
- Domains payload settings
- Energy Saver payload settings
- Exchange ActiveSync (EAS) payload settings
- Exchange Web Services (EWS) payload settings
- Extensible Single Sign-on payload settings
- Extensible Single Sign-on Kerberos payload settings
- Extensions payload settings
- FileVault payload settings
- Finder payload settings
- Firewall payload settings
- Fonts payload settings
- Global HTTP Proxy payload settings
- Google Accounts payload settings
- Home Screen Layout payload settings
- Identification payload settings
- Identity Preference payload settings
- Kernel Extension Policy payload settings
- LDAP payload settings
- Lights Out Management payload settings
- Lock Screen Message payload settings
- Login Window payload settings
- Managed Login Items payload settings
- Mail payload settings
- Network Usage Rules payload settings
- Notifications payload settings
- Parental Controls payload settings
- Passcode payload settings
- Printing payload settings
- Privacy Preferences Policy Control payload settings
- Relay payload settings
- SCEP payload settings
- Security payload settings
- Set-up Assistant payload settings
- Single Sign-on payload settings
- Smart Card payload settings
- Subscribed Calendars payload settings
- System Extensions payload settings
- System Migration payload settings
- Time Machine payload settings
- TV Remote payload settings
- Web Clips payload settings
- Web Content Filter payload settings
- Xsan payload settings
-
- Declarative app configuration settings
- Authentication credentials and identity asset settings
- Calendar declarative settings
- Certificates declarative configuration
- Contacts declarative configuration
- Exchange declarative configuration
- Google Accounts declarative configuration
- LDAP declarative configuration
- Legacy interactive profile declarative configuration
- Legacy profile declarative configuration
- Mail declarative configuration
- Passcode declarative configuration
- Passkey Attestation declarative configuration
- Screen Sharing declarative configuration
- Service configuration files declarative configuration
- Software Update declarative configuration
- Subscribed Calendars declarative configuration
- Glossary
- Document revision history
- Copyright
![](https://help.apple.com/assets/664256E0F9FFA26F690A0B01/664256E3F9FFA26F690A0B07/en_AU/312766e3df7f57c1f549da2dab216b36.png)
Global HTTP Proxy MDM payload settings for Apple devices
Use the Global HTTP Proxy payload to specify a proxy for all HTTP traffic to and from an iPhone, iPad, Mac computer or Apple TV device that’s enrolled in an MDM solution.
If you choose Manual proxy type, you need the proxy server address — including its port and optionally a username and password — for logging into the proxy server. If you choose Auto proxy type, you can enter a proxy auto-config (PAC) URL.
The Global HTTP Proxy payload supports the following. For more information, see Payload information.
Supported payload identifier: com.apple.proxy.http.global
Supported operating systems and channels: iOS, iPadOS, Shared iPad device, macOS device, tvOS.
Supported enrolment types: Automated Device Enrolment.
Duplicates allowed: False — only one Global HTTP Proxy payload can be delivered to a device.
You can use the settings in the table below with the Global HTTP Proxy payload.
Setting | Description | Required | |||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Proxy type | Use Manual for proxies that require authentication. | Yes | |||||||||
Hostname | The IP address or fully qualified domain name (FQDN) of the proxy server. Required if the proxy type is Manual. | Yes | |||||||||
Port | The port number of the proxy server. Required if the proxy type is Manual. | Yes | |||||||||
Proxy server URL | Required if the proxy type is Automatic. | Yes | |||||||||
Authentication | The username for the proxy server. This setting is only available for the Manual proxy type. | No | |||||||||
Password | The authentication password for the proxy server. This setting is only available for the Manual proxy type. | No | |||||||||
Allow direct connection if PAC is unreachable | The device bypasses the proxy server if the PAC file is unreachable. | No | |||||||||
Allow bypassing proxy to access captive networks | The device ignores proxy settings to display the login page for captive networks. | No |
Note: Each MDM vendor implements these settings differently. To learn how various Global HTTP Proxy settings are applied to your devices, consult your MDM vendor’s documentation.