ISO/IEC 29341-18-13:2011

ISO/IEC 29341-18-13
Edition 1.0 2011-08
INTERNATIONAL
STANDARD
colour
inside
Information technology – UPnP device architecture –
Part 18-13: Remote Access Device Control Protocol – Remote Access Transport
Agent Configuration Service
All rights reserved. Unless otherwise specified, no part of this publication may be reproduced or utilized in any form
or by any means, electronic or mechanical, including photocopying and microfilm, without permission in writing from
either IEC or IEC's member National Committee in the country of the requester.
If you have any questions about ISO/IEC copyright or have an enquiry about obtaining additional rights to this
publication, please contact the address below or your local IEC member National Committee for further information.

IEC Central Office
3, rue de Varembé
CH-1211 Geneva 20
Switzerland
Email: inmail@iec.ch
Web: www.iec.ch
About the IEC
The International Electrotechnical Commission (IEC) is the leading global organization that prepares and publishes
International Standards for all electrical, electronic and related technologies.

About IEC publications
The technical content of IEC publications is kept under constant review by the IEC. Please make sure that you have the
latest edition, a corrigenda or an amendment might have been published.
 Catalogue of IEC publications: www.iec.ch/searchpub
The IEC on-line Catalogue enables you to search by a variety of criteria (reference number, text, technical committee,…).
It also gives information on projects, withdrawn and replaced publications.
 IEC Just Published: www.iec.ch/online_news/justpub
Stay up to date on all new IEC publications. Just Published details twice a month all new publications released. Available
on-line and also by email.
 Electropedia: www.electropedia.org
The world's leading online dictionary of electronic and electrical terms containing more than 20 000 terms and definitions
in English and French, with equivalent terms in additional languages. Also known as the International Electrotechnical
Vocabulary online.
 Customer Service Centre: www.iec.ch/webstore/custserv
If you wish to give us your feedback on this publication or need further assistance, please visit the Customer Service
Centre FAQ or contact us:
Email: csc@iec.ch
Tel.: +41 22 919 02 11
Fax: +41 22 919 03 00
ISO/IEC 29341-18-13
Edition 1.0 2011-08
INTERNATIONAL
STANDARD
colour
inside
Information technology – UPnP device architecture –
Part 18-13: Remote Access Device Control Protocol – Remote Access Transport
Agent Configuration Service
INTERNATIONAL
ELECTROTECHNICAL
COMMISSION
PRICE CODE
S
ICS 35.200 ISBN 978-2-88912-641-5

29341-18-13 © ISO/IEC:2011(E)
CONTENTS
1  Overview and Scope . 4
1.1  Introduction . 4
1.2  Notation . 4
1.3  Vendor-defined Extensions . 5
1.4  References . 5
1.4.1  Normative References . 5
1.4.2  Informative References . 6
2  Service Modeling Definitions . 6
2.1  Service Type . 6
2.2  Terms and Abbreviations . 7
2.2.1  Abbrevia tions . 7
2.2.2  Terms . 7
2.3  RATAConfig Service Architecture . 8
2.4  State Vari ables . 8
2.4.1  State Variable Overview . 8
2.4.2  SystemInfo . 8
2.4.3  TransportAgentCapabilities . 9
2.4.4  CredentialDelivery . 9
2.4.5  CredentialsList . 9
2.4.6  ProfileList . 9
2.4.7  A_ARG_TYPE_ProfileConfigInfo . 10
2.4.8  A_ARG_TYPE_ProfileID . 10
2.5  Eventing and Moderation . 10
2.5.1  Relationships Between State Variables . 10
2.6  Actions . 10
2.6.1  GetTransportAgentCapabilities() . 11
2.6.2  GetSupportedCredentialDelivery() . 11
2.6.3  GetCredentialsList() . 12
2.6.4  GetProfileList() . 13
2.6.5  AddProfile() . 13
2.6.6  EditProfile() . 14
2.6.7  DeleteProfile() . 15
2.6.8  GetProfileConfigInfo() . 16
2.6.9  Error Code Summary . 16
2.7  Theory of Operation . 17
2.7.1  The Interaction Model . 17
2.7.2  Detecting the RATA Role . 17
2.7.3  Configuring Remote Access Transport Profile (Server) . 17
2.7.4  Configuring Remote Access Transport Profile (Client) . 18
2.7.5  Editing a Profile . 18
2.7.6  Deleting a Profile . 19
3  XML Service Description . 19
4  Test . . 22
Annex A (normative) RATransportAgent Data Structures . 23

XXX: © IEC:2010 — 2— 29341-18-13 © ISO/IEC:2011(E)
A.1  ProfileList Template . 23
A.2  ProfileConfig Template . 23
A.3  TransportAgentCapabilities Template . 24
A.4  CredentialDelivery Template . 25
A.5  CredentialsList Template . 26
A.6  TransportAgent Datastructure Schema . 27
Annex B (informative) Addressing Considerations . 28
B.1  IPv4 Considerations . 28
B.1.1  IPv4 Address Allocation . 28
B.1.2  Address Space Collisi ons. 28
Annex C (normative) Using IPsec as Remote Access Transport . 30
C.1  IPsec Templates . 30
C.1.1  IPsec Options Template . 30
C.1.2  IPsec Configuration Template . 31
C.2  Sample IPsec Files . 34
C.2.1  Sample IPSec based on certificates . 34
C.2.2  Sample IPSec based on shared key null policy . 37
C.2.3  Sample IPSec based on shared key advanced policy . 39
Annex D (normative) Using OpenVPN as Remote Access Transport . 42
D.1  OpenVPN Templates . 42
D.1.1  OpenVPN Configuration Templa te . 42
D.2  Sample OpenVPN configurat ion . 46
D.2.1  Sample configuration for Server . 46
D.2.2  Sample configuration for Client . 46

Figure 2-1 — The Interaction Model. . 17
Figure 2-2 — Configuring Remote Access Transport Profiles. . 18
Figure 2-3 — Editing Remote Access Transport Profiles . . 18
Figure 2-4 — Deleting Remote Access Transport Profiles. . 19
Figure B.1 — Address Space Collision Problem. . 28

Table 2-1 — Abbreviati ons . 7
Table 2-2 — State Variables . 8
Table 2-3 — Eventing and Moderation . 10
Table 2-4 — Actions . 10
Table 2-5 — Arguments for GetTransportAgentCapabilities() . 11
Table 2-6 — Error Codes for GetTransportAgentCapabilities() . 11
Table 2-7 — Arguments for GetSupportedCredentialDelivery() . 11
Table 2-8 — Error Codes for GetSupportedCredentialDelivery() . 12
Table 2-9 — Arguments for GetCredentialsList() . 12
Table 2-10 — Error Codes for GetCredentialsList() . 13
Table 2-11 — Arguments for GetProfileList() . 13
Table 2-12 — Error Codes for GetProfileList() . 13
Table 2-13 — Arguments for AddProfile() . 13
Table 2-14 — Error Codes for AddProfile() . 14
Table 2-15 — Arguments for EditProfile() . 14

29341-18-13 XXX: © IEC:2010 © ISO/IEC:2011(E) — 3—
Table 2-16 — Error Codes for EditProfile() . 15
Table 2-17 — Arguments for DeleteProfile() . 15
Table 2-18 — Error Codes for DeleteProfile() . 16
Table 2-19 — Arguments for GetProfileConfigInfo() . 16
Table 2-20 — Error Codes for GetProfileConfigInfo() . 16
Table 2-21 — Error Code Summary . 17

29341-18-13 © ISO/IEC:2011(E)
INFORMATION TECHNOLOGY –
UPNP DEVICE ARCHITECTURE –
Part 18-13: Remote Access Device Control Protocol –
Remote Access Transport Agent Configuration Service
FOREWORD
1) ISO (International Organization for Standardization) and IEC (International Electrotechnical Commission) form the
specialized system for worldwide standardization. National bodies that are members of ISO or IEC participate in
the development of International Standards. Their preparation is entrusted to technical committees; any ISO and
IEC member body interested in the subject dealt with may participate in this preparatory work. International
governmental and non-governmental organizations liaising with ISO and IEC also participate in this preparation.
2) In
...