💾 Archived View for gmi.noulin.net › rfc › rfc5618.gmi captured on 2024-08-25 at 08:20:07. Gemini links have been rewritten to link to archived content
⬅️ Previous capture (2022-01-08)
-=-=-=-=-=-=-
Updates:
Keywords: [--------], twamp-control protocol, twamp-test protocol, twamp modes
Network Working Group A. Morton
Request for Comments: 5618 AT&T Labs
Updates: 5357 K. Hedayat
Category: Standards Track EXFO
August 2009
Mixed Security Mode for the Two-Way Active Measurement Protocol (TWAMP)
Abstract
This memo describes a simple extension to TWAMP (the Two-Way Active
Measurement Protocol). The extension adds the option to use
different security modes in the TWAMP-Control and TWAMP-Test
protocols simultaneously. The memo also describes a new IANA
registry for additional features, called the TWAMP Modes registry.
Status of This Memo
This document specifies an Internet standards track protocol for the
Internet community, and requests discussion and suggestions for
improvements. Please refer to the current edition of the "Internet
Official Protocol Standards" (STD 1) for the standardization state
and status of this protocol. Distribution of this memo is unlimited.
Copyright Notice
Copyright (c) 2009 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 in effect on the date of
publication of this document (http://trustee.ietf.org/license-info).
Please review these documents carefully, as they describe your rights
and restrictions with respect to this document.
This document may contain material from IETF Documents or IETF
Contributions published or made publicly available before November
10, 2008. The person(s) controlling the copyright in some of this
material may not have granted the IETF Trust the right to allow
modifications of such material outside the IETF Standards Process.
Without obtaining an adequate license from the person(s) controlling
the copyright in such materials, this document may not be modified
outside the IETF Standards Process, and derivative works of it may
not be created outside the IETF Standards Process, except to format
it for publication as an RFC or to translate it into languages other
than English.
Morton & Hedayat Standards Track [Page 1]
RFC 5618 TWAMP Extensions August 2009
Table of Contents
1. Introduction ....................................................2
1.1. Requirements Language ......................................3
2. Purpose and Scope ...............................................3
3. TWAMP Control Extensions ........................................3
3.1. Extended Control Connection Setup ..........................3
4. Extended TWAMP Test .............................................5
4.1. Sender Behavior ............................................5
4.1.1. Packet Timings ......................................5
4.1.2. Packet Format and Content ...........................5
4.2. Reflector Behavior .........................................6
5. Security Considerations .........................................6
6. IANA Considerations .............................................6
6.1. Registry Specification .....................................6
6.2. Registry Management ........................................6
6.3. Experimental Numbers .......................................7
6.4. Initial Registry Contents ..................................7
7. Acknowledgements ................................................7
8. Normative References ............................................7
1. Introduction
The Two-Way Active Measurement Protocol (TWAMP) [RFC5357] is an
extension of the One-Way Active Measurement Protocol (OWAMP)
[RFC4656]. The TWAMP specification gathered wide review as it
approached completion, and the by-products were several
recommendations for new features in TWAMP. There is a growing number
of TWAMP implementations at present, and widespread usage is
expected. There are even devices that are designed to test
implementations for protocol compliance.
This memo describes a simple extension for TWAMP: the option to use
different security modes in the TWAMP-Control and TWAMP-Test
protocols (mixed security mode). It also describes a new IANA
registry for additional features, called the TWAMP Modes registry.
When the Server and Control-Client have agreed to use the mixed
security mode during control connection setup, then the Control-
Client, the Server, the Session-Sender, and the Session-Reflector
MUST all conform to the requirements of this mode as described in
Sections 3, 4, and 5.
This memo updates [RFC5357].
Morton & Hedayat Standards Track [Page 2]
RFC 5618 TWAMP Extensions August 2009
1.1. Requirements Language
The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT",
"SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this
document are to be interpreted as described in RFC 2119 [RFC2119].
2. Purpose and Scope
The purpose of this memo is to describe and specify an extension for
TWAMP [RFC5357], and to request the establishment of a registry for
future TWAMP extensions.
The scope of the memo is limited to specifications of the following:
o Extension of the modes of operation through assignment of one new
value in the Modes field (see Section 3.1 of [RFC4656]), while
retaining backward compatibility with TWAMP [RFC5357]
implementations. This value adds the OPTIONAL ability to use
different security modes in the TWAMP-Control and TWAMP-Test
protocols. The motivation for this extension is to permit the
low-packet-rate TWAMP-Control protocol to utilize a stronger mode
of integrity protection than that used in the TWAMP-Test protocol.
3. TWAMP Control Extensions
The TWAMP-Control protocol is a derivative of the OWAMP-Control
protocol, and coordinates a two-way measurement capability. All
TWAMP-Control messages are similar in format and follow similar
guidelines to those defined in Section 3 of [RFC4656], with the
exceptions described in TWAMP [RFC5357] and in the following
sections.
All OWAMP-Control messages apply to TWAMP-Control, except for the
Fetch-Session command.
3.1. Extended Control Connection Setup
TWAMP-Control connection establishment follows the same procedure
defined in Section 3.1 of [RFC4656]. This extended mode assigns one
new bit position (and value) to allow the Test protocol security mode
to operate in Unauthenticated mode, while the Control protocol
operates in Encrypted mode. With this extension, the complete set of
TWAMP Mode values are as follows:
Morton & Hedayat Standards Track [Page 3]
RFC 5618 TWAMP Extensions August 2009
Value Description Reference/Explanation
0 Reserved
1 Unauthenticated RFC 4656, Section 3.1
2 Authenticated RFC 4656, Section 3.1
4 Encrypted RFC 4656, Section 3.1
8 Unauth. TEST protocol, new bit position (3)
Encrypted CONTROL
In the original OWAMP and TWAMP Modes field, setting bit position 0,
1, or 2 indicated the security mode of the Control protocol, and the
Test protocol inherited the same mode (see Section 4 of [RFC4656]).
In this extension to TWAMP, when the Control-Client sets Modes Field
bit position 3, it SHALL discontinue the inheritance of the security
mode in the Test protocol, and each protocol's mode SHALL be as
specified below. When the desired TWAMP-Test protocol mode is
identical to the Control Session mode, the corresponding Modes Field
bit (position 0, 1, or 2) SHALL be set by the Control-Client. The
table below gives the various combinations of integrity protection
that are permissible in TWAMP (with this extension). The TWAMP-
Control and TWAMP-Test protocols SHALL use the mode in each column
corresponding to the bit position set in the Modes Field.
--------------------------------------------------------
Protocol | Permissible Mode Combinations (Modes bit set)
--------------------------------------------------------
Control | Unauth.(0)| Auth. == Encrypted (1,2,3)
--------------------------------------------------------
| Unauth.(0)| Unauth. (3)
-----------------------------------------------
Test | | Auth.(1)
-----------------------------------------------
| | Encrypted (2)
--------------------------------------------------------
Note that the TWAMP-Control protocol security measures are identical
in the Authenticated and Encrypted Modes. Therefore, only one new
bit position (3) is needed to convey the single mixed security mode.
The value of the Modes Field sent by the Server in the Server-
Greeting message is the bit-wise OR of the modes (bit positions) that
it is willing to support during this session. Thus, the last four
Morton & Hedayat Standards Track [Page 4]
RFC 5618 TWAMP Extensions August 2009
bits of the 32-bit Modes Field are used. When no other features are
activated, the first 28 bits MUST be zero. A client conforming to
this extension of [RFC5357] MAY ignore the values in the first 28
bits of the Modes Field, or it MAY support other features that are
communicated in these bit positions.
Other ways in which TWAMP extends OWAMP are described in [RFC5357].
4. Extended TWAMP Test
The TWAMP-Test protocol is similar to the OWAMP-Test protocol
[RFC4656] with the exception that the Session-Reflector transmits
test packets to the Session-Sender in response to each test packet it
receives. TWAMP [RFC5357] defines two different test packet formats:
one for packets transmitted by the Session-Sender and one for packets
transmitted by the Session-Reflector. As with the OWAMP-Test
protocol, there are three security modes that also determine the test
packet format: unauthenticated, authenticated, and encrypted. This
TWAMP extension makes it possible to use TWAMP-Test Unauthenticated
mode regardless of the mode used in the TWAMP-Control protocol.
When the Server has identified the ability to support the mixed
security mode, the Control-Client has selected the mixed security
mode in its Set-Up-Response, and the Server has responded with a zero
Accept field in the Server-Start message, these extensions are
REQUIRED.
4.1. Sender Behavior
This section describes extensions to the behavior of the TWAMP
Session-Sender.
4.1.1. Packet Timings
The send schedule is not utilized in TWAMP, and there are no
extensions defined in this memo.
4.1.2. Packet Format and Content
The Session-Sender packet format and content MUST follow the same
procedure and guidelines as defined in Section 4.1.2 of [RFC4656] and
Section 4.1.2 of [RFC5357], with the following exceptions:
o the send schedule is not used, and
o the Session-Sender MUST support the mixed security mode
(Unauthenticated TEST, Encrypted CONTROL, value 8, bit position 3)
defined in Section 3.1 of this memo.
Morton & Hedayat Standards Track [Page 5]
RFC 5618 TWAMP Extensions August 2009
4.2. Reflector Behavior
The TWAMP Session-Reflector is REQUIRED to follow the procedures and
guidelines in Section 4.2 of [RFC5357], with the following
extensions:
o the Session-Reflector MUST support the mixed security mode
(Unauthenticated TEST, Encrypted CONTROL, value 8, bit position 3)
defined in Section 3.1 of this memo.
5. Security Considerations
The extended mixed mode of operation permits stronger security/
integrity protection on the TWAMP-Control protocol while
simultaneously emphasizing accuracy or efficiency on the TWAMP-Test
protocol, thus making it possible to increase overall security when
compared to the previous options (when resource constraints would
have forced less security for TWAMP-Control and conditions are such
that use of unauthenticated TWAMP-Test is not a significant concern).
The security considerations that apply to any active measurement of
live networks are relevant here as well. See [RFC4656] and
[RFC5357].
6. IANA Considerations
This memo adds one security mode bit position/value beyond those in
the OWAMP-Control specification [RFC4656], and describes behavior
when the new mode is used. According to this document, IANA created
a registry for the TWAMP Modes field. This field is a recognized
extension mechanism for TWAMP.
6.1. Registry Specification
IANA created a TWAMP Modes registry. TWAMP Modes are specified in
TWAMP Server Greeting messages and Set-up Response messages
consistent with Section 3.1 of [RFC4656] and Section 3.1 of
[RFC5357], and extended by this memo. Modes are currently indicated
by setting single bits in the 32-bit Modes Field. However, more
complex encoding may be used in the future. Thus, this registry can
contain a total of 2^32 possible assignments.
6.2. Registry Management
Because the TWAMP Modes registry can contain a maximum of 2^32
values, and because TWAMP is an IETF protocol, this registry must be
updated only by "IETF Review" as specified in [RFC5226] (an RFC
documenting registry use that is approved by the IESG). For the
Morton & Hedayat Standards Track [Page 6]
RFC 5618 TWAMP Extensions August 2009
TWAMP Modes registry, we expect that new features will be assigned
using monotonically increasing single bit positions and in the range
[0-31], unless there is a good reason to do otherwise (more complex
encoding than single bit positions may be used in the future, to
access the 2^32 value space).
6.3. Experimental Numbers
No experimental values are currently assigned for the Modes Registry.
6.4. Initial Registry Contents
TWAMP Modes Registry
Value Description Semantics Definition
0 Reserved RFC 5618
1 Unauthenticated RFC 4656, Section 3.1
2 Authenticated RFC 4656, Section 3.1
4 Encrypted RFC 4656, Section 3.1
8 Unauth. TEST protocol, RFC 5618, Section 3.1
Encrypted CONTROL
7. Acknowledgements
The authors would like to thank Len Ciavattone and Joel Jaeggli for
helpful review and comments.
8. Normative References
[RFC2119] Bradner, S., "Key words for use in RFCs to Indicate
Requirement Levels", BCP 14, RFC 2119, March 1997.
[RFC4656] Shalunov, S., Teitelbaum, B., Karp, A., Boote, J., and M.
Zekauskas, "A One-way Active Measurement Protocol
(OWAMP)", RFC 4656, September 2006.
[RFC5226] Narten, T. and H. Alvestrand, "Guidelines for Writing an
IANA Considerations Section in RFCs", BCP 26, RFC 5226,
May 2008.
[RFC5357] Hedayat, K., Krzanowski, R., Morton, A., Yum, K., and J.
Babiarz, "A Two-Way Active Measurement Protocol (TWAMP)",
RFC 5357, October 2008.
Morton & Hedayat Standards Track [Page 7]
RFC 5618 TWAMP Extensions August 2009
Authors' Addresses
Al Morton
AT&T Labs
200 Laurel Avenue South
Middletown, NJ 07748
USA
Phone: +1 732 420 1571
Fax: +1 732 368 1192
EMail: acmorton@att.com
URI: http://home.comcast.net/~acmacm/
Kaynam Hedayat
EXFO
285 Mill Road
Chelmsford, MA 01824
USA
Phone: +1 978 367 5611
Fax: +1 978 367 5700
EMail: kaynam.hedayat@exfo.com
URI: http://www.exfo.com/
Morton & Hedayat Standards Track [Page 8]