The payload that configures cellular settings.
| Setting | Type | Required | Default | Manual Install | Supported OS |
|---|---|---|---|---|---|
AttachAPN AttachAPN A configuration dictionary. 5 subkeys | dictionary | optional | — | ✓Yes | iOS (7.0+)watchOS (3.2+) |
└─ Name Name The name for this configuration. | string | required | — | ✓Yes | iOS (7.0+)watchOS (3.2+) |
└─ Authentication type AuthenticationType The authentication type. | string | optional | PAP | ✓Yes | iOS (7.0+)watchOS (3.2+) |
└─ User name Username The user name. | string | optional | — | ✓Yes | iOS (7.0+)watchOS (3.2+) |
└─ Password Password The password for the user. | string | optional | — | ✓Yes | iOS (7.0+)watchOS (3.2+) |
└─ Supported IP Versions AllowedProtocolMask The Internet Protocol versions that the system supports. Allowed values:
- `1`: IPv4
- `2`: IPv6
- `3`: Both | integer | optional | — | ✓Yes | iOS (10.3+) |
APNs APNs An array of access point name (APN) dictionaries. 1 subkey | array | optional | — | ✓Yes | iOS (7.0+)watchOS (3.2+) |
└─ APNsItem APNsItem A dictionary that contains details about an access point name (APN) configuration. 11 subkeys | dictionary | — | ✓Yes | iOS (7.0+)watchOS (3.2+) | |
└─ └─ Name Name The name for this configuration. | string | required | — | ✓Yes | iOS (7.0+)watchOS (3.2+) |
└─ └─ Authentication type AuthenticationType The authentication type for logging in. | string | optional | PAP | ✓Yes | iOS (7.0+)watchOS (3.2+) |
└─ └─ User name Username The user name for the APN. | string | optional | — | ✓Yes | iOS (7.0+)watchOS (3.2+) |
└─ └─ Password Password The user's password for the APN. | string | optional | — | ✓Yes | iOS (7.0+)watchOS (3.2+) |
└─ └─ Proxy server ProxyServer The proxy server's address. | string | optional | — | ✗No | |
└─ └─ Proxy port ProxyPort The proxy server's port number. | integer | optional | — | ✓Yes | iOS (7.0+)watchOS (3.2+) |
└─ └─ DefaultProtocolMask DefaultProtocolMask Deprecated (iOS 11.0) The default Internet Protocol versions. Available in iOS 10.3 but no longer used in iOS 11 and later. Allowed values:
- `1`: IPv4
- `2`: IPv6
- `3`: Both | integer | optional | — | ✓Yes | iOS (10.3 - 11.0) |
└─ └─ Supported IP Versions AllowedProtocolMask The Internet Protocol versions that the system supports. Available in iOS 10.3 and later. Allowed values:
- `1`: IPv4
- `2`: IPv6
- `3`: Both | integer | optional | — | ✓Yes | iOS (10.3+) |
└─ └─ Supported Roaming IP Versions AllowedProtocolMaskInRoaming The Internet Protocol versions that the system supports while roaming. Available in iOS 10.3 and later. Allowed values:
- `1`: IPv4
- `2`: IPv6
- `3`: Both | integer | optional | — | ✓Yes | iOS (10.3+) |
└─ └─ Supported Roaming IP Versions AllowedProtocolMaskInDomesticRoaming The Internet Protocol versions that the system supports while roaming. Available in iOS 10.3 and later. Allowed values:
- `1`: IPv4
- `2`: IPv6
- `3`: Both | integer | optional | — | ✓Yes | iOS (10.3+) |
└─ └─ Enable XLAT464 EnableXLAT464 If `true`, the system enables XLAT464. Available in iOS 16 and later and watchOS 9 and later. | boolean | optional | false | ✓Yes | iOS (16.0+)watchOS (9.0+) |
