Contents

NetworkVPNIKEV2

The declaration to configure a VPN using the IKEv2 sub-type.

Declaration

object NetworkVPNIKEV2

Properties

NameTypeDescription
Authentication RequiredNetworkVPNIKEV2AuthenticationObject

Settings that control authentication.

ChildSecurityAssociationParametersNetworkVPNIKEV2SecurityAssociationParametersObject

The ChildSecurityAssociationParameters dictionaries.

DisableMOBIKEboolean

If true, the system disables MOBIKE.

DisableRedirectboolean

If true, the system disables IKEv2 redirect. If not set, the system redirects an IKEv2 connection when it receives a redirect request from the server.

DNSNetworkVPNIKEV2DNSObject

A dictionary to use for all VPN types.

EnableCertificateRevocationCheckboolean

If true, the system performs a certificate revocation check for IKEv2 connections. This is a best-effort revocation check and server response timeouts won’t cause it to fail.

EnableFallbackboolean

If true, the system enables a tunnel over cellular data to carry traffic that’s eligible for Wi-Fi Assist and also requires VPN.

Enabling fallback requires that the server support multiple tunnels for a single user.

Available: iOS 27+ | iPadOS 27+ | tvOS 27+ | visionOS 27+

EnablePFSboolean

If true, enables Perfect Forward Secrecy (PFS) for IKEv2 Connections.

EnforceStrictAlgorithmSelectionboolean

If set to true, the device doesn’t allow DES, 3DES, and Diffie-Hellman groups less than 14. Also the device requires the encryption algorithm specified in IKESecurityAssociationParameters to be at least as cryptographically strong as the algorithm specified in ChildSecurityAssociationParameters. The device rejects this configuration if these requirements aren’t met.

HostName Requiredstring

The IP address or hostname of the VPN server.

IdleNetworkVPNIKEV2IdleObject

Specifies details about how the system handles idle VPN connections.

IKESecurityAssociationParametersNetworkVPNIKEV2SecurityAssociationParametersObject

These parameters apply to Child Security Association unless ChildSecurityAssociationParameters is specified.

LocalIdentifier Requiredstring

Identifier of the IKEv2 client.

MTUinteger

The Maximum Transmission Unit (MTU) specifies the maximum size in bytes of each packet that the system sends over the IKEv2 VPN interface.

NetworkRoutingNetworkVPNIKEV2NetworkRoutingObject

Specifies details about how the VPN routes different types of network traffic.

Available: iOS 27+ | iPadOS 27+ | macOS 27+ | visionOS 27+

OnDemandNetworkVPNIKEV2OnDemandObject

Specifies details about how the system controls on-demand VPN.

PostQuantumKeyExchangeNetworkVPNIKEV2PostQuantumKeyExchangeObject

Post Quantum Key Exchange settings.

ProxiesNetworkVPNIKEV2ProxiesObject

The dictionary to use to configure Proxies for use with VPN.

RemoteIdentifier Requiredstring

The remote identifier.

UseConfigurationAttributeInternalIPSubnetboolean

If true, negotiations should use IKEv2 Configuration Attribute INTERNAL_IP4_SUBNET and INTERNAL_IP6_SUBNET.

VisibleName Requiredstring

The name of the VPN connection that the system displays on the device.

Discussion

Specify com.apple.configuration.network.vpn.ikev2 as the declaration type.

Configuration availability

Allowed in supervised enrollment

iOS, macOS, Shared iPad, tvOS, visionOS

Allowed in device enrollment

iOS, Shared iPad, tvOS, visionOS

Allowed in user enrollment

N/A

Allowed in local enrollment

iOS, macOS, Shared iPad, tvOS, visionOS

Allowed in system scope

iOS, macOS, Shared iPad, tvOS, visionOS

Allowed in user scope

macOS

Apply

Multiple configurations are applied separately

Configuration examples

Topics

Objects

See Also

Configurations