Internet-Draft "sip-trunking-capability" Link Type May 2023
Inamdar, et al. Expires 9 November 2023 [Page]
Network Working Group
Intended Status:
K. Inamdar
S. Narayanan
D. Engi
G. Salgueiro

The 'sip-trunking-capability' Link Relation Type


This informational document defines the 'sip-trunking-capability' link relation type that may be used by an enterprise telephony Session Initiation Protocol (SIP) network to retrieve a SIP trunking capability set document, which contains the capabilities and configuration requirements of an Internet Telephony Service Provider (ITSP). These technical requirements allow for seamless peering between SIP-based enterprise telephony networks and the ITSP.

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

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 9 November 2023.

Table of Contents

1. Introduction

RFC 8288 [RFC8288] defines a way of indicating relationships between resources on the Web. This document specifies the 'sip-trunking-capability' link relation type according to the rules of RFC 8288. Links with this relationship type can be used to exchange capability information between potential peer devices. In the event that systems require additional parameters and configuration to negotiate communication, a well-known URI can be utilized to deliver information to potential peers including machine-readable instructions and parameters needed for peering.

The 'sip-trunking-capability' link relation type may be used on web resources hosted by ITSPs to provide a structured and detailed capability set document. The capability set document [I-D.ietf-asap-sip-auto-peer] encapsulates a set of characteristics of an ITSP, which when retrieved by enterprise telephony network devices allows for automated establishment of SIP [RFC3261] trunking between the two telephony networks.

3. Example Usage

This section provides an example of possible use of the 'sip-trunking-capability' relation type. The enterprise network device solicits the location of the capability set document from the well-known URI hosted by the ITSP using the WebFinger protocol [RFC7033]. The following examples include line-breaks and indentation for clarity.

   GET /.well-known/webfinger?

The capability set document location is returned to the network device in the "href" attribute.

   HTTP/1.1 200 OK
   Access-Control-Allow-Origin: *
   Content-Type: application/jrd+json
      "subject" : "",
      "links" :
            "rel" : "sip-trunking-capability",
            "href" :""

The ITSP may use an authentication framework such as OAuth 2.0 [RFC6749] to determine the identity of the enterprise telephony network in order to provide the appropriate capability set document.

4. IANA Considerations

IANA has registered the 'sip-trunking-capability' link relation under the "Link Relation Types" registry, with a reference to this document, using the following template:

Relation Name:
Refers to a capability set document that defines parameters or configuration requirements for automated peering and communication channel negotiation of the Session Initiation Protocol (SIP).
[[NOTE TO RFC EDITOR: Please change XXXX to the number assigned to this specification, and remove this paragraph on publication.]]

5. Security Considerations

The 'sip-trunking-capability' relation type is not known to introduce any new security issues not already discussed in RFC 8288 for generic use of web linking mechanisms. However, it is recommended to exercise caution when publishing potentially sensitive capability information over unencrypted or unauthenticated channels. Additional security recommendations are outlined in the capability set document definition. See Security Considerations section in Automatic Peering for SIP Trunks [I-D.ietf-asap-sip-auto-peer].

6. Acknowledgements

This document resulted from the discussions in the ASAP working group, especially the detailed and thoughtful comments of Paul Jones, Marc Petit-Huguenin, Mark Nottingham, Cullen Jennings, Jonathan Rosenberg, Jon Peterson, Chris Wendt, Jean Mahoney, and Murray Kucherawy. Additional thanks to Joe Clarke, Tim Bray, Christopher Wood, Dan Romascanu, David Dong, Eric Vyncke, Robert Wilton, and Lars Eggert for their reviews and feedback.

7. References

7.1. Normative References

Nottingham, M., "Web Linking", RFC 8288, DOI 10.17487/RFC8288, , <>.

7.2. Informative References

Inamdar, K., Narayanan, S., and C. Jennings, "Automatic Peering for SIP Trunks", , <>.
Rosenberg, J., Schulzrinne, H., Camarillo, G., Johnston, A., Peterson, J., Sparks, R., Handley, M., and E. Schooler, "SIP: Session Initiation Protocol", RFC 3261, DOI 10.17487/RFC3261, , <>.
Berners-Lee, T., Fielding, R., and L. Masinter, "Uniform Resource Identifier (URI): Generic Syntax", STD 66, RFC 3986, DOI 10.17487/RFC3986, , <>.
Hardt, D., Ed., "The OAuth 2.0 Authorization Framework", RFC 6749, DOI 10.17487/RFC6749, , <>.
Jones, P., Salgueiro, G., Jones, M., and J. Smarr, "WebFinger", RFC 7033, DOI 10.17487/RFC7033, , <>.

Authors' Addresses

Kaustubh Inamdar
Sreekanth Narayanan
Derek Engi
Ann Arbor, MI
Gonzalo Salgueiro
7200-12 Kit Creek Rd.
Research Triangle Park, NC 27709