| Internet-Draft | NETCONF Transport Port Numbers | May 2025 |
| Boucadair | Expires 11 November 2025 | [Page] |
- Workgroup:
- Network Configuration
- Internet-Draft:
- draft-ietf-netconf-port-numbers-02
- Published:
- Intended Status:
- Standards Track
- Expires:
NETCONF Transport Port Numbers
Abstract
This document releases NETCONF-related port number IANA assignments that were made for inappropriate transport protocols or for Historic NETCONF-related protocols.¶
Discussion Venues
This note is to be removed before publishing as an RFC.¶
Discussion of this document takes place on the Network Configuration Working Group mailing list (netconf@ietf.org), which is archived at https://mailarchive.ietf.org/arch/browse/netconf/.¶
Source for this draft and an issue tracker can be found at https://github.com/boucadair/netconf-port-numbers.¶
Status of This Memo
This Internet-Draft is submitted in full conformance with the provisions of BCP 78 and BCP 79.¶
Internet-Drafts are working documents of the Internet Engineering Task Force (IETF). Note that other groups may also distribute working documents as Internet-Drafts. The list of current Internet-Drafts is at https://datatracker.ietf.org/drafts/current/.¶
Internet-Drafts are draft documents valid for a maximum of six months and may be updated, replaced, or obsoleted by other documents at any time. It is inappropriate to use Internet-Drafts as reference material or to cite them other than as "work in progress."¶
This Internet-Draft will expire on 11 November 2025.¶
Copyright Notice
Copyright (c) 2025 IETF Trust and the persons identified as the document authors. All rights reserved.¶
This document is subject to BCP 78 and the IETF Trust's Legal Provisions Relating to IETF Documents (https://trustee.ietf.org/license-info) in effect on the date of publication of this document. Please review these documents carefully, as they describe your rights and restrictions with respect to this document. Code Components extracted from this document must include Revised BSD License text as described in Section 4.e of the Trust Legal Provisions and are provided without warranty as described in the Revised BSD License.¶
1. Introduction
The "Service Name and Transport Protocol Port Number" registry [IANA-SERVICE] records several NETCONF-related port and service name assignments such as 830 for NETCONF over Secure Shell (SSH) [RFC6242], 831 for NETCONF over the Blocks Extensible Exchange Protocol (BEEP) [RFC4744], 832 for NETCONF over the Simple Object Access Protocol (SOAP) [RFC4743], 4334 for NETCONF Call Home [RFC8071], and 6513 for NETCONF over Transport Layer Security (TLS) [RFC7589][I-D.ietf-netconf-over-tls13].¶
However, many of these assignments are for a transport protocol (i.e., UDP) for which the requesting application does not apply. Also, many of the assignments are for protocols that are not deployed and were tagged as Historic: [RFC4743] and [RFC4744].¶
This document de-assigns these unused port numbers.¶
Consistent with Section 8.2 of [RFC6335], this document does not de-assign service names; only port numbers are de-assigned for better usage of available scarce resources.¶
2. Security Considerations
Releasing back some port numbers softens the exhaustion risk of available port number space (especially the System Ports range (Section 6 of [RFC6335])).¶
This document does not describe any protocol.¶
3. IANA Considerations
This document requests IANA to update the "Service Name and Transport Protocol Port Number Registry" registry [IANA-SERVICE] as specified in the following subsections.¶
-
Note to the RFC Editor: Please replace "THIS_DOCUMENT" with the RFC number to be assigned to this document.¶
3.1. NETCONF over SSH Service
OLD:¶
| Service Name | Port Number | Transport Protocol | Description | Reference |
|---|---|---|---|---|
| netconf-ssh | 830 | tcp | NETCONF over SSH | [RFC6242] |
| netconf-ssh | 830 | udp | NETCONF over SSH | [RFC6242] |
NEW:¶
| Service Name | Port Number | Transport Protocol | Description | Reference |
|---|---|---|---|---|
| netconf-ssh | 830 | tcp | NETCONF over SSH | [RFC6242] |
A note can be added to 830/udp to indicate that the port number used to be assigned to NETCONF over SSH but released by THIS_DOCUMENT.¶
3.2. NETCONF over BEEP Service
OLD:¶
| Service Name | Port Number | Transport Protocol | Description | Reference |
|---|---|---|---|---|
| netconf-beep | 831 | tcp | NETCONF over BEEP | [RFC4744] |
| netconf-beep | 831 | udp | NETCONF over BEEP | [RFC4744] |
NEW:¶
| Service Name | Port Number | Transport Protocol | Description | Reference |
|---|---|---|---|---|
| netconf-beep | NETCONF over BEEP | [RFC4744] THIS_DOCUMENT |
A note can be added to 831 to indicate that the port number used to be assigned to NETCONF over BEEP but released by THIS_DOCUMENT.¶
3.3. NETCONF over SOAP Service
OLD:¶
| Service Name | Port Number | Transport Protocol | Description | Reference |
|---|---|---|---|---|
| netconfsoaphttp | 832 | tcp | NETCONF for SOAP over HTTPS | [RFC4743] |
| netconfsoaphttp | 832 | udp | NETCONF for SOAP over HTTPS | [RFC4743] |
| netconfsoapbeep | 833 | tcp | NETCONF for SOAP over BEEP | [RFC4743] |
| netconfsoapbeep | 833 | udp | NETCONF for SOAP over BEEP | [RFC4743] |
NEW:¶
| Service Name | Port Number | Transport Protocol | Description | Reference |
|---|---|---|---|---|
| netconfsoaphttp | NETCONF for SOAP over HTTPS | [RFC4743] THIS_DOCUMENT | ||
| netconfsoapbeep | NETCONF for SOAP over BEEP | [RFC4743] THIS_DOCUMENT |
A note can be added to 832/833 to indicate that the port numbers used to be assigned to NETCONF over SOAP but released by THIS_DOCUMENT.¶
4. References
4.1. Normative References
- [RFC6335]
- Cotton, M., Eggert, L., Touch, J., Westerlund, M., and S. Cheshire, "Internet Assigned Numbers Authority (IANA) Procedures for the Management of the Service Name and Transport Protocol Port Number Registry", BCP 165, RFC 6335, DOI 10.17487/RFC6335, , <https://www.rfc-editor.org/rfc/rfc6335>.
4.2. Informative References
- [I-D.ietf-netconf-over-tls13]
- Turner, S. and R. Housley, "Updates to Using the NETCONF Protocol over Transport Layer Security (TLS) with Mutual X.509 Authentication", Work in Progress, Internet-Draft, draft-ietf-netconf-over-tls13-04, , <https://datatracker.ietf.org/doc/html/draft-ietf-netconf-over-tls13-04>.
- [IANA-SERVICE]
- "Service Name and Transport Protocol Port Number Registry", n.d., <https://www.iana.org/assignments/service-names-port-numbers/service-names-port-numbers.xhtml>.
- [RFC4743]
- Goddard, T., "Using NETCONF over the Simple Object Access Protocol (SOAP)", RFC 4743, DOI 10.17487/RFC4743, , <https://www.rfc-editor.org/rfc/rfc4743>.
- [RFC4744]
- Lear, E. and K. Crozier, "Using the NETCONF Protocol over the Blocks Extensible Exchange Protocol (BEEP)", RFC 4744, DOI 10.17487/RFC4744, , <https://www.rfc-editor.org/rfc/rfc4744>.
- [RFC6242]
- Wasserman, M., "Using the NETCONF Protocol over Secure Shell (SSH)", RFC 6242, DOI 10.17487/RFC6242, , <https://www.rfc-editor.org/rfc/rfc6242>.
- [RFC7589]
- Badra, M., Luchuk, A., and J. Schoenwaelder, "Using the NETCONF Protocol over Transport Layer Security (TLS) with Mutual X.509 Authentication", RFC 7589, DOI 10.17487/RFC7589, , <https://www.rfc-editor.org/rfc/rfc7589>.
- [RFC8071]
- Watsen, K., "NETCONF Call Home and RESTCONF Call Home", RFC 8071, DOI 10.17487/RFC8071, , <https://www.rfc-editor.org/rfc/rfc8071>.
Acknowledgments
Thanks to Amanda Baber and Zahed Sarker for the guidance.¶
Thanks to Kent Watsen for the Shepherd review.¶