Apple Platform Deployment
- Welcome
- Intro to Apple platform deployment
- What’s new
-
-
- Declarative status reports
- Declarative app configuration
- Authentication credentials and identity asset declaration
- Background task management declarative
- Calendar declarative configuration
- 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
- Math and Calculator app declarative configuration
- Passcode declarative configuration
- Passkey Attestation declarative configuration
- Safari extensions management declarative configuration
- Screen Sharing declarative configuration
- Service configuration files declarative configuration
- Software Update declarative configuration
- Software Update settings declarative configuration
- Storage management declarative configuration
- Subscribed Calendars declarative configuration
-
-
- 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
- Cellular payload settings
- Cellular 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
- Setup 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
-
- Glossary
- Document revision history
- Copyright

Global HTTP Proxy device management 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, Shared iPad, Mac, or Apple TV that enrolls in a device management service.
If you choose Manual proxy type, you need the proxy server address—including its port and optionally a user name and password—for logging in to 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 enrollment methods: Automated Device Enrollment.
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 user name 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 device management service developer implements these settings differently. To learn how various Global HTTP Proxy settings are applied to your devices, consult your developer’s device management service documentation.