ISO_IEC_29341-24-10_2017-Character_PDF_documenten.pdf

Information technology UPnP Device Architecture Part 24-10:Internet gateway device control protocol Level 2 Wide area network internet protocol Connection serviceTechnologies de linformation Architecture de dispositif UPnP Partie 24-10:Protocole de contrle de dispositif de passerelle Internet Niveau 2 Protocole internet de rseau tendu Service de connexionINTERNATIONAL STANDARDISO/IEC 29341-24-10Reference numberISO/IEC 29341-24-10:2017(E)First edition2017-09 ISO/IEC 2017 ii ISO/IEC 2017 All rights reservedCOPYRIGHT PROTECTED DOCUMENT ISO/IEC 2017,Published in SwitzerlandAll rights reserved.Unless otherwise specified,no part of this publication may be reproduced or utilized otherwise in any form or by any means,electronic or mechanical,including photocopying,or posting on the internet or an intranet,without prior written permission.Permission can be requested from either ISO at the address below or ISOs member body in the country of the requester.ISO copyright officeCh.de Blandonnet 8 CP 401CH-1214 Vernier,Geneva,SwitzerlandTel.+41 22 749 01 11Fax+41 22 749 09 47copyrightiso.orgwww.iso.orgISO/IEC 29341-24-10:2017(E)ISO/IEC 29341-24-10:2017(E)ISO/IEC 2017 All rights reserved iii CONTENTS 1Scope.12Normative references.13Terms,definitions,symbols and abbreviated terms.24Notations and conventions.44.1Notation.44.2Data types.44.2.1Primary data types.44.2.2Secondary data types.54.3Vendor-defined extensions.65Service model.65.1Service type.65.2Changes from WANIPConnection:1.65.2.1Backward compatibility.65.2.2Generic requirements and other changes.65.2.3New state variables.65.2.4New actions.65.2.5Changes in existing actions and procedures.75.3Service Architecture.75.3.1Introduction.75.3.2Main feature sets.85.4State variables.95.4.1State variable overview.95.4.2ConnectionType.115.4.3PossibleConnectionTypes.115.4.4ConnectionStatus.115.4.5Uptime.125.4.6LastConnectionError.125.4.7AutoDisconnectTime.125.4.8IdleDisconnectTime.135.4.9WarnDisconnectDelay.135.4.10RSIPAvailable.135.4.11NATEnabled.135.4.12ExternalIPAddress.135.4.13PortMappingNumberOfEntries.135.4.14PortMappingEnabled.145.4.15PortMappingLeaseDuration.145.4.16RemoteHost.145.4.17ExternalPort.145.4.18InternalPort.155.4.19PortMappingProtocol.155.4.20InternalClient.155.4.21PortMappingDescription.155.4.22SystemUpdateID.155.4.23A_ARG_TYPE_Manage.16ISO/IEC 29341-24-10:2017(E)iv ISO/IEC 2017 All rights reserved 5.4.24A_ARG_TYPE_PortListing.165.5Eventing and Moderation.175.5.1Eventing of PossibleConnectionTypes.185.5.2Eventing of ConnectionStatus.185.5.3Eventing of ExternalIPAddress.185.5.4Eventing of PortMappingNumberOfEntries.185.5.5Eventing of SystemUpdateID.185.5.6Relationships among State Variables.185.6Actions.195.6.1SetConnectionType().205.6.2GetConnectionTypeInfo().215.6.3RequestConnection().225.6.4RequestTermination().235.6.5ForceTermination().245.6.6SetAutoDisconnectTime().255.6.7SetIdleDisconnectTime().265.6.8SetWarnDisconnectDelay().275.6.9GetStatusInfo().275.6.10GetAutoDisconnectTime().285.6.11GetIdleDisconnectTime().295.6.12GetWarnDisconnectDelay().305.6.13GetNATRSIPStatus().315.6.14GetGenericPortMappingEntry().315.6.15GetSpecificPortMappingEntry().335.6.16AddPortMapping().345.6.17AddAnyPortMapping().385.6.18DeletePortMapping().405.6.19DeletePortMappingRange().425.6.20GetExternalIPAddress().435.6.21GetListOfPortMappings().445.6.22Relationships Between Actions.455.6.23Error Code Summary.455.7Service Behavioral Model.475.7.1Connection Initiation.475.7.2Connection Termination.486XML Service Description.49Annex A(informative)Theory of Operation.61Annex B(informative)Bibliography.65 Figure 1 UPnP IGD component relationships for NAT processing.10Figure 2 Example of relationship between AddPortMapping()action and port triggering.35Figure 3 Summary of AddPortMapping()results.37Figure 4 Summary of AddAnyPortMapping()results.40Figure 5 State diagram for IP connection.47Figure A.1 NAT is an IP address translator.63Figure A.2 NAT issue with bundled session applications.64ISO/IEC 29341-24-10:2017(E)ISO/IEC 2017 All rights reserved v Table 1 CSV examples.5Table 2 State Variables.9Table 3 allowedValueList for the ConnectionType state variable.11Table 4 allowedValueList for the ConnectionStatus state variable.11Table 5 allowedValueList for the LastConnectionError state variable.12Table 6 allowedValueRange for the PortMappingLeaseDuration state variable.14Table 7 allowedValueRange for the InternalPort state variable.15Table 8 allowedValueList for the PortMappingProtocol state variable.15Table 9 Eventing and Moderation.17Table 10 Actions.19Table 11 Common parameters.19Table 12 Arguments for SetConnectionType().20Table 13 Error Codes for SetConnectionType().21Table 14 Arguments for GetConnectionTypeInfo().21Table 15 Error Codes for GetConnectionTypeInfo().22Table 16 Error Codes for RequestConnection().23Table 17 Error Codes for RequestTermination().24Table 18 Error Codes for ForceTermination().25Table 19 Arguments for SetAutoDisconnectTime().25Table 20 Error Codes for SetAutoD