Internet Engineering Task Force SIP WG Internet Draft Schulzrinne/Rosenberg draft-ietf-sip-srv-02.txt Columbia U./dynamicsoft March 24, 2001 Expires: June 2001 SIP: Session Initiation Protocol -- 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 This document describes how a SIP client locates a SIP server based on the Request-URI or a preconfigured outbound proxy server. This document updates the process described in RFC 2543. 1 Introduction This document updates Sections 1.3 and 1.4.2 and supersedes Appendix D of RFC 2543 [1]. Inter alia, it defines the term outbound proxy and replaces references to the obsoleted RFC 2052 with current references to RFC 2782. 1.1 Terminology In this document, the key words "MUST", "MUST NOT", "REQUIRED", Schulzrinne/Rosenberg [Page 1] Internet Draft SIP March 24, 2001 "SHALL", "SHALLNOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" are to be interpreted as described in RFC 2119 [2] and indicate requirement levels for compliant SIP implementations. 1.2 Definitions Outbound proxy: A proxy that is located near the originator of requests. It receives all outgoing requests from a particular UAC, including those requests whose Request-URLs identify a host other than the outbound proxy. The outbound proxy sends these requests, after any local processing, to the address indicated in the Request-URI. (All other proxy servers are simply referred as proxies, not inbound proxies.) 2 Locating a SIP Server When a client wishes to send a request, the client either sends it to a locally configured SIP proxy server, the so-called outbound proxy , independent of the Request-URI, or sends it to the IP address and port corresponding to the Request-URI. The outbound proxy can be configured by any mechanism, including DHCP [3] and can be specified either as a set of parameters such as network address or host name, protocol port and transport protocol, or as a SIP URI. If the Request-URI is used, the client needs to determine the protocol, port and IP address of a server to which to send the request. A client SHOULD follow the steps below to obtain this information. Clients MUST re-run the above selection algorithm, re-drawing any random numbers involved, once per transaction rather than for each request, i.e., requests within the same transaction MUST be sent to the same network address. Thus, the same address is used for the request, any retransmissions, any associated CANCEL requests and ACK requests for non-2xx responses. However, ACKs for 2xx responses use another iteration of the selection algorithm. (Indeed, in many cases, they may have different request URIs.) A stateless proxy can accomplish this, for example, by using the modulo N of a hash of the Call-ID value or some other combination of transaction-identifying headers as the uniform random number described in the weighting algorithm of RFC 2782. Here, N is the sum of weights within the priority class. A client SHOULD be able to interpret explicit network notifications (such as ICMP messages) which indicate that a server is not reachable, rather than relying solely on timeouts. (For socket-based Schulzrinne/Rosenberg [Page 2] Internet Draft SIP March 24, 2001 programs: For TCP, connect() returns ECONNREFUSED if the client could not connect to a server at that address. For UDP, the socket needs to be bound to the destination address using connect() rather than sendto() or similar so that a second write() or send() fails with ECONNREFUSED if there is no server listening) If the client finds the server is not reachable at a particular address, it SHOULD behave as if it had received a 400-class error response to that request. The client tries to find one or more addresses for the SIP server by querying DNS. If a step elicits no addresses, the client continues to the next step. However if a step elicits one or more addresses, but no SIP server at any of those addresses responds, then the client concludes the server is down and does not continue on to the next step. If the client is configured with the address of an outbound proxy, the parameters of the outbound proxy, including transport protocol and port, become the destination used below. If there is no outbound proxy, the destination is the Request-URI. The destination address is the maddr parameter if it exists and the host element if not. The transport protocol is the transport parameter. The service identifier for DNS SRV records [4] is "_sip". 1. If the destination address is a numeric IP address, the client contacts the server at the given address and the port number specified in the SIP-URI or, if not specified, the default port (5060). If the destination specifies a protocol, the client contacts the server using that protocol. If no protocol is specified, the client first tries UDP. If attempt fails, or if the client does not support UDP but supports other protocols, it tries those protocols in some implementation-defined order. The client then skips the remaining steps. 2. If the destination specifies no port number or port number 5060, the transport protocol determines the use of one of the following three rules: - If the destination does not specify a transport protocol, DNS SRV records are retrieved according to RFC 2782 [4]. The results of the query or queries are merged and Schulzrinne/Rosenberg [Page 3] Internet Draft SIP March 24, 2001 ordered based on priority, keeping only records with transport protocols that the client supports. Then, the searching technique outlined in RFC 2782 [4] is used to select servers in order. Server selection across requests is independent of previous choices, except as noted above for stateless proxies. Message length or other request properties do not influence the server selection. The client attempts to contact each server in the order listed, at the port number specified in the SRV record. If none of the servers can be contacted, the client gives up. If there are no SRV records (with any transport protocol), DNS address records are used, as described below. - If a transport protocol is specified and this protocol is supported by the client, the procedure in the paragraph above is used, limited to DNS resource records with the transport protocol specified in the SIP-URI. - If the transport protocol specified is not supported by the client, the client gives up. If there are no SRV records, the next step applies. 3. If the destination specifies a port number other than 5060 or if there are no SRV records, the client queries the DNS server for address records for the destination address. Address records include A RR's, AAAA RR's, or other similar records, chosen according to the client's network protocol capabilities. If the DNS server returns no address records, the client gives up. If there are address records, the same rules as in step 2 apply. Clients MUST NOT cache query results except according to the rules in RFC 1035 [5]. 3 Security Considerations The security considerations in RFC 2543 [1] apply. 4 Authors' Addresses Henning Schulzrinne Dept. of Computer Science Columbia University 1214 Amsterdam Avenue Schulzrinne/Rosenberg [Page 4] Internet Draft SIP March 24, 2001 New York, NY 10027 USA electronic mail: schulzrinne@cs.columbia.edu Jonathan Rosenberg dynamicsoft 72 Eagle Rock Ave East Hanover, NJ 07936 USA electronic mail: jdrosen@dynamicsoft.com 5 Bibliography [1] M. Handley, H. Schulzrinne, E. Schooler, and J. Rosenberg, "SIP: session initiation protocol," Request for Comments 2543, Internet Engineering Task Force, Mar. 1999. [2] S. Bradner, "Key words for use in RFCs to indicate requirement levels," Request for Comments 2119, Internet Engineering Task Force, Mar. 1997. [3] G. Nair and H. Schulzrinne, "DHCP option for SIP servers," Internet Draft, Internet Engineering Task Force, Apr. 2000. Work in progress. [4] 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. [5] P. V. Mockapetris, "Domain names - implementation and specification," Request for Comments 1035, Internet Engineering Task Force, Nov. 1987. Full Copyright Statement Copyright (c) The Internet Society (2001). All Rights Reserved. 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 Schulzrinne/Rosenberg [Page 5] Internet Draft SIP March 24, 2001 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. Schulzrinne/Rosenberg [Page 6]