Requirements for Marking SIP Messages to be Logged
RFC 8123
Internet Engineering Task Force (IETF) P. Dawes
Request for Comments: 8123 Vodafone Group
Category: Informational C. Arunachalam
ISSN: 2070-1721 Cisco Systems
March 2017
Requirements for Marking SIP Messages to be Logged
Abstract
SIP networks use signaling monitoring tools to debug customer-
reported problems and for regression testing if network or client
software is upgraded. As networks grow and become interconnected,
including connection via transit networks, it becomes impractical to
predict the path that SIP signaling will take between clients and,
therefore, impractical to monitor SIP signaling end-to-end.
This document describes the requirements for adding an indicator to
the SIP Protocol Data Unit (PDU) or a SIP message that marks the PDU
as a candidate for logging. Such a marking will typically be applied
as part of network testing controlled by the network operator and not
used in regular client signaling. However, such a marking can be
carried end-to-end, including the SIP terminals, even if a session
originates and terminates in different networks.
Status of This Memo
This document is not an Internet Standards Track specification; it is
published for informational purposes.
This document is a product of the Internet Engineering Task Force
(IETF). It represents the consensus of the IETF community. It has
received public review and has been approved for publication by the
Internet Engineering Steering Group (IESG). Not all documents
approved by the IESG are a candidate for any level of Internet
Standard; see Section 2 of RFC 7841.
Information about the current status of this document, any errata,
and how to provide feedback on it may be obtained at
http://www.rfc-editor.org/info/rfc8123.
Dawes & Arunachalam Informational [Page 1]
RFC 8123 Log Me" Marker March 2017
Copyright Notice
Copyright (c) 2017 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
(http://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 Simplified BSD License text as described in Section 4.e of
the Trust Legal Provisions and are provided without warranty as
described in the Simplified BSD License.
Table of Contents
1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . 3
2. Conventions Used in This Document . . . . . . . . . . . . . . 3
3. Terminology . . . . . . . . . . . . . . . . . . . . . . . . . 3
3.1. Network Boundary . . . . . . . . . . . . . . . . . . . . 3
3.2. Trust Domain . . . . . . . . . . . . . . . . . . . . . . 4
3.3. Intermediary . . . . . . . . . . . . . . . . . . . . . . 4
4. Motivating Scenario . . . . . . . . . . . . . . . . . . . . . 4
4.1. Introduction . . . . . . . . . . . . . . . . . . . . . . 4
4.2. Example Network Arrangement . . . . . . . . . . . . . . . 5
4.3. Example Debugging Procedure . . . . . . . . . . . . . . . 6
5. "Log Me" Marking Requirements . . . . . . . . . . . . . . . . 6
5.1. Message Logs . . . . . . . . . . . . . . . . . . . . . . 6
5.2. "Log Me" Marking . . . . . . . . . . . . . . . . . . . . 7
5.3. Processing the "Log Me" Marker . . . . . . . . . . . . . 7
6. Security Considerations . . . . . . . . . . . . . . . . . . . 8
6.1. Trust Domain . . . . . . . . . . . . . . . . . . . . . . 8
6.2. Security Threats . . . . . . . . . . . . . . . . . . . . 9
6.2.1. "Log Me" Marking . . . . . . . . . . . . . . . . . . 9
6.2.2. Logged Information . . . . . . . . . . . . . . . . . 9
7. IANA Considerations . . . . . . . . . . . . . . . . . . . . . 9
8. References . . . . . . . . . . . . . . . . . . . . . . . . . 9
8.1. Normative References . . . . . . . . . . . . . . . . . . 9
8.2. Informative References . . . . . . . . . . . . . . . . . 10
Acknowledgments . . . . . . . . . . . . . . . . . . . . . . . . . 10
Authors' Addresses . . . . . . . . . . . . . . . . . . . . . . . 11
Dawes & Arunachalam Informational [Page 2]
RFC 8123 Log Me" Marker March 2017
1. Introduction
Service providers, enterprises, and others who operate networks that
use SIP (see [RFC3261]) need the ability to debug problems reported
Show full document text