Internet Engineering Task Force SIP WG Internet Draft J.Rosenberg,H.Schulzrinne draft-ietf-sip-srv-04.txt dynamicsoft,Columbia U. January 24, 2002 Expires: July 2002 SIP: Locating SIP Servers STATUS OF THIS MEMO This document is an Internet-Draft and is in full conformance with all provisions of Section 10 of RFC2026. Internet-Drafts are working documents of the Internet Engineering Task Force (IETF), its areas, and its working groups. Note that other groups may also distribute working documents as Internet- Drafts. 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". The list of current Internet-Drafts can be accessed at http://www.ietf.org/ietf/1id-abstracts.txt To view the list Internet-Draft Shadow Directories, see http://www.ietf.org/shadow.html. Abstract The Session Initiation Protocol (SIP) uses DNS procedures to allow a client to resolve a SIP URI into the IP address, port, and transport protocol of the next hop to contact. It also uses DNS to allow a server to send a response to a backup client if the primary client has failed. This document describes those DNS procedures in detail. 1 Introduction The Session Initiation Protocol (SIP) [1] is a client-server protocol used for the initiation and management of communications sessions between users. SIP end systems are called user agents, and intermediate elements are known as proxy servers. A typical SIP configuration, referred to as the SIP "trapezoid" is shown in Figure 1. In this diagram, a caller in domain A (UA1) wishes to call Joe in J.Rosenberg,H.Schulzrinne [Page 1] Internet Draft sip-srv January 24, 2002 domain B (joe@B). To do so, it communicates with proxy 1 in its domain (domain A). Proxy 1 forwards the request to the proxy for the domain of the called party (domain B), which is proxy 2. Proxy 2 forwards the call to the called party, UA 2. ............................ .............................. . . . . . +-------+ . . +-------+ . . | | . . | | . . | Proxy |------------- | Proxy | . . | 1 | . . | 2 | . . | | . . | | . . / +-------+ . . +-------+ \ . . / . . \ . . / . . \ . . / . . \ . . / . . \ . . / . . \ . . / . . \ . . / . . \ . . +-------+ . . +-------+ . . | | . . | | . . | | . . | | . . | UA 1 | . . | UA 2 | . . | | . . | | . . +-------+ . . +-------+ . . Domain A . . Domain B . ............................ .............................. Figure 1: The SIP trapezoid J.Rosenberg,H.Schulzrinne [Page 2] Internet Draft sip-srv January 24, 2002 As part of this call flow, proxy 1 needs to determine a SIP server for domain B. To do this, proxy 1 makes use of DNS procedures, using both SRV [2] and NAPTR [3] records. This document describes the specific problems that SIP uses DNS to help solve, and provides a solution. 2 Problems DNS is Needed to Solve DNS is needed to help solve two aspects of the general call flow described in the Introduction. The first is for proxy 1 to discover the SIP server in domain B, in order to forward the call for joe@B. The second is for proxy 2 to identify a backup for proxy 1 in the event it fails after forwarding the request. For the first aspect, proxy 1 specifically needs to determine the IP address, port and transport protocol for the server in domain B. Transport Protocol is particularly noteworthy. Unlike many other protocols, SIP can run over a variety of transport protocols, including TCP, UDP, TLS/TCP and SCTP. Thus, clients need to be able to automatically determine which transport protocols are available. The proxy sending the request has a particular set of transport protocols it supports and a preference for using those transport protocols. Proxy 2 has its own set of transport protocols it supports, and relative preferences for those transport protocols. All proxies must implement both UDP and TCP, so that there is always an intersection of capabilities. Some form of DNS procedures are needed for proxy 1 to discover the available transport protocols for SIP services at domain B, and the relative preferences of those transport protocols. Proxy 1 intersects its list of supported transport protocols with those of proxy 2 and then chooses the protocol preferred by proxy 2. It is important to note that DNS lookups can be used multiple times throughout processing of a call. In general, an element that wishes to send a request (called a client) may need to perform DNS processing to determine the IP address, port, and transport protocol of a next hop element, called a server (it can be a proxy or a user agent). Such processing could, in principle, occur at every hop between elements. Since SIP is used for the establishment of interactive communications services, the time it takes to complete a transaction between a caller and called party is important. Typically, the time from when the caller initiates a call until the time the called party is alerted should be no more than a few seconds. Given that there can be multiple hops, each of which is doing DNS lookups in addition to other potentially time-intensive operations, the amount of time available for DNS lookups at each hop is limited. J.Rosenberg,H.Schulzrinne [Page 3] Internet Draft sip-srv January 24, 2002 Scalability and high availability are important in SIP. SIP services scale up through clustering techniques. Typically, in a realistic version of the network in Figure 1, proxy 2 would be a cluster of homogeneously configured proxies. DNS needs to provide the ability for domain B to configure a set of servers, along with prioritization and weights in order to provide a crude level of capacity-based load balancing. SIP assures high availability by having upstream elements detect failures. For example, assume that proxy 2 is implemented as a cluster of two proxies, proxy 2.1 and proxy 2.2. If proxy 1 sends a request to proxy 2.1 and the request fails, it retries the request by sending it to proxy 2.2. This request would fail, and that would be detected by proxy 1. Proxy 1 would then try proxy 2.2. In many cases, proxy 1 will not know which domains it will ultimately communicate with. That information would be known when a user actually makes a call to another user in that domain. Proxy 1 may never communicate with that domain again after the call completes. Proxy 1 may communicate with thousands of different domains within a few minutes, and proxy 2 could receive requests from thousands of different domains within a few minutes. Because of this "many-to-many" relationship, and the possibly long intervals between communications between a pair of domains, it is not generally possible for an element to maintain dynamic availability state for the proxies it will communicate with. When a proxy gets its first call with a particular domain, it will try the servers in that domain in some order until it finds one that is available. The identity of the available server would ideally be cached for some amount of time in order to reduce call setup delays of subsequent calls. The client cannot query a failed server continuously to determine when it becomes available again, since this does not scale. Furthermore, the availability state must eventually be flushed in order to redistribute load to recovered elements when they come back online. It is possible for elements to fail in the middle of a transaction. For example, after proxy 2 forwards the request to UA 2, proxy 1 fails. UA 2 sends its response to proxy 2, which tries to forward it to proxy 1, which is no longer available. The second aspect of the flow in the introduction for which DNS is needed, is for proxy 2 to identify a backup for proxy 1 that it can send the response to. This problem is more realistic in SIP than it is in other transactional protocols. The reason is that a SIP response can take a long time to be generated, because a human user frequently needs to be consulted in order to generate that response. As such, it is not uncommon for tens of seconds to elapse between a call request and its acceptance. 3 Terminology J.Rosenberg,H.Schulzrinne [Page 4] Internet Draft sip-srv January 24, 2002 In this document, the key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALLNOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" are to be interpreted as described in RFC 2119 [4] and indicate requirement levels for compliant SIP implementations. 4 Client Usage Usage of DNS differs for clients and for servers. This section discusses client usage. We assume that the client is stateful (either a UAC or a stateful proxy). Stateless proxies are discussed in Section 4.4. The procedures here are invoked when a client needs to send a request to a server identified by a SIP URI, or when an element wishes to send a request to a specific configured server, independent of the SIP URI (called an outbound proxy), but the outbound proxy is identified by a domain name instead of a numeric IP address. Frequently, this is because the URI is contained in the Request-URI of a request to be sent. The procedures defined here in no way affect this URI (i.e., the URI is not rewritten with the result of the DNS looksup), they only result in an IP address, port and transport protocol where the request can be sent. The procedures here MUST be done exactly once per transaction. That is, once a server has successfully been contacted (success is defined below), all retransmissions of the request and the ACK for non-2xx responses MUST be sent to the same host. Furthermore, a CANCEL for a particular request MUST be sent to the same host that the request was delivered to. Because the ACK request for 2xx responses constitutes a different transaction, there is no requirement that it be delivered to the same server that received the original request (indeed, if that server did not record-route, it will most definitely not get the ACK). If the request is being delivered to an outbound proxy, a temporary URI, used for purposes of this specification, is constructed. That URI is of the form sip:, where is the domain of the outbound proxy. We defined TARGET as the value of the maddr parameter of the URI, if present, otherwise, the host value of the hostport component of the URI. It identifies the domain to be contacted. We determine the transport protocol, port and IP address of a suitable instance of TARGET in Sections 4.1 and 4.2. 4.1 Selecting a Transport Protocol J.Rosenberg,H.Schulzrinne [Page 5] Internet Draft sip-srv January 24, 2002 First, the client selects a transport protocol. If the URI specifies a transport protocol in the transport parameter, that transport protocol MUST be used. Otherwise, if no transport protocol is specified, but the TARGET is a numeric IP address, the client SHOULD use UDP. Otherwise, if no transport protocol is specified, and the target is not a numeric IP address, the client SHOULD perform a NAPTR query for the domain in the SIP URI. The services relevant for the task of transport protocol selection are those with NAPTR service fields with values "SIP+D2x", where x is a letter that corresponds to a transport protocol supported by the domain. This specification defines D2U for UDP, D2T for TCP, D2S for SCTP and D2L for TLS over TCP. We also establish an IANA registry for NAPTR service name to transport protocol mappings. These NAPTR records provide a mapping from a domain to the SRV record for contacting a server with the specific transport protocol in the NAPTR services field. The resource record will contain a replacement value and an empty regular expression, which is the SRV record for that particular transport protocol. If the server supports multiple transport protocols, there will be multiple NAPTR records, each with a different service value. As per RFC 2915 [3], the client MUST discard any records whose services fields indicate transport protocols not supported by the client. The NAPTR processing in RFC 2915 will result in selection of a transport protocol (and an SRV record along with it) with most preferred transport protocol of the server that is supported by the client. As an example, consider example.com. A client wishes to contact a SIP server in example.com. It performs a NAPTR query for that domain, and the following records are returned: ;; order pref flags service regexp replacement IN NAPTR 90 50 "s" "SIP+D2T" "" _sip._tcp.school.edu IN NAPTR 100 50 "s" "SIP+D2U" "" _sip._udp.example.com IN NAPTR 110 50 "s" "SIP+D2S" "" tls-sip.example.com This indicates that the server supports TCP, UDP, and TLS, in that order. If the client supports UDP and TLS, UDP will be used, based on an SRV lookup of _sip._udp.example.com. It is not necessary for the domain suffixes in the replacement field J.Rosenberg,H.Schulzrinne [Page 6] Internet Draft sip-srv January 24, 2002 to match the domain of the original query (i.e., example.com above). However, for backwards compatibility with RFC 2543, a domain MUST maintain SRV records for the domain of the original query, even if the NAPTR record is in a different domain. As an example, even though the SRV record for TCP is _sip._tcp.school.edu, there MUST also be an SRV record at _sip._tcp.example.com. RFC 2543 will look up the SRV records for the domain directly. If these do not exist because the NAPTR replacement points to a different domain, the client will fail. If no NAPTR records are found, the client constructs SRV queries for those transport protocols it supports, and does a query for each. Queries are done using the service identifier "_sip". A particular transport is supported if the query is successful. The client MAY use any transport protocol it desires which is supported by the server. This is a change from RFC 2543, which used to merge the priority values across different SRV records. 4.2 Determining Port and IP Once the transport protocol has been determined, the next step is to determine the IP address and port. If TARGET is a numeric IP address, the client uses that address. If the URI also contains a port, it uses that port. If no port is specified, it uses the default port for the particular transport protocol. If the TARGET was not a numeric IP address, but a port is present in the URI, the client performs an A or AAAA record lookup of the domain name. The result will be a list of IP address, each of which can be contacted at the specific port from the URI and transport protocol determined previously. Processing then proceeds as described in Section 4.3 of this document. There is a weird case where, where the URI had a domain name and a port. SRV records will potentially be used to determine the transport protocol, based on the algorithms above, but A records used for the actual lookup. That seems odd. If the TARGET was not a numeric IP address, and no port was present J.Rosenberg,H.Schulzrinne [Page 7] Internet Draft sip-srv January 24, 2002 in the URI, the client performs an SRV query using the service identifier "_sip" and the transport protocol as determined from Section 4.1, as specified in RFC 2782 [2]. The procedures of RFC 2782, as described in the Section titled "Usage rules" are followed, augmented by the additional procedures of Section 4.3 of this document. This is a change. Previously, if the port was explicit, but with a value of 5060, SRV records were used. Now, A records will be used. A result of this is that the URL comparison rules need to change to reflect that sip:user@example.com and sip:user@example.com:5060 are NOT equivalent any longer. I think this should not cause any serious interoperability issues, but further consideration is needed. 4.3 Details of RFC 2782 Process RFC 2782 spells out the details of how a set of SRV records are sorted and then tried. However, it only states that the client should "try to connect to the (protocol, address, service)" without giving any details on what happens in the event of failure. Those details are described here for SIP. The client client MAY maintain a table indicating the status of a particular host (that is, whether it was ever successfully contacted, or whether attempts to contact it resulted in a failure). The table is indexed with the IP address, port, and transport for a particular host. If a particular host is listed with a status of "failed", that entry SHOULD be discarded after one hour, so that the host can be used once more if it has recovered. When processing the list of SRV entries (or A records, depending on how the URI was resolved), the client MAY remove any entries for hosts which are marked as "failed" in the table. The remaining entries are then tried according to RFC 2782. For SIP requests, failure occurs if the transaction layer reports a 503 error response or a transport failure of some sort (generally, due to ICMP errors or TCP connection failures). Failure also occurs if the transaction layer times out without ever having received any response, provisional or final (i.e., timer B or timer F fires). If a failure occurs, the client SHOULD create a new request, which is identical to the previous, but has a different value of the Via branch ID than the previous (and therefore constitutes a new SIP transaction). That request is sent to the next element in the list as specified by RFC 2782. J.Rosenberg,H.Schulzrinne [Page 8] Internet Draft sip-srv January 24, 2002 4.4 Consideration for Stateless Proxies The process of the previous sections is highly stateful. When a server is contacted successfully, all requests for the transaction, as well as CANCEL requests for that transaction, MUST go to the same server. The identity of the successfully contacted server is a form of transaction state. This presents a challenge for stateless proxies, which still need to meet the requirement for sending all requests in the transaction to the same server. The requirement is not difficult to meet in the simple case where there were no failures when attempting to contact a server. Whenever the stateless proxy receives the request, it performs the appropriate DNS queries as described above. Unfortunately, the procedures of RFC 2782 and RFC 2915 are not guaranteed to be deterministic. This is because records that contain the same priority and weight (in the case of SRV) or order and preference (in the case of NAPTR) have no specified order. The stateless proxy MUST define a deterministic order to the records in that case, using any algorithm at its disposal. One suggestion is to alphabetize them, for example. To make processing easier for stateless proxies, it is RECOMMENDED that domain administrators make the weights of SRV records with equal priority different (for example, using weights of 1000 and 1001 if two servers are equivalent, rather than assigning both a weight of 1000), and similarly for NAPTR records. If the first server is contacted successfully, the proxy can remain stateless. However, if the first server is not contacted successfully, and a subsequent server is, the proxy cannot remain stateless for this transaction. If it were stateless, a retransmission could very well go to a different server if the failed one recovers between retransmissions. As such, whenever a proxy does not successfully contact the first server, it SHOULD act as a stateful proxy. Unfortunately, it is still possible for a stateless proxy to deliver retransmissions to different servers, even if it follows the recommendations above. This can happen if the DNS TTLs expire in the middle of a transaction, and the entries had changed. This is unavoidable. Network implementors should be aware of this limitation, and not use stateless proxies that access DNS if this error is deemed critical. 5 Server Usage RFC 2543bis defines procedures for sending responses from a server back to the client. Typically, for unicast requests, the response is sent back to the source IP address where the request came from, using the port contained in the Via header. However, it is important to provide failover support when the client element fails between J.Rosenberg,H.Schulzrinne [Page 9] Internet Draft sip-srv January 24, 2002 sending the request and receiving the response. The procedures here are invoked when a server sends a response to the client and that response fails. "Fails" is defined here as any response which causes an ICMP error message to be returned, or when the transport connection the request came in on closes before the response can be sent. In these cases, the server examines the value of the sent-by construction in the topmost Via header. If it contains a numeric IP address, the server attempts to send the response to that address, using the transport protocol from the Via header, and the port from sent-by, if present, else the default for that transport protocol. If, however, the sent-by field contained a domain name and a port number, the server queries for A records with that name. It tries to send the response to each element on the resulting list of IP addresses, using the port from the Via, and the transport protocol from the Via. As in the client processing, the next entry in the list is tred if the one before it results in a failure. If, however, the sent-by field contained a domain name and no port, the server queries for SRV records using the service identifier "_sip" and the transport protocol from the topmost Via header. The resulting list is sorted as described in [2], and the response is sent to the topmost element on the new list described there. If that results in a failure, the next entry on the list is tried. 6 Constructing SIP URIs In many cases, and element needs to construct a SIP URI for inclusion in a Contact header in a REGISTER, or in a Record-Route header in an INVITE. According to [1], these URIs have to have the property that they resolve to the specific element that inserted them. However, if they are constructed with just an IP address, for example: sip:1.2.3.4 sip:user@foo.com;maddr=1.2.3.4 then should the element fail, there is no way to route the request or response through a backup. SRV provides a way to fix this. Instead of using an IP address, a domain name that resolves to an SRV record can be used: J.Rosenberg,H.Schulzrinne [Page 10] Internet Draft sip-srv January 24, 2002 sip:server23.provider.com sip:user@foo.com;maddr=server23.provider.com The SRV records for a particular target can be set up so that there is a single record with a low value for the priority field, and this record points to the specific element that constructed the URI. However, there are additional records with higher priority that point to backup elements that would be used in the event of failure. This allows the constraint of [1] to be met while allowing for robust operation. 7 Security Considerations The authors do not believe that this specification introduces any additional security issues beyond those already described in RFC 2782 and RFC 2915. 8 Registration of NATPR D2X Resolution Service Name: Domain Name to Transport Protocol * Mnemonic: D2X, where X is managed by an IANA registration process * Number of Operands: 1 * Type of Each Operand: Each operand is a domain * Format of Each Operand: Each operand is a domain name in standard format * Algorithm: Opaque * Input String: The domain name from the SIP URI being used to generate the NAPTR query. * Output: One or more SRV record keys * Constraints: All records MUST only use the S flag. The P flag is expressly forbidden. * Error Conditions: o No overlap in transport protocol between client and server * Security Considerations: none 9 IANA Considerations The usage of NAPTR records described here requires well known values for the service fields for each transport supported by SIP. The table of mappings from service field values to transport protocols is to be maintained by IANA. New entries in the table MAY be added at any time when new transport protocols become available. Such additions are subject to expert review. J.Rosenberg,H.Schulzrinne [Page 11] Internet Draft sip-srv January 24, 2002 The registration MUST include the following information: Service Field: The service field being registered. An example for a new fictitious transport protocol called NCTP might be "SIP+D2N". Protocol: The specific transport protocol associated with that service field. This MUST include the name and acronym for the protocol, along with reference to a document that describes the transport protocol. For example - "New Connectionless Transport Protocol (NCTP), RFC5766". Name and Contact Information: The name, address, email address and telephone number for the person performing the registration. The following values are to be placed into the registry: Services Field Protocol SIP+D2T TCP SIP+D2U UDP SIP+D2L TLS over TCP (RFC 2246) SIP+D2S SCTP (RFC 2960) 10 Changes Since -03 o Added IANA registration process. o Included text discussing the problem of DNS TTL expiration for stateless proxies. o Clarified that maintenance of the table of availability for servers is not a cache, and it is totally unrelated to DNS processing. o Changed the construction of the services field in NAPTR to include the transport protocol, so its SIP+D2X, where X depends on the transport protocol. o Relaxed the constraint that the domain suffix in the NAPTR records equal that of the target. o Added a section on how to construct URIs for insertion into Contact and Record-Route headers. J.Rosenberg,H.Schulzrinne [Page 12] Internet Draft sip-srv January 24, 2002 11 Acknowledgements The authors would like to thank Patrik Faltstrom for his useful comments. 12 Author's Addresses Jonathan Rosenberg dynamicsoft 72 Eagle Rock Avenue First Floor East Hanover, NJ 07936 email: jdrosen@dynamicsoft.com Henning Schulzrinne Columbia University M/S 0401 1214 Amsterdam Ave. New York, NY 10027-7003 email: schulzrinne@cs.columbia.edu 13 Bibliography [1] J. Rosenberg, H. Schulzrinne, et al. , "SIP: Session initiation protocol," Internet Draft, Internet Engineering Task Force, Oct. 2001. Work in progress. [2] A. Gulbrandsen, P. Vixie, and L. Esibov, "A DNS RR for specifying the location of services (DNS SRV)," Request for Comments 2782, Internet Engineering Task Force, Feb. 2000. [3] M. Mealling and R. Daniel, "The naming authority pointer (NAPTR) DNS resource record," Request for Comments 2915, Internet Engineering Task Force, Sept. 2000. [4] S. Bradner, "Key words for use in RFCs to indicate requirement levels," Request for Comments 2119, Internet Engineering Task Force, Mar. 1997. Full Copyright Statement Copyright (c) The Internet Society (2002). All Rights Reserved. J.Rosenberg,H.Schulzrinne [Page 13] Internet Draft sip-srv January 24, 2002 This document and translations of it may be copied and furnished to others, and derivative works that comment on or otherwise explain it or assist in its implementation may be prepared, copied, published and distributed, in whole or in part, without restriction of any kind, provided that the above copyright notice and this paragraph are included on all such copies and derivative works. However, this document itself may not be modified in any way, such as by removing the copyright notice or references to the Internet Society or other Internet organizations, except as needed for the purpose of developing Internet standards in which case the procedures for copyrights defined in the Internet Standards process must be followed, or as required to translate it into languages other than English. The limited permissions granted above are perpetual and will not be revoked by the Internet Society or its successors or assigns. This document and the information contained herein is provided on an "AS IS" basis and THE INTERNET SOCIETY AND THE INTERNET ENGINEERING TASK FORCE DISCLAIMS ALL WARRANTIES, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE INFORMATION HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. J.Rosenberg,H.Schulzrinne [Page 14]