<?xml version="1.0" encoding="iso-8859-1"?>
<!-- comment -->
<!DOCTYPE rfc SYSTEM "rfc2629.dtd"[]>
<?rfc toc="yes" ?>
<?rfc compact="yes" ?>
<?rfc sortrefs="no" ?>
<rfc ipr="trust200902" category="std" docName="draft-holmberg-sipcore-received-realm-03.txt" submissionType="IETF" xml:lang="en">
	<front>
		<title abbrev="received realm">
			Via header field parameter to indicate received realm
		</title>
		<author initials="C.H." surname="Holmberg" fullname="Christer Holmberg">
			<organization>Ericsson</organization>
			<address>
				<postal>
					<street>Hirsalantie 11</street>
					<code>02420</code>
					<city>Jorvas</city>
					<country>Finland</country>
				</postal>
				<email>christer.holmberg@ericsson.com</email>
			</address>
		</author>
		<author initials="J.Y." surname="Jiang" fullname="Yi Jiang "> 
			<organization>China Mobile</organization>
			<address>
				<postal>
					<street> No.32 Xuanwumen West Street </street>
					<code> Xicheng District 100053</code>
					<city>Beijing</city>
					<country>P.R. China</country>
				</postal>
				<email>jiangyi@chinamobile.com</email>
			</address>
		</author>
		<date year="2014" />
		<area>Transport</area>
		<workgroup>SIPCORE Working Group</workgroup>
		<keyword>SIP</keyword>
		<keyword>Via</keyword>
		<keyword>transit</keyword>
		<keyword>realm</keyword>
		<abstract>
			<t>
				This specification defines a new Session Initiation Protocol (SIP)
				Via header field parameter, "received-realm", which allows a SIP entity acting
				as an entry point to a transit network to indicate from which adjacent upstream
				network a SIP request is received, using a network realm value associated
				with the adjacent network.
			</t>
		</abstract>
	</front>
	<middle>
		<section title="Introduction" toc="default">
			<section title="General" toc="default">
				<t>
					When SIP sessions are established between networks belonging to different
					operators, or between interconnected networks belonging to the same operator
					(or enterprise), the SIP requests might traverse transit network.
				</t>
				<t>
					Such transit networks might provide different kind of services. In order
					to do that, a transit network often needs to know to which operator 
					(or enterprise) the adjacent upstream network, from which the SIP session
					initiation request is received, belongs.
				</t>
				<t>
					This specification defines a new Session Initiation Protocol (SIP)
					Via header field parameter, "received-realm", which allows a SIP entity acting
					as an entry point to a transit network to indicate from which adjacent upstream
					network a SIP request is received, using a network realm value associated
					with the adjacent network.
				</t>
				<t>
					NOTE: As the adjacent network can be an enterprise network, an Inter Operator 
					Identifier (IOI) cannot be used to identity the network, as IOIs are not 
					defined for enterprise networks.
				</t>
				<t>
					The following sections describe use-case where the information is needed.
				</t>
			</section>
			<section title="Use-Case: Transit Network Application Services" toc="default">
				<t>
					The 3rd Generation Partnership Project (3GPP) TS 23.228 specifies how an IP Multimedia Subsystem (IMS) 
					network can be used to provide transit funtionality. An operator can use its IMS
					network to provide transit functionality e.g. to non-IMS customers, to enterprise
					networks, and to other network operators.
				</t>
				<t>
					The transit network operator can provide application services to the networks
					for which it is providing transit functionality. Transit application services are 
					typically not provided per user basis, as the transit network does not have access 
					to the user profiles of the networks for which the application services are provided. 
					Instead, the application services are provided per served network. 
				</t>
				<t>				
					When a SIP entity that provides application services (e.g. an Application Server) 
					within a transit network receives a SIP request, in order to apply the correct 
					services it needs to know the adjacent upstream network from which the SIP request 
					is received.					
				</t>			
			</section>
			<section title="Use-Case: Transit Network Routing" toc="default">
				<t>
					A transit network operator normally interconnects to many diferent
   					operators, including other transit network operators, and provides
   					transit routing of SIP requests received from one operator network
   					towards the destination. The destination can be within an operator network
   					to which the transit network operator has a direct interconnect, or 
					within an operator network that only can be reached via one or more 
   					interconnected transit operators. 
				</t>
				<t>				
   					For each customer, i.e. interconnected network operator for which, 
   					the transit network operator routes SIP requests towards the
   					requested destination a set of transit routing polices are defined.
   					These policies are used to determine how a SIP request shall be routed 
   					towards the requested destination to meet the agreement the transit
   					network operator has with its customer.
				</t>
				<t>				 
   					When a SIP entity that performs the transit routing functionality
   					receives a SIP request, in order to apply the correct set of transit
   					routing policies, it needs to know from which of its 
   					customers, i.e. adjacent upstream network, the SIP request is 
   					received.
				</t>
			</section>
		</section>

		<section title="Applicability" toc="default">
			<t>
				The mechanism defined in this specification MUST only be used by SIP entities that
				are able to verify from which adjacent upstream network a SIP request is received.
			</t>
			<t>
				The mechanism for verifying from which adjacent upstream network a SIP request is
				received is outside the scope of this specification.
			</t>
		</section>
		
		<section title="Conventions" toc="default">
			<t>
				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 
				BCP 14, RFC 2119 <xref target="RFC2119" pageno="false" format="default" />.
			</t>
		</section>
		
		<section title="Definitions" toc="default">
			<t>
				SIP entity: SIP User Agent (UA), or SIP proxy, as defined in RFC 3261.
			</t>
			<t>
				Adjacent upstream SIP network: The adjacent SIP network in the direction 
				from which a SIP request is received.
			</t>						
			<t>
				Network entry point: A SIP entity on the border of network, which recieves SIP requests
				from adjacent upstream networks.
			</t>
			<t>
				Inter Operator Identifier (IOI): A globally unique identifier to correlate billing 
				information generated within the IP Multimedia Subsystem (IMS).			
			</t>
		</section>

		<section title="User Agent and Proxy behavior" anchor="sec-sipent" toc="default">
			<section title="General" anchor="sec-sipent-gen" toc="default">
				<t>
					This section describes how a SIP entity, acting as an entry point to
					a network, uses the "received-realm" Via header field parameter.
				</t>
			</section>			

			<section title="Behavior of a SIP entity acting as a network entry point" anchor="sec-sipent-recv" toc="default">
				<t>
					When a SIP entity, acting as a network entry point, forwards a SIP request, or initiates a SIP request
					on its own (e.g. a PSTN gateway), the SIP entity adds a Via header field to the SIP request, according
					to the procedures in RFC 3261 <xref target="RFC3261" pageno="false" format="default" />. In addition, if 
					the SIP entity is able to assert the adjacent upstream network, and if the SIP entity is aware of a network 
					realm value defined for that network, the SIP entity can add a "received-realm" Via header field parameter,
					conveying the network realm value, to the Via header field added to the SIP request.
				</t>
			</section>
		</section>
																
    	<section title="Examples" toc="default">
			<section title="Example 1" toc="default">
				<t>
					TBD
				</t>
				<figure>
					<preamble></preamble>
					<artwork><![CDATA[

Operator 1       T_EP                                  T_AS
		
- INVITE --------->
  Via: IP_UA		
                   - INVITE ---------------------------->
                     Via: IP_TEP; received-realm=operator_1.com
				     Via: IP_UA; received=IP_UA
		           
                   <- 200 OK ----------------------------
                      Via: IP_TEP; received-realm=operator_1.co
                      Via: IP_UA; received=IP_UA
				   
<- 200 OK------
   Via: IP_UA; received=IP_UA

					]]></artwork>
				</figure>
			</section>
			<section title="Example 2" toc="default">
				<t>
					TBD
				</t>
			</section>

		</section>

		<section title="Syntax" anchor="sec-syntax" toc="default">
			<section title="General" anchor="sec-syntax-gen" toc="default">
				<t>
					This section describes the syntax extensions to the ABNF syntax defined in 
					RFC 3261 <xref target="RFC3261" pageno="false" format="default"/>, by defining a new Via header field parameter, "received-realm". 
					The ABNF defined in this specification is conformant to RFC 5234 <xref 
					target="RFC5234" pageno="false" format="default"/>. "EQUAL" and "hostname"
					are defined in RFC 3261 <xref target="RFC3261" pageno="false" format="default"/>. 
					"DIGIT" is defined in RFC 5234 <xref target="RFC5234" pageno="false" format="default"/>

				</t>
			</section>
			<section title="ABNF" anchor="sec-syntax-abnf" toc="default">
                                <t>

                                </t>
				<figure>
					<preamble></preamble>
					<artwork><![CDATA[
via-params =/ received-realm

received-realm = "received-realm" EQUAL hostname 

					]]></artwork>
				</figure>
			</section>
		</section>
	    
		<section title="IANA Considerations" toc="default">
			<section title="'received-realm' Via header field parameter" anchor="sec-uri-param" toc="default">
				<t>
					This specification defines a new Via header field parameter
					called received-realm in the "Header Field Parameters and Parameter Values"
					sub-registry as per the registry created by <xref target="RFC3968" 
					pageno="false" format="default"/>. The syntax is defined in 
					<xref target="sec-syntax"/>. The required information is:
				</t>
				<figure>
					<preamble></preamble>
					<artwork><![CDATA[
                                               Predefined
Header Field            Parameter Name         Values      Reference
----------------------  ---------------------  ----------  ---------
Via                     received-realm         No          RFCXXXX

					]]></artwork>
				</figure>
			</section>
    	</section>

    	<section title="Security Considerations" anchor="sec-security" toc="default">
			<t>
				TBD
			</t>
		</section>
		
		<section title="Acknowledgements" anchor="sec-acks" toc="default">
			<t>
				TBD
			</t>
		</section>
		
		<section title="Change Log">
			<t>[RFC EDITOR NOTE: Please remove this section when publishing]</t>
			<t>
				Changes from draft-holmberg-received-realm-02
				<list style="symbols">
					<t>New version due to expiration.</t>
				</list>
			</t>
			<t>
				Changes from draft-holmberg-received-realm-01
				<list style="symbols">
					<t>New version due to expiration.</t>
				</list>
			</t>
			<t>
				Changes from draft-holmberg-received-realm-00
				<list style="symbols">
					<t>New version due to expiration.</t>
				</list>
			</t>
		</section>		
	</middle>
	
	<back>
		<references title="Normative References">
			<?rfc include="reference.RFC.2119"?>
			<?rfc include="reference.RFC.3261"?>
			<?rfc include="reference.RFC.5234"?>			
		</references>
		<references title="Informative References">	  
			<?rfc include="reference.RFC.3968"?>			
		</references>
	</back>
</rfc>