Network Proxy Configuration (com.apple.SystemConfiguration)

com.apple.SystemConfiguration

The payload that configures network proxies for a device.

macOS(10.7)
Branch: release

Settings (26)

SettingTypeRequiredDefaultManual InstallSupported OS
Proxies
Proxies
The dictionary containing all the proxies for this device.
24 subkeys
dictionaryrequired—
✓Yes
macOS (10.7+)
└─
FTPEnable
FTPEnable
If `true`, enables FTP proxy.
integeroptional—
✓Yes
macOS (10.7+)
└─
FTPPassive
FTPPassive
If `true`, enables passive FTP mode.
integeroptional—
✓Yes
macOS (10.7+)
└─
FTPPort
FTPPort
The FTP proxy port.
integeroptional—
✓Yes
macOS (10.7+)
└─
FTPProxy
FTPProxy
The host name or IP address for the FTP proxy.
stringoptional—
✓Yes
macOS (10.7+)
└─
GopherEnable
GopherEnable
If `true`, enables gopher proxy.
integeroptional—
✓Yes
macOS (10.7+)
└─
GopherPort
GopherPort
The gopher proxy port.
integeroptional—
✓Yes
macOS (10.7+)
└─
GopherProxy
GopherProxy
The host name or IP address for the gopher proxy.
stringoptional—
✓Yes
macOS (10.7+)
└─
HTTPEnable
HTTPEnable
If `true`, enables web proxy.
integeroptional—
✓Yes
macOS (10.7+)
└─
HTTPPort
HTTPPort
The web proxy port.
integeroptional—
✓Yes
macOS (10.7+)
└─
HTTPProxy
HTTPProxy
The host name or IP address for the web proxy.
stringoptional—
✓Yes
macOS (10.7+)
└─
HTTPSEnable
HTTPSEnable
If `true`, enables secure web proxy.
integeroptional—
✓Yes
macOS (10.7+)
└─
HTTPSPort
HTTPSPort
The secure web proxy port.
integeroptional—
✓Yes
macOS (10.7+)
└─
HTTPSProxy
HTTPSProxy
The host name or IP address for the secure web proxy.
stringoptional—
✓Yes
macOS (10.7+)
└─
ProxyAutoConfigEnable
ProxyAutoConfigEnable
If `true`, enables automatic proxy configuration.
integeroptional—
✓Yes
macOS (10.7+)
└─
ProxyAutoConfigURLString
ProxyAutoConfigURLString
The automatic proxy configuration URL.
stringoptional—
✓Yes
macOS (10.7+)
└─
ProxyCaptiveLoginAllowed
ProxyCaptiveLoginAllowed
If 1, allows client to log into captive portal network.
integeroptional—
✓Yes
macOS (10.9+)
└─
RTSPEnable
RTSPEnable
If `true`, enable streaming proxy.
integeroptional—
✓Yes
macOS (10.7+)
└─
RTSPPort
RTSPPort
The streaming proxy port.
integeroptional—
✓Yes
macOS (10.7+)
└─
RTSPProxy
RTSPProxy
The host name or IP address for the streaming proxy.
stringoptional—
✓Yes
macOS (10.7+)
└─
SOCKSEnable
SOCKSEnable
If `true`, enable the SOCKS proxy.
integeroptional—
✓Yes
macOS (10.7+)
└─
SOCKSPortinteger
SOCKSPortinteger
The SOCKS proxy port.
integeroptional—
✓Yes
macOS (10.7+)
└─
SOCKSProxy
SOCKSProxy
The host name or IP address for the SOCKS proxy.
stringoptional—
✓Yes
macOS (10.7+)
└─
FallBackAllowed
FallBackAllowed
If `1`, enables fallback. Default is `1`. For managed devices, if not supplied, the default is `0`.
integeroptional—
✓Yes
macOS (10.7+)
└─
ExceptionsList
ExceptionsList
The list of hosts and domains that should bypass proxy settings.
1 subkey
arrayoptional—
✓Yes
macOS (10.7+)
└─ └─
Exception
Exception
Bypass proxy settings for these Hosts & Domains
stringrequired—
✓Yes
macOS (10.7+)

Apple MDM & DDM Policy Explorer

Explore the full catalogue of Apple Mobile Device Management (MDM) and Declarative Device Management (DDM) policies for macOS and iOS. Search, filter, and reference policy keys for use with Microsoft Intune, Jamf, or any standards-compliant MDM solution.

Reference: policy categories & common keys

Policy categories

  • Configuration Profile
  • Declarative Configuration
  • Declarative Activation
  • Declarative Asset
  • Declarative Management

Common policy keys

  • com.apple.wifi.managed – Wi-Fi network configuration
  • com.apple.vpn.managed – VPN configuration
  • com.apple.applicationaccess – App and feature restrictions
  • com.apple.security.pkcs1 – Certificate (PKCS#1) payload
  • com.apple.security.pkcs12 – Identity certificate (PKCS#12) payload
  • com.apple.security.scep – SCEP certificate enrolment
  • com.apple.mail.managed – Mail account configuration
  • com.apple.eas.account – Exchange ActiveSync account
  • com.apple.MCX – Managed Client (macOS) preferences
  • com.apple.MCX.FileVault2 – FileVault 2 disk encryption
  • com.apple.dock – macOS Dock configuration
  • com.apple.screensaver – Screensaver configuration
  • com.apple.loginwindow – macOS login window configuration
  • com.apple.systempolicy.managed – Gatekeeper / system policy
  • com.apple.systempreferences – System Preferences pane restrictions
  • com.apple.SoftwareUpdate – Software update behaviour
  • com.apple.TCC.configuration-profile-policy – Privacy Preferences Policy Control (PPPC)
  • com.apple.notificationsettings – Per-app notification settings
  • com.apple.webcontent-filter – Web content filter
  • com.apple.dnsSettings.managed – DNS settings (DoH / DoT)
  • com.apple.relay.managed – Network relay configuration
  • com.apple.extensiblesso – Extensible Single Sign-On
  • com.apple.configuration.passcode.settings – DDM: passcode policy
  • com.apple.configuration.softwareupdate.enforcement.specific – DDM: enforced software update
  • com.apple.configuration.services.configuration-files – DDM: service configuration files
  • com.apple.configuration.management.status-subscriptions – DDM: status subscriptions
  • com.apple.activation.simple – DDM: simple activation predicate
  • com.apple.management.organization-info – DDM: organization information