Overview
ISO/IEC 29341-24-10:2017 defines the WANIPConnection v2 service for UPnP Internet Gateway Devices (IGD). Aligned with the UPnP Device Architecture 1.0, this standard specifies the network service used by a UPnP control point to configure and control IP connections and manage WAN interfaces (DSL, cable, etc.). It is a required service for a WANConnectionDevice that supports IP connections and is a component of the UPnP IGD Device Control Protocol.
Key topics and technical requirements
- Service model and XML description: Formal service type, state variables and action signatures in an XML service description compliant with UPnP Device Architecture.
- State variables: Definitions for connection-related variables such as ConnectionType, ConnectionStatus, ExternalIPAddress, PortMappingNumberOfEntries, NATEnabled, RSIPAvailable, Uptime, and error/state enumerations.
- Actions (control API): Standard actions include SetConnectionType(), GetConnectionTypeInfo(), RequestConnection(), RequestTermination(), ForceTermination(), GetExternalIPAddress(), AddPortMapping(), AddAnyPortMapping(), DeletePortMapping(), DeletePortMappingRange(), GetListOfPortMappings(), and others for managing auto/idle disconnect and port mappings.
- Port mapping and NAT control: Procedures and error codes for adding, listing, and deleting port mappings (port forwarding), lease durations, protocols, and port ranges.
- Eventing and moderation: Rules for state change event notifications (e.g., ExternalIPAddress, ConnectionStatus, PortMappingNumberOfEntries) so control points can react to gateway changes.
- Backward compatibility and Level 2 features: Clarifies changes from earlier WANIPConnection version(s) and compatibility behaviors.
Applications and who uses it
- Home and SOHO router vendors / CPE manufacturers: Implement this service in device firmware to expose WAN configuration and NAT/port-forwarding control to UPnP control points.
- Router firmware and SDK developers: Use the standard to implement compliant APIs and XML service descriptions.
- Application developers and UPnP control point authors: Enable automatic NAT traversal, remote access, and port mapping for games, VoIP, remote management, NAS, and IoT devices.
- Network integrators and system testers: Validate IGD behavior, eventing, and error handling against the standard to ensure interoperability.
Related standards
- ISO/IEC 29341 family - UPnP Device Architecture and related Device Control Protocol parts (Internet Gateway Device specifications).
- UPnP Device Architecture 1.0 (baseline architecture and requirements for UPnP services).
By following ISO/IEC 29341-24-10:2017, device makers and software developers ensure interoperable UPnP WAN IP connection control, consistent NAT/port-mapping behavior, and robust remote-access capabilities across Internet gateway devices.