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 browsing management 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 and trademarks
 

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.