mirror of
https://github.com/apple/device-management.git
synced 2026-07-10 21:13:42 +02:00
Cyrus Daboo
116 lines
3.5 KiB
YAML
116 lines
3.5 KiB
YAML
title: Global HTTP Proxy
|
|
description: The payload that configures a global HTTP proxy.
|
|
payload:
|
|
payloadtype: com.apple.proxy.http.global
|
|
supportedOS:
|
|
iOS:
|
|
introduced: '6.0'
|
|
multiple: false
|
|
supervised: true
|
|
allowmanualinstall: true
|
|
sharedipad:
|
|
mode: allowed
|
|
devicechannel: true
|
|
userchannel: false
|
|
userenrollment:
|
|
mode: forbidden
|
|
macOS:
|
|
introduced: '10.9'
|
|
multiple: false
|
|
devicechannel: true
|
|
userchannel: false
|
|
requiresdep: false
|
|
userapprovedmdm: false
|
|
allowmanualinstall: true
|
|
userenrollment:
|
|
mode: forbidden
|
|
tvOS:
|
|
introduced: '9.0'
|
|
multiple: false
|
|
supervised: true
|
|
allowmanualinstall: true
|
|
visionOS:
|
|
introduced: '2.0'
|
|
multiple: false
|
|
supervised: true
|
|
allowmanualinstall: true
|
|
userenrollment:
|
|
mode: forbidden
|
|
watchOS:
|
|
introduced: n/a
|
|
content: PEM-encoded cer
|
|
payloadkeys:
|
|
- key: ProxyType
|
|
title: Proxy type
|
|
type: <string>
|
|
presence: optional
|
|
rangelist:
|
|
- Manual
|
|
- Auto
|
|
default: Manual
|
|
content: 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.
|
|
- key: ProxyServer
|
|
title: Proxy server
|
|
type: <string>
|
|
subtype: <hostname>
|
|
presence: optional
|
|
content: 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`.
|
|
- key: ProxyServerPort
|
|
title: Proxy server port
|
|
type: <integer>
|
|
presence: optional
|
|
content: 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`.
|
|
- key: ProxyUsername
|
|
title: Proxy username
|
|
type: <string>
|
|
presence: optional
|
|
content: 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`.
|
|
- key: ProxyPassword
|
|
title: Proxy password
|
|
type: <string>
|
|
presence: optional
|
|
content: 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`.
|
|
- key: ProxyPACURL
|
|
title: Proxy PAC URL
|
|
type: <string>
|
|
presence: optional
|
|
content: 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`.
|
|
- key: ProxyPACFallbackAllowed
|
|
title: Proxy PAC fallback allowed
|
|
supportedOS:
|
|
iOS:
|
|
introduced: '7.0'
|
|
type: <boolean>
|
|
presence: optional
|
|
default: false
|
|
content: If `true`, allows connecting directly to the destination if the proxy autoconfiguration
|
|
(PAC) file is unreachable.
|
|
- key: ProxyCaptiveLoginAllowed
|
|
title: Proxy bypass allowed
|
|
supportedOS:
|
|
iOS:
|
|
introduced: '7.0'
|
|
type: <boolean>
|
|
presence: optional
|
|
default: false
|
|
content: If `true`, allows the device to bypass the proxy server to display the
|
|
login page for captive networks.
|
|
notes:
|
|
- title: ''
|
|
content: There can only be one payload of this type on the device at any time.
|
|
examples:
|
|
- title: Profile example
|
|
files:
|
|
- file: examples/mdm/profiles/com.apple.proxy.http.global/example1.plist
|