Transcription of TECHNICAL REPORT - Broadband Forum
1 TECHNICAL REPORT 2007 The Broadband Forum . All rights reserved. TR-069 cpe wan management protocol Version: Issue 1 Amendment 2 Version Date: December 2007 cpe wan management protocol TR-069 Issue 1 Amendment 2 December 2007 The Broadband Forum . All rights reserved. 2 Notice The Broadband Forum is a non-profit corporation organized to create guidelines for Broadband network system development and deployment. This TECHNICAL REPORT has been approved by members of the Forum . This document is not binding on the Broadband Forum , any of its members, or any developer or service provider.
2 This document is subject to change, but only with approval of members of the Forum . This document is provided "as is," with all faults. Any person holding a copyright in this document, or any portion thereof, disclaims to the fullest extent permitted by law any representation or warranty, express or implied, including, but not limited to, (a) any warranty of merchantability, fitness for a particular purpose, non-infringement, or title; (b) any warranty that the contents of the document are suitable for any purpose, even if that purpose is known to the copyright holder; (c) any warranty that the implementation of the contents of the documentation will not infringe any third party patents, copyrights, trademarks or other rights.
3 This publication may incorporate intellectual property. The Broadband Forum encourages but does not require declaration of such intellectual property. For a list of declarations made by Broadband Forum member companies, please see cpe wan management protocol TR-069 Issue 1 Amendment 2 December 2007 The Broadband Forum . All rights reserved. 3 Version History Version Number Version Date Version Editor Changes Issue 1 May 2004 Jeff Bernstein, 2 Wire Tim Spets, Westell Issue 1 Issue 1 Amendment 1 November 2006 Jeff Bernstein, 2 Wire John Blackford, 2 Wire Mike Digdon, SupportSoft Heather Kirksey, Motive William Lupton, 2 Wire Anton Okmianski, Cisco Clarification of original document Issue 1 Amendment 2 November 2007 William Lupton, 2 Wire Davide Moreo, Telecom Italia CWMP.
4 Multicast Download support, 10 AUTONOMOUS TRANSFER COMPLETE event, AutonomousTransferComplete method, additional Download fault codes, interoperability clarifications, minor editorial changes. TECHNICAL comments or questions about this document should be directed to: William Lupton 2 Wire John Blackford 2 Wire Mike Digdon SupportSoft Editors Tim Spets Westell Greg Bathrick PMC-Sierra BroadbandHome TECHNICAL Working Group Chairs Heather Kirksey Motive cpe wan management protocol TR-069 Issue 1 Amendment 2 December 2007 The Broadband Forum . All rights reserved. 4 Contents 1 Introduction.
5 8 Functional Components .. 8 Auto-Configuration and Dynamic Service Provisioning .. 8 Software/Firmware Image management .. 8 Status and Performance 9 Diagnostics .. 9 Identity management for Web Applications .. 9 Positioning in the End-to-End Architecture .. 9 Security Goals .. 10 Architectural 10 11 11 Document Conventions .. 12 2 Architecture .. 12 protocol Components .. 12 Security Mechanisms .. 13 Architectural Components .. 13 Parameters .. 13 File Transfers .. 14 CPE Initiated 14 Asynchronous ACS Initiated 15 3 Procedures and Requirements .. 15 ACS Discovery.
6 15 Connection 17 CPE Connection Initiation .. 17 ACS Connection Initiation .. 18 Use of SSL/TLS and Use of 21 Encoding SOAP over HTTP .. 21 Transaction 22 File Transfers .. 23 Authentication .. 24 Digest Authentication .. 24 Additional HTTP 25 Use of SOAP .. 25 RPC Support Requirements .. 30 Transaction Session 30 CPE Operation .. 31 ACS Operation .. 37 Transaction 40 Normative References .. 42 Annex A. RPC Methods .. 44 Introduction .. 44 RPC Method Usage .. 44 Data Types .. 44 Other Requirements .. 45 Baseline RPC Messages .. 45 Generic Methods.
7 45 GetRPCM ethods .. 45 CPE Methods .. 46 SetParameterValues .. 47 48 GetParameterNames .. 49 SetParameterAttributes .. 51 GetParameterAttributes .. 55 AddObject .. 56 cpe wan management protocol TR-069 Issue 1 Amendment 2 December 2007 The Broadband Forum . All rights reserved. 5 58 Download .. 59 63 ACS Methods .. 64 TransferComplete .. 66 AutonomousTransferComplete .. 67 Optional RPC Messages .. 68 CPE Methods .. 68 68 ScheduleInform .. 69 SetVouchers .. 69 GetOptions ..70 73 73 ACS Methods .. 74 Kicked ..74 75 Fault Handling.
8 75 CPE Fault 75 ACS Fault 76 RPC Method XML Schema .. 77 Annex B. Removed .. 101 Annex C. Signed Vouchers .. 102 Overview .. 102 Control of Options Using Vouchers .. 102 Voucher 102 Annex D. Web Identity management .. 107 Overview .. 107 Use of the Kicked RPC Method .. 107 Web Identity management Procedures .. 107 LAN Side Interface .. 108 Annex E. Signed Package 110 Introduction .. 110 Signed Package Format Structure .. 110 Encoding Conventions .. 111 Header Format .. 111 Command List 111 Command Types .. 111 End Command .. 112 Extract and Add Remove Move Commands.
9 114 Version and Description 115 Timeout 115 Reboot Command .. 117 Format File System .. 117 Minimum and Maximum Version 117 Role Command .. 118 Minimum Storage Commands ..118 cpe wan management protocol TR-069 Issue 1 Amendment 2 December 2007 The Broadband Forum . All rights reserved. 6 Required Attributes Command .. 119 Signatures .. 119 Annex F. Device-Gateway 121 Introduction .. 121 121 121 Gateway Requirements ..122 Device Requirements .. 122 ACS 123 Device-Gateway Association Flows .. 124 DHCP Vendor Options ..125 Security Considerations .. 126 Annex G.
10 Connection Request via NAT 127 Introduction .. 127 127 CPE 128 Binding Discovery .. 128 Maintaining the 129 Communication of the Binding Information to the ACS .. 130 UDP Connection Requests .. 132 ACS 133 STUN Server Requirements .. 133 Determination of the Binding Information .. 133 UDP Connection Requests .. 134 Message Flows .. 135 Security Considerations .. 138 cpe wan management protocol TR-069 Issue 1 Amendment 2 December 2007 The Broadband Forum . All rights reserved. 7 Summary: A protocol for communication between a CPE and Auto-Configuration Server (ACS) that encompasses secure auto-configuration as well as other cpe management functions within a common framework.
