Back to browser

Cellular Private Network

com.apple.cellularprivatenetwork.managed

The payload that provides device info on private network deployments, including geographical location, preference over Wi-Fi, and network deployment type.

iOS

iOS 17.0+

Configuration Keys (7)

Key	Type	Title	Description	Default	Range
`Geofences`	array	—	A list of up to 1000 geofences for private networks. Geofencing is only used on iPhone.	—	—
`DataSetName`required	string	—	The name of the private network configuration data set.	—	—
`VersionNumber`required	string	—	The version number of this dataset that the system uses to track updates.	—	—
`CellularDataPreferred`	boolean	—	Set to 'true' to prefer this private network over Wi-Fi.	false	—
`EnableNRStandalone`	boolean	—	Set to 'true' if this private network is NR Standalone.	false	—
`NetworkIdentifier`	string	—	A string using the 3GPP "Coordinated NID" (option 1 or option 2) format (defined in 3GPP 31.102, Section 12.7.1). The device uses this value to match a SIM present on the device. All combinations of 'NetworkIdentifier' and 'CsgNetworkIdentifier' must be unique across all profiles installed on the device.	—	—
`CsgNetworkIdentifier`	string	—	A string using the 3GPP "CSG_ID" format (defined in 3GPP 23.003, Section 4.7). The device uses this value to match a SIM present on the device. All combinations of 'NetworkIdentifier' and 'CsgNetworkIdentifier' must be unique across all profiles installed on the device.	—	—
`GeofenceItem`	dict	—	A geofence for a private network.	—	—
`Longitude`required	real	—	The longitude of the geofence.	—
`Latitude`required	real	—	The latitude of the geofence.	—
`Radius`required	real	—	Specifies the radius of the geofence in meters. Set this value slightly greater than the private cellular network coverage area.	—
`GeofenceId`required	string	—	A geofence identifier that's unique within a list of geofences.	—	—