<?xml version="1.0" encoding="us-ascii"?>
  <?xml-stylesheet type="text/xsl" href="rfc2629.xslt" ?>
  <!-- generated by https://github.com/cabo/kramdown-rfc version 1.7.5 (Ruby 3.1.2) -->


<!DOCTYPE rfc  [
  <!ENTITY nbsp    "&#160;">
  <!ENTITY zwsp   "&#8203;">
  <!ENTITY nbhy   "&#8209;">
  <!ENTITY wj     "&#8288;">

<!ENTITY RFC8402 SYSTEM "https://bib.ietf.org/public/rfc/bibxml/reference.RFC.8402.xml">
<!ENTITY RFC8660 SYSTEM "https://bib.ietf.org/public/rfc/bibxml/reference.RFC.8660.xml">
<!ENTITY RFC8754 SYSTEM "https://bib.ietf.org/public/rfc/bibxml/reference.RFC.8754.xml">
<!ENTITY RFC8986 SYSTEM "https://bib.ietf.org/public/rfc/bibxml/reference.RFC.8986.xml">
<!ENTITY RFC9256 SYSTEM "https://bib.ietf.org/public/rfc/bibxml/reference.RFC.9256.xml">
<!ENTITY I-D.dawra-idr-bgp-sr-service-chaining SYSTEM "https://bib.ietf.org/public/rfc/bibxml3/reference.I-D.dawra-idr-bgp-sr-service-chaining.xml">
<!ENTITY I-D.xu-mpls-payload-protocol-identifier SYSTEM "https://bib.ietf.org/public/rfc/bibxml3/reference.I-D.xu-mpls-payload-protocol-identifier.xml">
<!ENTITY RFC7665 SYSTEM "https://bib.ietf.org/public/rfc/bibxml/reference.RFC.7665.xml">
<!ENTITY RFC8300 SYSTEM "https://bib.ietf.org/public/rfc/bibxml/reference.RFC.8300.xml">
<!ENTITY RFC8595 SYSTEM "https://bib.ietf.org/public/rfc/bibxml/reference.RFC.8595.xml">
]>


<rfc ipr="trust200902" docName="draft-ietf-spring-sr-service-programming-09" category="std" consensus="true" submissionType="IETF" tocInclude="true" sortRefs="true" symRefs="true">
  <front>
    <title>Service Programming with Segment Routing</title>

    <author initials="F." surname="Clad" fullname="Francois Clad" role="editor">
      <organization>Cisco Systems, Inc.</organization>
      <address>
        <postal>
          <country>France</country>
        </postal>
        <email>fclad.ietf@gmail.com</email>
      </address>
    </author>
    <author initials="X." surname="Xu" fullname="Xiaohu Xu" role="editor">
      <organization>China Mobile</organization>
      <address>
        <email>xuxiaohu@cmss.chinamobile.com</email>
      </address>
    </author>
    <author initials="C." surname="Filsfils" fullname="Clarence Filsfils">
      <organization>Cisco Systems, Inc.</organization>
      <address>
        <postal>
          <country>Belgium</country>
        </postal>
        <email>cf@cisco.com</email>
      </address>
    </author>
    <author initials="D." surname="Bernier" fullname="Daniel Bernier">
      <organization>Bell Canada</organization>
      <address>
        <postal>
          <country>Canada</country>
        </postal>
        <email>daniel.bernier@bell.ca</email>
      </address>
    </author>
    <author initials="C." surname="Li" fullname="Cheng Li">
      <organization>Huawei</organization>
      <address>
        <email>chengli13@huawei.com</email>
      </address>
    </author>
    <author initials="B." surname="Decraene" fullname="Bruno Decraene">
      <organization>Orange</organization>
      <address>
        <postal>
          <country>France</country>
        </postal>
        <email>bruno.decraene@orange.com</email>
      </address>
    </author>
    <author initials="S." surname="Ma" fullname="Shaowen Ma">
      <organization>Mellanox</organization>
      <address>
        <email>mashaowen@gmail.com</email>
      </address>
    </author>
    <author initials="C." surname="Yadlapalli" fullname="Chaitanya Yadlapalli">
      <organization>AT&amp;T</organization>
      <address>
        <postal>
          <country>USA</country>
        </postal>
        <email>cy098d@att.com</email>
      </address>
    </author>
    <author initials="W." surname="Henderickx" fullname="Wim Henderickx">
      <organization>Nokia</organization>
      <address>
        <postal>
          <country>Belgium</country>
        </postal>
        <email>wim.henderickx@nokia.com</email>
      </address>
    </author>
    <author initials="S." surname="Salsano" fullname="Stefano Salsano">
      <organization>Universita di Roma "Tor Vergata"</organization>
      <address>
        <postal>
          <country>Italy</country>
        </postal>
        <email>stefano.salsano@uniroma2.it</email>
      </address>
    </author>

    <date year="2024" month="February" day="20"/>

    <area>General</area>
    <workgroup>SPRING</workgroup>
    <keyword>Internet-Draft</keyword>

    <abstract>


<?line 183?>

<t>This document defines data plane functionality required to implement service segments and achieve service programming in SR-enabled MPLS and IPv6 networks, as described in the Segment Routing architecture.</t>



    </abstract>



  </front>

  <middle>


<?line 187?>

<section anchor="introduction"><name>Introduction</name>

<t>Segment Routing (SR) <xref target="RFC8402"/> is an architecture based on the source routing paradigm that seeks the right balance between distributed intelligence and centralized programmability.  SR can be used with an MPLS or an IPv6 data plane to steer packets through an ordered list of instructions, called segments.  These segments may encode simple routing instructions for forwarding packets along a specific network path, but also steer them through Virtual Network Functions (VNFs) or physical service appliances available in the network.</t>

<t>In an SR network, each of these services, running either on a physical appliance or in a virtual environment, are associated with a segment identifier (SID). These service SIDs are then leveraged as part of a SID-list to steer packets through the corresponding services.  Service SIDs may be combined together in a SID-list to achieve service programming, but also with other types of segments as defined in <xref target="RFC8402"/>.  SR thus provides a fully integrated solution for overlay, underlay and service programming. Furthermore, the IPv6 instantiation of SR (SRv6) <xref target="RFC8986"/> supports metadata transportation in the Segment Routing Header <xref target="RFC8754"/>, either natively in the tag field or with extensions such as TLVs.</t>

<t>This document describes how a service can be associated with a SID, including legacy services with no SR capabilities, and how these service SIDs are integrated within an SR policy. The definition of an SR Policy and the traffic steering mechanisms are covered in <xref target="RFC9256"/> and hence outside the scope of this document.</t>

<t>The definition of control plane components, such as service segment discovery, is outside the scope of this data plane document.  For reference, the option of using BGP extensions to support SR service programming is proposed in <xref target="I-D.dawra-idr-bgp-sr-service-chaining"/>.</t>

</section>
<section anchor="terminology"><name>Terminology</name>

<t>This document leverages the terminology proposed in <xref target="RFC8402"/>, <xref target="RFC8660"/>, <xref target="RFC8754"/>, <xref target="RFC8986"/> and <xref target="RFC9256"/>.  It also introduces the following new terms.</t>

<t>Service segment: A segment associated with a service. The service may either run on a physical appliance or in a virtual environment such as a virtual machine or container.</t>

<t>SR-aware service: A service that is fully capable of processing SR traffic. An SR-aware service can be directly associated with a service segment.</t>

<t>SR-unaware service: A service that is unable to process SR traffic or may behave incorrectly due to presence of SR information in the packet headers. An SR-unaware service can be associated with a service segment through an SR proxy function.</t>

</section>
<section anchor="classification-and-steering"><name>Classification and Steering</name>

<t>Classification and steering mechanisms are defined in section 8 of <xref target="RFC9256"/> and are independent from the purpose of the SR policy.  From the perspective of a headend node classifying and steering traffic into an SR policy, there is no difference whether this policy contains IGP, BGP, peering, VPN or service segments, or any combination of these.</t>

<t>As documented in the above reference, traffic is classified when entering an SR domain.  The SR policy headend may, depending on its capabilities, classify the packets on a per-destination basis, via simple FIB entries, or apply more complex policy routing rules requiring to look deeper into the packet.  These rules are expected to support basic policy routing such as 5-tuple matching.  In addition, the IPv6 SRH tag field defined in <xref target="RFC8754"/> can be used to identify and classify packets sharing the same set of properties.  Classified traffic is then steered into the appropriate SR policy and forwarded as per the SID-list(s) of the active candidate path.</t>

<t>SR traffic can be re-classified by an SR endpoint along the original SR policy (e.g., DPI service) or a transit node intercepting the traffic.  This node is the head-end of a new SR policy that is imposed onto the packet, either as a stack of MPLS labels or as an IPv6 SRH.</t>

</section>
<section anchor="service-segments"><name>Service Segments</name>

<t>In the context of this document, the term service refers to a physical appliance running on dedicated hardware, a virtualized service inside an isolated environment such as a Virtual Machine (VM), container or namespace, or any process running on a compute element.  A service may also comprise multiple sub-components running in different processes or containers.  Unless otherwise stated, this document does not make any assumption on the type or execution environment of a service.</t>

<t>The execution of a service can be integrated as part of an SR policy by assigning a segment identifier, or SID, to the service and including this service SID in the SR policy SID-list.  Such a service SID may be of local or global significance. In the former case, other segments, such as prefix or adjacency segments, can be used to steer the traffic up to the node where the service segment is instantiated. In the latter case, the service is directly reachable from anywhere in the routing domain.  This is realized with SR-MPLS by assigning a SID from the global label block (<xref target="RFC8660"/>), or with SRv6 by advertising the SID locator in the routing protocol (<xref target="RFC8986"/>).  It is up to the network operator to define the scope and reachability of each service SID.  This decision can be based on various considerations such as infrastructure dynamicity, available control plane or orchestration system capabilities.</t>

<t>This document categorizes services in two types, depending on whether they are able to behave properly in the presence of SR information or not. These are respectively named SR-aware and SR-unaware services.</t>

<section anchor="sr-aware-services"><name>SR-Aware Services</name>

<t>An SR-aware service can process the SR information in the packets it receives. This means being able to identify the active segment as a local instruction and move forward in the segment list, but also that the service&#39;s own behavior is not hindered due to the presence of SR information.  For example, an SR-aware firewall filtering SRv6 traffic based on its final destination must retrieve that information from the last entry in the SRH rather than the Destination Address field of the IPv6 header.</t>

<t>An SR-aware service is associated with a locally instantiated service segment, which is used to steer traffic through it.</t>

<t>If the service is configured to intercept all the packets passing through the appliance, the underlying routing system only has to implement a default SR endpoint behavior (e.g., SR-MPLS node segment or SRv6 End behavior), and the corresponding SID will be used to steer traffic through the service.</t>

<t>If the service requires the packets to be directed to a specific virtual interface, networking queue or process, a dedicated SR behavior may be required to steer the packets to the appropriate location.  The definition of such service-specific functions is out of the scope of this document.</t>

<t>SR-aware services also enable advanced network programming functionalities such as conditional branching and jumping to arbitrary SIDs in the segment list. In addition, SRv6 provides several ways of passing and exchanging information between services (e.g., SID arguments, tag field and TLVs). An example scenario involving these features is described in <xref target="IFIP18"/>, which discusses the implementation of an SR-aware Intrusion Detection System.</t>

<t>Examples of SR-aware services are provided in section <xref target="sec-implem-aware"/>.</t>

</section>
<section anchor="sr-unaware-services"><name>SR-Unaware Services</name>

<t>Any service that does not meet the above criteria for SR-awareness is considered as SR-unaware.</t>

<t>An SR-unaware service is not able to process the SR information in the traffic that it receives.  It may either drop the traffic or take erroneous decisions due to the unrecognized routing information.  In order to include such services in an SR policy, it is thus required to remove the SR information as well as any other encapsulation header before the service receives the packet, or to alter it in such a way that the service can correctly process the packet.</t>

<t>In this document, we define the concept of an SR proxy as an entity, separate from the service, that performs these modifications and handle the SR processing on behalf of a service.  The SR proxy can run as a separate process on the service appliance, on a virtual switch or router on the compute node or on a different host.</t>

<t>An SR-unaware service is associated with a service segment instantiated on the SR proxy, which is used to steer traffic through the service. <xref target="sec-proxies"/> describes several SR proxy behaviors to handle the encapsulation headers and SR information under various circumstances.</t>

</section>
</section>
<section anchor="sr-service-policies"><name>SR Service Policies</name>

<t>An SR service policy is an SR policy, as defined in <xref target="RFC9256"/>, that includes at least one service. This service is represented in the SID-list by its associated service SID. In case the policy should include several services, the service traversal order is indicated by the relative position of each service SID in the SID-list. Using the mechanisms described in <xref target="RFC9256"/>, it is possible to load balance the traffic over several services, or instances of the same service, by associating with the SR service policy a weighted set of SID-lists, each containing a possible sequence of service SIDs to be traversed. Similarly, several candidate paths can be specified for the SR service policy, each with its own set of SID-lists, for resiliency purposes.</t>

<t>Furthermore, binding SIDs (BSIDs) <xref target="RFC8402"/> can be leveraged in the context of service policies to reduce the number of SIDs imposed by the headend, provide opacity between domains and improve scalability. For example, a network operator may want a policy in its core domain to include services that are running in one of its datacenters. One option is to define an SR policy at ingress edge of the core domain that explicitly includes all the SIDs needed to steer the traffic through the core and in the DC, but that may result in a long SID-list and requires to update the ingress edge configuration every time the DC part of the policy is modified. Alternatively, a separate policy can be defined at the ingress edge of the datacenter with only the SIDs that needs to be executed there and its BSID included in the core domain policy. That BSID remains stable when the DC policy is modified and can even be shared among several core domain policies that would require the same type of processing in the DC.</t>

<t>This section describes how services can be integrated within an SR-MPLS or SRv6 service policy.</t>

<figure title="SR service policy" anchor="fig-policy"><artwork><![CDATA[
     +------------------------------------------+
     |               SR network                 |
     |                                          |
+----+----+          +---------+           +----+-----+
|    H    +----------+    S    +-----------+    E     |
|(headend)|          |(service)|           |(endpoint)|
+----+----+          +---------+           +----+-----+
     |  =====================================>  |
     |     P1(H,E,C)                            |
     +------------------------------------------+
]]></artwork></figure>

<t><xref target="fig-policy"/> illustrates a basic SR service policy instantiated on a headend node H towards an endpoint E and traversing a service S. The SR policy may also include additional requirements, such as traffic engineering or VPN. On the head-end H, the SR policy P1 is created with a color C and endpoint E and associated with an SR path that can either be explicitly configured, dynamically computed on H or provisioned by a network controller.</t>

<t>In its most basic form, the SR policy P1 would be resolved into the SID-list &lt; SID(S), SID(E) &gt;. This is assuming that SID(S) and SID(E) are directly reachable from H and S, respectively, and that the forwarding path meets the policy requirement. However, depending on the dataplane and the segments available in the network, additional SIDs may be required to enforce the SR policy.</t>

<t>This model applies regardless of the SR-awareness of the service. If it is SR-unaware, then S simply represents the proxy that takes care of transmitting the packet to the actual service.</t>

<t>Traffic can then be steered into this policy using any of the mechanisms described in <xref target="RFC9256"/>.</t>

<t>The following subsections describe the specificities of each SR dataplane.</t>

<section anchor="sec-policy-mpls"><name>SR-MPLS Data Plane</name>

<figure title="Packet walk in an SR-MPLS network" anchor="fig-policy-mpls"><artwork><![CDATA[
     +-----------------------------------------------+
     |                SR-MPLS network                |
     |                                               |
+----+----+   ------>   +---------+   ------>   +----+-----+
|    H    +-------------+    S    +-------------+    E     |
|(headend)|             |(service)|             |(endpoint)|
+----+----+             +---------+             +----+-----+
     |    (1)         (2)         (3)         (4)    |
     |+---------+ +---------+ +---------+ +---------+|
     ||   ...   | |  L(S)   | |   ...   | |  L(E)   ||
     |+---------+ +---------+ +---------+ +---------+|
     ||  L(S)   | |   ...   | |  L(E)   | |Inner pkt||
     |+---------+ +---------+ +---------+ +---------+|
     ||   ...   | |  L(E)   | |Inner pkt|            |
     |+---------+ +---------+ +---------+            |
     ||  L(E)   | |Inner pkt|                        |
     |+---------+ +---------+                        |
     ||Inner pkt|                                    |
     |+---------+                                    |
     +-----------------------------------------------+
]]></artwork></figure>

<t>In an SR-MPLS network, the SR policy SID-list is encoded as a stack of MPLS labels <xref target="RFC8660"/> and pushed on top of the packet.</t>

<t>In the example shown on <xref target="fig-policy-mpls"/>, the SR policy should steer the traffic from the head-end H to the endpoint E via a service S. This translates into an MPLS label stack that includes at least a label L(S) associated to service S and a label L(E) associated to the endpoint E. The label stack may also include additional intermediate SIDs if these are required for traffic engineering (e.g., to encode a low latency path between H and S and / or between S and E) or simply for reachability purposes. Indeed, the service SID L(S) may be taken from the global or local SID block of node S and, in the latter case, one or more SIDs might be needed before L(S) in order for the packet to reach node S (e.g., a prefix-SID of S), where L(S) can be interpreted. The same applies for the SID L(E) at the SR policy endpoint.</t>

<t>Special consideration must be taken into account when using Local SIDs for service identification due to increased label stack depth and the associated impacts.</t>

<t>When the packet arrives at S, this node determines the MPLS payload type and the appropriate behavior for processing the packet based on the semantic locally associated to the top label L(S). If S is an SR-aware service, the SID L(S) may provide additional context or indication on how to process the packet (e.g., a firewall SID may indicate which rule set should be applied onto the packet). If S is a proxy in front of an SR-unaware service, L(S) indicates how and to which service attached to this proxy the packet should be transmitted. At some point in the process, L(S) is also popped from the label stack in order to expose the next SID, which may be L(E) or another intermediate SID.</t>

</section>
<section anchor="sec-policy-srv6"><name>SRv6 Data Plane</name>

<figure title="Packet walk in an SRv6 network" anchor="fig-policy-srv6"><artwork><![CDATA[
     +-----------------------------------------------+
     |                 SRv6 network                  |
     |                                               |
+----+----+   ------>   +---------+   ------>   +----+-----+
|    H    +-------------+    S    +-------------+    E     |
|(headend)|             |(service)|             |(endpoint)|
+----+----+             +---------+             +----+-----+
     |    (1)         (2)         (3)         (4)    |
     |+---------+ +---------+ +---------+ +---------+|
     ||IP6(H,..)| |IP6(H, S)| |IP6(H,..)| |IP6(H, E)||
     |+---------+ +---------+ +---------+ +---------+|
     ||SRH(E,..,| |SRH(E,..,| |SRH(E,..,| |SRH(E,..,||
     ||    S,..;| |    S,..;| |    S,..;| |    S,..;||
     ||    SL=i)| |    SL=j)| |    SL=k)| |    SL=0)||
     |+---------+ +---------+ +---------+ +---------+|
     ||Inner pkt| |Inner pkt| |Inner pkt| |Inner pkt||
     |+---------+ +---------+ +---------+ +---------+|
     +-----------------------------------------------+
]]></artwork></figure>

<t>In an SRv6 network, the SR Policy is encoded into the packet as an IPv6 header possibly followed by a Segment Routing Header (SRH) <xref target="RFC8754"/>.</t>

<t>In the example shown on <xref target="fig-policy-srv6"/>, the SR policy should steer the traffic from the head-end H to the endpoint E via a service S. This translates into Segment-List that includes at least a segment SID(S) to the service, or service proxy, S and a segment SID(E) to the endpoint E. The Segment-List may also include additional intermediate SIDs if these are required for traffic engineering (e.g., the encode a low latency path between H and S and / or between S and E) or simply for reachability purposes. Indeed, the service SID locator may or may not be advertised in the routing protocol and, in the latter case, one or more SIDs might be needed before SID(S) in order to bring the packet up to node S, where SID(S) can be interpreted. The same applies for the segment SID(E) at the SR policy endpoint.</t>

<t>When the packet arrives at S, this node determines how to process the packet based on the semantic locally associated to the active segment SID(S). If S is an SR-aware service, then SID(S) may provide additional context or indication on how to process the packet (e.g., a firewall SID may indicate which rule set should be applied onto the packet). If S is a proxy in front of an SR-unaware service, SID(S) indicates how and to which service attached to this proxy the packet should be transmitted. At some point in the process, the SRv6 End function is also applied in order to make the next SID, which may be SID(E) or another intermediate SID, active.</t>

<t>The &quot;Inner pkt&quot; on <xref target="fig-policy-srv6"/> represents the SRv6 payload, which may be an encapsulated IP packet, an Ethernet frame or a transport-layer payload, for example.</t>

</section>
</section>
<section anchor="sec-proxies"><name>SR Proxy Behaviors</name>

<t>This section describes several SR proxy behaviors designed to enable SR service programming through SR-unaware services.  A system implementing one of these behaviors may handle the SR processing on behalf of an SR-unaware service and allows the service to properly process the traffic that is steered through it.</t>

<t>A service may be located at any hop in an SR policy, including the last segment.  However, the SR proxy behaviors defined in this section are dedicated to supporting SR-unaware services at intermediate hops in the segment list.  In case an SR-unaware service is at the last segment, it is sufficient to ensure that the SR information is ignored (IPv6 routing extension header with Segments Left equal to 0) or removed before the packet reaches the service (MPLS PHP, SRv6 decapsulation behavior or PSP flavor).</t>

<t>As illustrated on <xref target="fig-proxy"/>, the generic behavior of an SR proxy has two parts.  The first part is in charge of passing traffic from the network to the service.  It intercepts the SR traffic destined for the service via a locally instantiated service segment, modifies it in such a way that it appears as non-SR traffic to the service, then sends it out on a given interface, IFACE-OUT, connected to the service.  The second part receives the traffic coming back from the service on IFACE-IN, restores the SR information and forwards it according to the next segment in the list.  IFACE-OUT and IFACE-IN are respectively the proxy interface used for sending traffic to the service and the proxy interface that receives the traffic coming back from the service.  These can be physical interfaces or sub-interfaces (VLANs) and, unless otherwise stated, IFACE-OUT and IFACE-IN can represent the same interface.</t>

<figure title="Generic SR proxy" anchor="fig-proxy"><artwork><![CDATA[
           +----------------------------+
           |                            |
           |           Service          |
           |                            |
           +----------------------------+
                    ^  Non SR   |
                    |  traffic  |
                    |           v
              +-----------+----------+
           +--| IFACE OUT | IFACE IN |--+
SR traffic |  +-----------+----------+  | SR traffic
---------->|          SR proxy          |---------->
           |                            |
           +----------------------------+
]]></artwork></figure>

<t>In the next subsections, the following SR proxy mechanisms are defined:</t>

<t><list style="symbols">
  <t>Static proxy</t>
  <t>Dynamic proxy</t>
  <t>Shared-memory proxy</t>
  <t>Masquerading proxy</t>
</list></t>

<t>Each mechanism has its own characteristics and constraints, which are summarized in the below table.  It is up to the operator to select the best one based on the proxy node capabilities, the service behavior and the traffic type.  It is also possible to use different proxy mechanisms within the same service policy.</t>

<figure title="SR proxy summary" anchor="fig-proxy-sum"><artwork><![CDATA[
                                        +-----+-----+-----+-----+
                                        |     |     |     |  M  |
                                        |     |     |  S  |  a  |
                                        |     |     |  h  |  s  |
                                        |     |     |  a  |  q  |
                                        |     |     |  r  |  u  |
                                        |     |  D  |  e  |  e  |
                                        |  S  |  y  |  d  |  r  |
                                        |  t  |  n  |     |  a  |
                                        |  a  |  a  |  m  |  d  |
                                        |  t  |  m  |  e  |  i  |
                                        |  i  |  i  |  m  |  n  |
                                        |  c  |  c  |  .  |  g  |
+---------------------------------------+-----+-----+-----+-----+
|                |       SR-MPLS        |  Y  |  Y  |  Y  |  -  |
|                |                      |     |     |     |     |
|   SR flavors   |     Inline SRv6      |  P  |  P  |  P  |  Y  |
|                |                      |     |     |     |     |
|                |  SRv6 encapsulation  |  Y  |  Y  |  Y  |  -  |
+----------------+----------------------+-----+-----+-----+-----+
|     Chain agnostic configuration      |  N  |  N  |  Y  |  Y  |
+---------------------------------------+-----+-----+-----+-----+
|     Transparent to chain changes      |  N  |  Y  |  Y  |  Y  |
+----------------+----------------------+-----+-----+-----+-----+
|                |   DA modification    |  Y  |  Y  |  Y  | NAT |
|                |                      |     |     |     |     |
|                | Payload modification |  Y  |  Y  |  Y  |  Y  |
|                |                      |     |     |     |     |
|Service support |  Packet generation   |  Y  |  Y  |cache|cache|
|                |                      |     |     |     |     |
|                |   Packet deletion    |  Y  |  Y  |  Y  |  Y  |
|                |                      |     |     |     |     |
|                |  Packet re-ordering  |  Y  |  Y  |  Y  |  Y  |
|                |                      |     |     |     |     |
|                |  Transport endpoint  |  Y  |  Y  |cache|cache|
+----------------+----------------------+-----+-----+-----+-----+
|                |       Ethernet       |  Y  |  Y  |  Y  |  -  |
|   Supported    |                      |     |     |     |     |
|    traffic     |         IPv4         |  Y  |  Y  |  Y  |  -  |
|                |                      |     |     |     |     |
|                |         IPv6         |  Y  |  Y  |  Y  |  Y  |
+----------------+----------------------+-----+-----+-----+-----+
]]></artwork></figure>

<t>Note: The use of a shared memory proxy requires both the service (VNF) and the proxy to be running on the same node.</t>

<section anchor="sec-proxies-static"><name>Static SR Proxy</name>

<t>The static proxy is an SR endpoint behavior for processing SR-MPLS or SRv6 encapsulated traffic on behalf of an SR-unaware service.  This proxy thus receives SR traffic that is formed of an MPLS label stack or an IPv6 header on top of an inner packet, which can be Ethernet, IPv4 or IPv6.</t>

<t>A static SR proxy segment is associated with the following mandatory parameters</t>

<t><list style="symbols">
  <t>INNER-TYPE: Inner packet type</t>
  <t>NH-ADDR: Next hop Ethernet address (only for inner type IPv4 and IPv6)</t>
  <t>IFACE-OUT: Local interface for sending traffic towards the service</t>
  <t>IFACE-IN: Local interface receiving the traffic coming back from the service</t>
  <t>CACHE: SR information to be attached on the traffic coming back from the service, including at least
  <list style="symbols">
      <t>CACHE.SA: IPv6 source address (SRv6 only)</t>
      <t>CACHE.LIST: Segment list expressed as MPLS labels or IPv6 address</t>
    </list></t>
</list></t>

<t>A static SR proxy segment is thus defined for a specific service, inner packet type and cached SR information.  It is also bound to a pair of directed interfaces on the proxy.  These may be both directions of a single interface, or opposite directions of two different interfaces. The latter is recommended in case the service is to be used as part of a bi-directional SR service policy.  If the proxy and the service both support 802.1Q, IFACE-OUT and IFACE-IN can also represent sub-interfaces.</t>

<t>The first part of this behavior is triggered when the proxy node receives a packet whose active segment matches a segment associated with the static proxy behavior.  It removes the SR information from the packet then sends it on a specific interface towards the associated service.  This SR information corresponds to the full label stack for SR-MPLS or to the encapsulation IPv6 header with any attached extension header in the case of SRv6.</t>

<t>The second part is an inbound policy attached to the proxy interface receiving the traffic returning from the service, IFACE-IN.  This policy attaches to the incoming traffic the cached SR information associated with the SR proxy segment.  If the proxy segment uses the SR-MPLS data plane, CACHE contains a stack of labels to be pushed on top of the packets.  With the SRv6 data plane, CACHE is defined as a source address, an active segment and an optional SRH (tag, segments left, segment list and metadata).  The proxy encapsulates the packets with an IPv6 header that has the source address, the active segment as destination address and the SRH as a routing extension header.  After the SR information has been attached, the packets are forwarded according to the active segment, which is represented by the top MPLS label or the IPv6 Destination Address. An MPLS TTL or IPv6 Hop Limit value may also be configured in CACHE. If it is not, the proxy should set these values according to the node&#39;s default setting for MPLS or IPv6 encapsulation.</t>

<t>In this scenario, there are no restrictions on the operations that can be performed by the service on the stream of packets.  It may operate at all protocol layers, terminate transport layer connections, generate new packets and initiate transport layer connections.  This behavior may also be used to integrate an IPv4-only service into an SRv6 policy.  However, a static SR proxy segment can be used in only one service policy at a time.  As opposed to most other segment types, a static SR proxy segment is bound to a unique list of segments, which represents a directed SR service policy.  This is due to the cached SR information being defined in the segment configuration.  This limitation only prevents multiple segment lists from using the same static SR proxy segment at the same time, but a single segment list can be shared by any number of traffic flows.  Besides, since the returning traffic from the service is re-classified based on the incoming interface, an interface can be used as receiving interface (IFACE-IN) only for a single SR proxy segment at a time.  In the case of a bi-directional SR service policy, a different SR proxy segment and receiving interface are required for the return direction.</t>

<t>The static proxy behavior may also be used for sending traffic through &quot;bump in the wire&quot; services that are transparent to the IP and Ethernet layers. This type of processing is assumed when the inner traffic type is Ethernet, since the original destination address of the Ethernet frame is preserved when the packet is steered into the SR Policy and likely associated with a node downstream of the policy tail-end. In case the inner type is IP (IPv4 or IPv6), the NH-ADDR parameter may be set to a dummy or broadcast Ethernet address, or simply to the address of the proxy receiving interface (IFACE-IN).</t>

<section anchor="sec-proxies-static-mpls"><name>SR-MPLS Pseudocode</name>

<section anchor="static-proxy-for-inner-type-ethernet"><name>Static Proxy for Inner Type Ethernet</name>

<t>When processing an MPLS packet whose top label matches a locally instantiated
MPLS static proxy SID for Ethernet traffic, the following pseudocode is
executed.</t>

<figure title="SID processing for MPLS static proxy
(Ethernet)" anchor="code-static-mpls-eth-sid"><artwork><![CDATA[
S01. POP all labels in the MPLS label stack.
S02. Submit the frame to the Ethernet module for transmission via
     interface IFACE-OUT.
]]></artwork></figure>

<t>When processing an Ethernet frame received on the interface IFACE-IN and with a
destination MAC address that is neither a broadcast address nor matches the
address of IFACE-IN, the following pseudocode is executed.</t>

<figure title="Inbound policy for MPLS static proxy
(Ethernet)" anchor="code-static-mpls-eth-inbound"><artwork><![CDATA[
S01. Retrieve the CACHE entry associated with IFACE-IN.
S02. If the CACHE entry is not empty {
S03.   Remove the preamble or Frame Check Sequence (FCS).
S04.   PUSH all labels from the retrieved CACHE entry.
S05.   Submit the packet to the MPLS module for transmission as per
       the top label in the MPLS label stack.
S06. }
]]></artwork></figure>

</section>
<section anchor="static-proxy-for-inner-type-ipv4"><name>Static Proxy for Inner Type IPv4</name>

<t>When processing an MPLS packet whose top label matches a locally instantiated
MPLS static proxy SID for IPv4 traffic, the following pseudocode is
executed.</t>

<figure title="SID processing for MPLS static proxy
(IPv4)" anchor="code-static-mpls-ipv4-sid"><artwork><![CDATA[
S01. POP all labels in the MPLS label stack.
S02. Submit the packet to the IPv4 module for transmission on
     interface IFACE-OUT via NH-ADDR.
]]></artwork></figure>

<t>When processing an IPv4 packet received on the interface IFACE-IN and with a
destination address that does not match any address of IFACE-IN, the following
pseudocode is executed.</t>

<figure title="Inbound policy for MPLS static proxy
(IPv4)" anchor="code-static-mpls-ipv4-inbound"><artwork><![CDATA[
S01. Retrieve the CACHE entry associated with IFACE-IN.
S02. If the CACHE entry is not empty {
S03.   Decrement the TTL and adjust the checksum accordingly.
S04.   PUSH all labels from the retrieved CACHE entry.
S05.   Submit the packet to the MPLS module for transmission as per
       the top label in the MPLS label stack.
S06. }
]]></artwork></figure>

</section>
<section anchor="static-proxy-for-inner-type-ipv6"><name>Static Proxy for Inner Type IPv6</name>

<t>When processing an MPLS packet whose top label matches a locally instantiated
MPLS static proxy SID for IPv6 traffic, the following pseudocode is
executed.</t>

<figure title="SID processing for MPLS static proxy
(IPv6)" anchor="code-static-mpls-ipv6-sid"><artwork><![CDATA[
S01. POP all labels in the MPLS label stack.
S02. Submit the packet to the IPv6 module for transmission on
     interface IFACE-OUT via NH-ADDR.
]]></artwork></figure>

<t>When processing an IPv6 packet received on the interface IFACE-IN and with a
destination address that does not match any address of IFACE-IN, the following
pseudocode is executed.</t>

<figure title="Inbound policy for MPLS static proxy
(IPv6)" anchor="code-static-mpls-ipv6-inbound"><artwork><![CDATA[
S01. Retrieve the CACHE entry associated with IFACE-IN.
S02. If the CACHE entry is not empty {
S03.   Decrement the Hop Limit.
S04.   PUSH all labels from the retrieved CACHE entry.
S05.   Submit the packet to the MPLS module for transmission as per
       the top label in the MPLS label stack.
S06. }
]]></artwork></figure>

</section>
</section>
<section anchor="sec-proxies-static-srv6"><name>SRv6 Pseudocode</name>

<section anchor="static-proxy-for-inner-type-ethernet-1"><name>Static Proxy for Inner Type Ethernet</name>

<t>When processing an IPv6 packet matching a FIB entry locally instantiated as an
SRv6 static proxy SID for Ethernet traffic, the following pseudocode is
executed.</t>

<figure title="SID processing for SRv6 static proxy
(Ethernet)" anchor="code-static-srv6-eth-sid"><artwork><![CDATA[
S01. When an SRH is processed {
S02.   If (Segments Left == 0) {
S03.     Proceed to process the next header in the packet.
S04.   }
S05.   If (IPv6 Hop Limit <= 1) {
S06.     Send an ICMP Time Exceeded message to the Source Address,
         Code 0 (hop limit exceeded in transit),
         Interrupt packet processing and discard the packet.
S07.   }
S08.   max_last_entry = (Hdr Ext Len / 2) - 1
S09.   If ((Last Entry > max_last_entry) or
           (Segments Left > (Last Entry + 1))) {
S10.     Send an ICMP Parameter Problem message to the Source Address,
         Code 0 (Erroneous header field encountered),
         Pointer set to the Segments Left field,
         Interrupt packet processing and discard the packet.
S11.   }
S12.   Decrement Hop Limit by 1.
S13.   Decrement Segments Left by 1.
S14.   Copy Segment List[Segments Left] from the SRH to the
       Destination Address of the IPv6 header.
S15.   If (Upper-layer header type != 143 (Ethernet)) {
S16.     Resubmit the packet to the IPv6 module for transmission to
         the new destination.
S17.   }
S18.   Perform IPv6 decapsulation.
S19.   Submit the frame to the Ethernet module for transmission via
       interface IFACE-OUT.
S20. }
]]></artwork></figure>

<t>S15: 143 (Ethernet) refers to the value assigned by IANA for &quot;Ethernet&quot; in the
&quot;Internet Protocol Numbers&quot; registry.</t>

<t>When processing the Upper-layer header of a packet matching a FIB entry locally
instantiated as an SRv6 static proxy SID for Ethernet traffic, the following
pseudocode is executed.</t>

<figure title="Upper-layer header processing for SRv6
static proxy (Ethernet)" anchor="code-static-srv6-eth-ulh"><artwork><![CDATA[
S01. If (Upper-layer header type != 143 (Ethernet)) {
S02.   Process as per [RFC8986] Section 4.1.1
S03. }
S04. Perform IPv6 decapsulation.
S05. Submit the frame to the Ethernet module for transmission via
     interface IFACE-OUT.
]]></artwork></figure>

<t>When processing an Ethernet frame received on the interface IFACE-IN and with a
destination MAC address that is neither a broadcast address nor matches the
address of IFACE-IN, the following pseudocode is executed.</t>

<figure title="Inbound policy for SRv6 static proxy
(Ethernet)" anchor="code-static-srv6-eth-inbound"><artwork><![CDATA[
S01. Retrieve the CACHE entry associated with IFACE-IN.
S02. If the CACHE entry is not empty {
S03.   Remove the preamble or Frame Check Sequence (FCS).
S04.   Perform IPv6 encapsulation with an SRH
         Source Address of the IPv6 header is set to CACHE.SA,
         Destination Address of the IPv6 header is set to
         CACHE.LIST[0],
         Next Header of the SRH is set to 143 (Ethernet),
         Segment List of the SRH is set to CACHE.LIST.
S05.   Submit the packet to the IPv6 module for transmission to the
       next destination.
S06. }
]]></artwork></figure>

<t>S04: CACHE.LIST[0] represents the first entry in CACHE.LIST. Unless a local
configuration indicates otherwise, the SIDs in CACHE.LIST should be encoded
in the Segment List field in reversed order, the Segment Left and Last Entry
values should be set of the length of CACHE.LIST minus 1. If CACHE.LIST contains
a single entry, the SRH can be omitted and the Next Header field of the IPv6
header set to 143 (Ethernet).</t>

</section>
<section anchor="static-proxy-for-inner-type-ipv4-1"><name>Static Proxy for Inner Type IPv4</name>

<t>When processing an IPv6 packet matching a FIB entry locally instantiated as an
SRv6 static proxy SID for IPv4 traffic, the following pseudocode is executed.</t>

<figure title="SID processing for SRv6 static proxy
(IPv4)" anchor="code-static-srv6-ipv4-sid"><artwork><![CDATA[
S01. When an SRH is processed {
S02.   If (Segments Left == 0) {
S03.     Proceed to process the next header in the packet.
S04.   }
S05.   If (IPv6 Hop Limit <= 1) {
S06.     Send an ICMP Time Exceeded message to the Source Address,
         Code 0 (hop limit exceeded in transit),
         Interrupt packet processing and discard the packet.
S07.   }
S08.   max_last_entry = (Hdr Ext Len / 2) - 1
S09.   If ((Last Entry > max_last_entry) or
           (Segments Left > (Last Entry + 1))) {
S10.     Send an ICMP Parameter Problem message to the Source Address,
         Code 0 (Erroneous header field encountered),
         Pointer set to the Segments Left field,
         Interrupt packet processing and discard the packet.
S11.   }
S12.   Decrement Hop Limit by 1.
S13.   Decrement Segments Left by 1.
S14.   Copy Segment List[Segments Left] from the SRH to the
       Destination Address of the IPv6 header.
S15.   If (Upper-layer header type != 4 (IPv4)) {
S16.     Resubmit the packet to the IPv6 module for transmission to
         the new destination.
S17.   }
S18.   Perform IPv6 decapsulation.
S19.   Submit the packet to the IPv4 module for transmission on
       interface IFACE-OUT via NH-ADDR.
S20. }
]]></artwork></figure>

<t>When processing the Upper-layer header of a packet matching a FIB entry locally
instantiated as an SRv6 static proxy SID for IPv4 traffic, the following
pseudocode is executed.</t>

<figure title="Upper-layer header processing for SRv6
static proxy (IPv4)" anchor="code-static-srv6-ipv4-ulh"><artwork><![CDATA[
S01. If (Upper-layer header type != 4 (IPv4)) {
S02.   Process as per [RFC8986] Section 4.1.1
S03. }
S04. Perform IPv6 decapsulation.
S05. Submit the packet to the IPv4 module for transmission on
     interface IFACE-OUT via NH-ADDR.
]]></artwork></figure>

<t>When processing an IPv4 packet received on the interface IFACE-IN and with a
destination address that does not match any address of IFACE-IN, the following
pseudocode is executed.</t>

<figure title="Inbound policy for SRv6 static proxy
(IPv4)" anchor="code-static-srv6-ipv4-inbound"><artwork><![CDATA[
S01. Retrieve the CACHE entry associated with IFACE-IN.
S02. If the CACHE entry is not empty {
S03.   Decrement the TTL and adjust the checksum accordingly.
S04.   Perform IPv6 encapsulation with an SRH
         Source Address of the IPv6 header is set to CACHE.SA,
         Destination Address of the IPv6 header is set to
         CACHE.LIST[0],
         Next Header of the SRH is set to 4 (IPv4),
         Segment List of the SRH is set to CACHE.LIST.
S05.   Submit the packet to the IPv6 module for transmission to the
       next destination.
S06. }
]]></artwork></figure>

<t>S04: CACHE.LIST[0] represents the first entry in CACHE.LIST. Unless a local
configuration indicates otherwise, the SIDs in CACHE.LIST should be encoded
in the Segment List field in reversed order, the Segment Left and Last Entry
values should be set of the length of CACHE.LIST minus 1. If CACHE.LIST contains
a single entry, the SRH can be omitted and the Next Header field of the IPv6
header set to 4 (IPv4).</t>

</section>
<section anchor="static-proxy-for-inner-type-ipv6-1"><name>Static Proxy for Inner Type IPv6</name>

<t>When processing an IPv6 packet matching a FIB entry locally instantiated as an
SRv6 static proxy SID for IPv6 traffic, the following pseudocode is executed.</t>

<figure title="SID processing for SRv6 static proxy
(IPv6)" anchor="code-static-srv6-ipv6-sid"><artwork><![CDATA[
S01. When an SRH is processed {
S02.   If (Segments Left == 0) {
S03.     Proceed to process the next header in the packet.
S04.   }
S05.   If (IPv6 Hop Limit <= 1) {
S06.     Send an ICMP Time Exceeded message to the Source Address,
         Code 0 (hop limit exceeded in transit),
         Interrupt packet processing and discard the packet.
S07.   }
S08.   max_last_entry = (Hdr Ext Len / 2) - 1
S09.   If ((Last Entry > max_last_entry) or
           (Segments Left > (Last Entry + 1))) {
S10.     Send an ICMP Parameter Problem message to the Source Address,
         Code 0 (Erroneous header field encountered),
         Pointer set to the Segments Left field,
         Interrupt packet processing and discard the packet.
S11.   }
S12.   Decrement Hop Limit by 1.
S13.   Decrement Segments Left by 1.
S14.   Copy Segment List[Segments Left] from the SRH to the
       Destination Address of the IPv6 header.
S15.   If (Upper-layer header type != 41 (IPv6)) {
S16.     Resubmit the packet to the IPv6 module for transmission to
         the new destination.
S17.   }
S18.   Perform IPv6 decapsulation.
S19.   Submit the packet to the IPv6 module for transmission on
       interface IFACE-OUT via NH-ADDR.
S20. }
]]></artwork></figure>

<t>When processing the Upper-layer header of a packet matching a FIB entry locally
instantiated as an SRv6 static proxy SID for IPv6 traffic, the following
pseudocode is executed.</t>

<figure title="Upper-layer header processing for SRv6
static proxy (IPv6)" anchor="code-static-srv6-ipv6-ulh"><artwork><![CDATA[
S01. If (Upper-layer header type != 41 (IPv6)) {
S02.   Process as per [RFC8986] Section 4.1.1
S03. }
S04. Perform IPv6 decapsulation.
S05. Submit the packet to the IPv6 module for transmission on
     interface IFACE-OUT via NH-ADDR.
]]></artwork></figure>

<t>When processing an IPv6 packet received on the interface IFACE-IN and with a
destination address that does not match any address of IFACE-IN, the following
pseudocode is executed.</t>

<figure title="Inbound policy for SRv6 static proxy
(IPv6)" anchor="code-static-srv6-ipv6-inbound"><artwork><![CDATA[
S01. Retrieve the CACHE entry associated with IFACE-IN.
S02. If the CACHE entry is not empty {
S03.   Decrement the Hop Limit.
S04.   Perform IPv6 encapsulation with an SRH
         Source Address of the IPv6 header is set to CACHE.SA,
         Destination Address of the IPv6 header is set to
         CACHE.LIST[0],
         Next Header of the SRH is set to 41 (IPv6),
         Segment List of the SRH is set to CACHE.LIST.
S05.   Submit the packet to the IPv6 module for transmission to the
       next destination.
S06. }
]]></artwork></figure>

<t>S04: CACHE.LIST[0] represents the first entry in CACHE.LIST. Unless a local
configuration indicates otherwise, the SIDs in CACHE.LIST should be encoded
in the Segment List field in reversed order, the Segment Left and Last Entry
values should be set of the length of CACHE.LIST minus 1. If CACHE.LIST contains
a single entry, the SRH can be omitted and the Next Header field of the (outer)
IPv6 header set to 41 (IPv6).</t>

</section>
</section>
</section>
<section anchor="sec-proxies-dynamic"><name>Dynamic SR Proxy</name>

<t>The dynamic proxy is an improvement over the static proxy that dynamically learns the SR information before removing it from the incoming traffic.  The same information can then be re-attached to the traffic returning from the service.  As opposed to the static SR proxy, no CACHE information needs to be configured.  Instead, the dynamic SR proxy relies on a local caching mechanism on the node instantiating this segment.</t>

<t>Upon receiving a packet whose active segment matches a dynamic SR proxy function, the proxy node pops the top MPLS label or applies the SRv6 End behavior, then compares the updated SR information with the cache entry for the current segment.  If the cache is empty or different, it is updated with the new SR information.  The SR information is then removed and the inner packet is sent towards the service.</t>

<t>The cache entry is not mapped to any particular packet, but instead to an SR service policy identified by the receiving interface (IFACE-IN). Any non-link-local IP packet or non-local Ethernet frame received on that interface will be re-encapsulated with the cached headers as described in <xref target="sec-proxies-static"/>.  The service may thus drop, modify or generate new packets without affecting the proxy.</t>

<section anchor="sr-mpls-pseudocode"><name>SR-MPLS Pseudocode</name>

<t>The dynamic proxy SR-MPLS pseudocode is obtained by inserting the following instructions at the beginning of the static SR-MPLS pseudocode (<xref target="sec-proxies-static-mpls"/>).</t>

<figure title="SID processing for MPLS dynamic proxy" anchor="code-dynamic-mpls-sid"><artwork><![CDATA[
S01. If the top label S bit is different from 0 {
S02.   Discard the packet.
S03. }
S04. POP the top label.
S05. Copy the MPLS label stack in a CACHE entry associated with the
     interface IFACE-IN.
]]></artwork></figure>

<t>S01: As mentioned at the beginning of <xref target="sec-proxies"/>, an SR proxy is not needed to include an SR-unaware service at the end of an SR policy.</t>

<t>S05: An implementation may optimize the caching procedure by copying information
into the cache only if it is different from the current content of the cache
entry. Furthermore, a TTL margin can be configured for the top label stack entry
to prevent constant cache updates when multiple equal-cost paths with different
hop counts are used towards the SR proxy node.  In that case, a TTL difference
smaller than the configured margin should not trigger a cache update (provided
that the labels are the same).</t>

<t>When processing an Ethernet frame, an IPv4 packet or an IPv6 packet received on
the interface IFACE-IN and with a destination address that does not match any
address of IFACE-IN, the pseudocode reported in
<xref target="code-static-mpls-eth-inbound"/>, <xref target="code-static-mpls-ipv4-inbound"/> or
<xref target="code-static-mpls-ipv6-inbound"/>, respectively, is executed.</t>

</section>
<section anchor="srv6-pseudocode"><name>SRv6 Pseudocode</name>

<t>When processing an IPv6 packet matching a FIB entry locally instantiated as an
SRv6 dynamic proxy SID, the same pseudocode as described in
<xref target="code-static-srv6-eth-sid"/>, <xref target="code-static-srv6-ipv4-sid"/> and
<xref target="code-static-srv6-ipv6-sid"/>, respectively for Ethernet, IPv4 and IPv6 traffic,
is executed with the following addition between lines S17 and S18.</t>

<figure title="SID processing for SRv6 dynamic proxy" anchor="code-dynamic-srv6-sid"><artwork><![CDATA[
(... S17.     })
S17.1.   Copy the IPv6 encapsulation in a CACHE entry associated with
         the interface IFACE-IN.
(S18.     Perform IPv6 decapsulation...)
]]></artwork></figure>

<t>An implementation may optimize the caching procedure by copying information into
the cache only if it is different from the current content of the cache entry.
A Hop Limit margin can be configured to prevent constant cache updates when
multiple equal-cost paths with different hop counts are used towards the SR
proxy node.  In that case, a Hop Limit difference smaller than the configured
margin should not trigger a cache update. Similarly, the Flow Label value can be
ignored when comparing the current packet IPv6 header with the cache entry. In
this case, the Flow Label should be re-computed by the proxy node when it
restores the IPv6 encapsulation from the cache entry.</t>

<t>When processing the Upper-layer header of a packet matching a FIB entry locally
instantiated as an SRv6 dynamic proxy SID, process the packet as per
<xref target="RFC8986"/> Section 4.1.1.</t>

<t>When processing an Ethernet frame, an IPv4 packet or an IPv6 packet received on
the interface IFACE-IN and with a destination address that does not match any
address of IFACE-IN, the same pseudocode as in <xref target="code-static-srv6-eth-inbound"/>,
<xref target="code-static-srv6-ipv4-inbound"/> or <xref target="code-static-srv6-ipv6-inbound"/>,
respectively, is executed.</t>

</section>
</section>
<section anchor="shared-memory-sr-proxy"><name>Shared Memory SR Proxy</name>

<t>The shared memory proxy is an SR endpoint behavior for processing SR-MPLS or SRv6 encapsulated traffic on behalf of an SR-unaware service. This proxy behavior leverages a shared-memory interface with a virtualized service (VNF) in order to hide the SR information from an SR-unaware service while keeping it attached to the packet.  We assume in this case that the proxy and the VNF are running on the same compute node.  A typical scenario is an SR-capable vrouter running on a container host and forwarding traffic to VNFs isolated within their respective container.</t>

</section>
<section anchor="masquerading-sr-proxy"><name>Masquerading SR Proxy</name>

<t>The masquerading proxy is an SR endpoint behavior for processing SRv6 traffic on behalf of an SR-unaware service.  This proxy thus receives SR traffic that is formed of an IPv6 header and an SRH on top of an inner payload.  The masquerading behavior is independent from the inner payload type.  Hence, the inner payload can be of any type but it is usually expected to be a transport layer packet, such as TCP or UDP.</t>

<t>A masquerading SR proxy segment is associated with the following mandatory parameters:</t>

<t><list style="symbols">
  <t>NH-ADDR: Next hop Ethernet address</t>
  <t>IFACE-OUT: Local interface for sending traffic towards the service</t>
  <t>IFACE-IN: Local interface receiving the traffic coming back from the service</t>
</list></t>

<t>A masquerading SR proxy segment is thus defined for a specific service and bound to a pair of directed interfaces or sub-interfaces on the proxy.  As opposed to the static and dynamic SR proxies, a masquerading segment can be present at the same time in any number of SR service policies and the same interfaces can be bound to multiple masquerading proxy segments.  The only restriction is that a masquerading proxy segment cannot be the last segment in an SR service policy.</t>

<t>The first part of the masquerading behavior is triggered when the proxy node receives an IPv6 packet whose Destination Address matches a masquerading proxy SID.  The proxy inspects the IPv6 extension headers and substitutes the Destination Address with the last SID in the SRH attached to the IPv6 header, which represents the final destination of the IPv6 packet.  The packet is then sent out towards the service.</t>

<t>The service receives an IPv6 packet whose source and destination addresses are respectively the original source and final destination.  It does not attempt to inspect the SRH, as RFC8200 specifies that routing extension headers are not examined or processed by transit nodes. Instead, the service simply forwards the packet based on its current Destination Address.  In this scenario, we assume that the service can only inspect, drop or perform limited changes to the packets.  For example, Intrusion Detection Systems, Deep Packet Inspectors and non-NAT Firewalls are among the services that can be supported by a masquerading SR proxy.  Flavors of the masquerading behavior are defined in <xref target="sec-proxies-am-nat"/> and <xref target="sec-proxies-am-cache"/> to support a wider range of services.</t>

<t>The second part of the masquerading behavior, also called de-masquerading, is an inbound policy attached to the proxy interface receiving the traffic returning from the service, IFACE-IN.  This policy inspects the incoming traffic and triggers a regular SRv6 endpoint processing (End) on any IPv6 packet that contains an SRH.  This processing occurs before any lookup on the packet Destination Address is performed and it is sufficient to restore the right active SID as the Destination Address of the IPv6 packet.</t>

<section anchor="srv6-masquerading-proxy-pseudocode"><name>SRv6 Masquerading Proxy Pseudocode</name>

<t>Masquerading: When processing an IPv6 packet matching a FIB entry locally
instantiated as an SRv6 masquerading proxy SID, the following pseudocode is
executed.</t>

<figure title="SID processing for SRv6 masquerading proxy" anchor="code-masquerading-sid"><artwork><![CDATA[
S01. When an SRH is processed {
S02.   If (Segments Left == 0) {
S03.     Proceed to process the next header in the packet.
S04.   }
S05.   If (IPv6 Hop Limit <= 1) {
S06.     Send an ICMP Time Exceeded message to the Source Address,
         Code 0 (hop limit exceeded in transit),
         Interrupt packet processing and discard the packet.
S07.   }
S08.   max_last_entry = (Hdr Ext Len / 2) - 1
S09.   If ((Last Entry > max_last_entry) or
           (Segments Left > (Last Entry + 1))) {
S10.     Send an ICMP Parameter Problem message to the Source Address,
         Code 0 (Erroneous header field encountered),
         Pointer set to the Segments Left field,
         Interrupt packet processing and discard the packet.
S11.   }
S12.   Decrement Hop Limit by 1.
S13.   Decrement Segments Left by 1.
S14.   Copy Segment List[0] from the SRH to the Destination Address
       of the IPv6 header.
S15.   Submit the packet to the IPv6 module for transmission on
       interface IFACE-OUT via NH-ADDR.
S16. }
]]></artwork></figure>

<t>When processing the Upper-layer header of a packet matching a FIB entry locally
instantiated as an SRv6 masquerading proxy SID, process the packet as per
<xref target="RFC8986"/> Section 4.1.1.</t>

<t>De-masquerading: When processing an IPv6 packet received on the interface
IFACE-IN and with a destination address that does not match any address of
IFACE-IN, the following pseudocode is executed.</t>

<figure title="Inbound policy for SRv6 masquerading proxy" anchor="code-masquerading-inbound"><artwork><![CDATA[
S01. When an SRH is processed {
S02.   If (IPv6 Hop Limit <= 1) {
S03.     Send an ICMP Time Exceeded message to the Source Address,
         Code 0 (hop limit exceeded in transit),
         Interrupt packet processing and discard the packet.
S04.   }
S05.   If (Segments Left != 0) {
S06.     max_last_entry = (Hdr Ext Len / 2) - 1
S07.     If ((Last Entry > max_last_entry) or
             (Segments Left > Last Entry)) {
S08.       Send an ICMP Parameter Problem message to the Source Address,
           Code 0 (Erroneous header field encountered),
           Pointer set to the Segments Left field,
           Interrupt packet processing and discard the packet.
S09.     }
S10.     Copy Segment List[Segments Left] from the SRH to the
         Destination Address of the IPv6 header.
S11.   }
S12.   Decrement Hop Limit by 1.
S13.   Submit the packet to the IPv6 module for transmission to the
       next destination.
S14. }
]]></artwork></figure>

</section>
<section anchor="sec-proxies-am-nat"><name>Destination NAT Flavor</name>

<t>Services modifying the destination address in the packets they process, such as
NATs, can be supported by reporting the updated Destination Address back into
the Segment List field of the SRH.</t>

<t>The Destination NAT flavor of the SRv6 masquerading proxy is enabled by adding
the following instruction between lines S09 and S10 of the de-masquerading
pseudocode in <xref target="code-masquerading-inbound"/>.</t>

<figure><artwork><![CDATA[
(... S09.     })
S09.1.   Copy the Destination Address of the IPv6 header to the
         Segment List[0] entry of the SRH.
(S10.     Copy Segment List[Segments Left] from the SRH to the
          Destination Address of the IPv6 header...)
]]></artwork></figure>

</section>
<section anchor="sec-proxies-am-cache"><name>Caching Flavor</name>

<t>Services generating packets or acting as endpoints for transport connections can be supported by adding a dynamic caching mechanism similar to the one described in <xref target="sec-proxies-dynamic"/>.</t>

<t>The caching flavor of the SRv6 masquerading proxy is enabled by:</t>

<t><list style="symbols">
  <t>Adding the following instruction between lines S14 and S15 of the masquerading
pseudocode in <xref target="code-masquerading-sid"/>.</t>
</list></t>

<figure><artwork><![CDATA[
(... S14.   Copy Segment List[0] from the SRH to the Destination
            Address of the IPv6 header.
S14.1. Copy the IPv6 encapsulation in a CACHE entry associated with
       the interface IFACE-IN.
(S15.   Submit the packet to the IPv6 module for transmission on
        interface IFACE-OUT via NH-ADDR.)
]]></artwork></figure>

<t><list style="symbols">
  <t>Updating the de-masquerading pseudocode such that, in addition to the SRH
processing in <xref target="code-masquerading-inbound"/>, the following pseudocode is
executed when processing an IPv6 packet (received on the interface IFACE-IN and
with a destination address that does not match any address of IFACE-IN) that
does not contain an SRH.</t>
</list></t>

<figure><artwork><![CDATA[
S01. Retrieve the CACHE entry associated with IFACE-IN.
S02. If the CACHE entry is not empty {
S03.   If (IPv6 Hop Limit <= 1) {
S04.     Send an ICMP Time Exceeded message to the Source Address,
         Code 0 (hop limit exceeded in transit),
         Interrupt packet processing and discard the packet.
S05.   }
S06.   Decrement Hop Limit by 1.
S07.   Update the IPv6 encapsulation according to the retrieved CACHE
       entry.
S08.   Submit the packet to the IPv6 module for transmission to the
       next destination.
S09. }
]]></artwork></figure>

</section>
</section>
</section>
<section anchor="metadata"><name>Metadata</name>

<section anchor="mpls-data-plane"><name>MPLS Data Plane</name>

<t>Metadata can be carried for SR-MPLS traffic in a Segment Routing Header inserted between the last MPLS label and the MPLS payload. When used solely as a metadata container, the SRH does not carry any segment but only the mandatory header fields, including the tag and flags, and any TLVs that is required for transporting the metadata.</t>

<t>Since the MPLS encapsulation has no explicit protocol identifier field to indicate the protocol type of the MPLS payload, how to indicate the presence of metadata in an MPLS packet is a potential issue to be addressed.  One possible solution is to add the indication about the presence of metadata in the semantic of the SIDs. Note that only the SIDs whose behavior involves looking at the metadata or the MPLS payload would need to include such semantic (e.g., service segments). Other segments, such as topological segments, are not affected by the presence of metadata.  Another, more generic, solution is to introduce a protocol identifier field within the MPLS packet as described in <xref target="I-D.xu-mpls-payload-protocol-identifier"/>.</t>

</section>
<section anchor="ipv6-data-plane"><name>IPv6 Data Plane</name>

<section anchor="srh-tlv-objects"><name>SRH TLV Objects</name>

<t>The IPv6 SRH TLV objects are designed to carry all sorts of metadata. TLV objects can be imposed by the ingress edge router that steers the traffic into the SR service policy.</t>

<t>An SR-aware service may impose, modify or remove any TLV object attached to the first SRH, either by directly modifying the packet headers or via a control channel between the service and its forwarding plane.</t>

<t>An SR-aware service that re-classifies the traffic and steers it into a new SR service policy (e.g.  DPI) may attach any TLV object to the new SRH.</t>

<t>Metadata imposition and handling will be further discussed in a future version of this document.</t>

<section anchor="opaque-metadata-tlv"><name>Opaque Metadata TLV</name>

<t>This document defines an SRv6 TLV called Opaque Metadata TLV. This is a fixed-length container to carry any type of Service Metadata. No assumption is made by this document on the structure or the content of the carried metadata. The Opaque Metadata TLV has the following format:</t>

<figure><artwork><![CDATA[
 0                   1                   2                   3
 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|      Type     |     Length    |                               |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+                               |
|                                                               |
|                       Service Metadata                        |
|                                                               |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
]]></artwork></figure>

<t>where:</t>

<t><list style="symbols">
  <t>Type: to be assigned by IANA.</t>
  <t>Length: 14.</t>
  <t>Service Metadata: 14 octets of opaque data.</t>
</list></t>

</section>
<section anchor="nsh-carrier-tlv"><name>NSH Carrier TLV</name>

<t>This document defines an SRv6 TLV called NSH Carrier TLV. It is a container to carry Service Metadata in the form of Variable-Length Metadata as defined in <xref target="RFC8300"/> for NSH MD Type 2. The NSH Carrier TLV has the following format:</t>

<figure><artwork><![CDATA[
 0                   1                   2                   3
 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|      Type     |     Length    |     Flags     |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
//            Service Metadata                                 //
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
]]></artwork></figure>

<t>where:</t>

<t><list style="symbols">
  <t>Type: to be assigned by IANA.</t>
  <t>Length: the total length of the TLV.</t>
  <t>Flags: 8 bits.  No flags are defined in this document.  SHOULD be set to 0 on transmission and MUST be ignored on receipt.</t>
  <t>Service Metadata: a list of Service Metadata TLV as defined in <xref target="RFC8300"/> for NSH MD Type 2.</t>
</list></t>

</section>
</section>
<section anchor="srh-tag"><name>SRH Tag</name>

<t>The SRH tag identifies a packet as part of a group or class of packets <xref target="RFC8754"/>.</t>

<t>In the context of service programming, this field can be used to encode basic metadata in the SRH. An example use-case is to leverage the SRH tag to encode a policy ID. This policy ID can then be used by an SR-aware function to identify a particular processing policy to be applied on that packet.</t>

</section>
</section>
</section>
<section anchor="implementation-status"><name>Implementation Status</name>

<t>This section is to be removed prior to publishing as an RFC.</t>

<section anchor="sec-implem-aware"><name>SR-Aware Services</name>

<t>Specific SRv6 support has been implemented for the below open-source services:</t>

<t><list style="symbols">
  <t>Iptables (1.6.2 and later) <xref target="IPTABLES"/></t>
  <t>Nftables (0.8.4 and later) <xref target="NFTABLES"/></t>
  <t>Snort <xref target="SNORT"/></t>
</list></t>

<t>In addition, any service relying on the Linux kernel, version 4.10 and later, or FD.io VPP for packet forwarding can be considered as SR-aware.</t>

</section>
<section anchor="proxy-behaviors"><name>Proxy Behaviors</name>

<t>The static SR proxy is available for SR-MPLS and SRv6 on various Cisco hardware and software platforms.  Furthermore, the following proxies are available on open-source software.</t>

<figure title="Open-source implementation status table" anchor="tab-implem"><artwork><![CDATA[
                                        +-------------+-------------+
                                        |     VPP     |    Linux    |
+---+-----------------------------------+-------------+-------------+
| M |           Static proxy            |  Available  | In progress |
| P |                                   |             |             |
| L |           Dynamic proxy           | In progress | In progress |
| S |                                   |             |             |
|   |        Shared memory proxy        | In progress | In progress |
+---+-----------------------------------+-------------+-------------+
|   |           Static proxy            |  Available  | In progress |
| S |                                   |             |             |
| R |           Dynamic proxy           |  Available  |  Available  |
| v |                                   |             |             |
| 6 |        Shared memory proxy        | In progress | In progress |
|   |                                   |             |             |
|   |        Masquerading proxy         |  Available  |  Available  |
+---+-----------------------------------+-------------+-------------+
]]></artwork></figure>

</section>
</section>
<section anchor="related-works"><name>Related Works</name>

<t>The Segment Routing solution addresses a wide problem that covers both topological and service policies.  The topological and service instructions can be either deployed in isolation or in combination.  SR has thus a wider applicability than the architecture defined in <xref target="RFC7665"/>.  Furthermore, the inherent property of SR is a stateless network fabric.  In SR, there is no state within the fabric to recognize a flow and associate it with a policy.  State is only present at the ingress edge of the SR domain, where the policy is encoded into the packets.  This is completely different from other proposals such as <xref target="RFC8300"/> and the MPLS label swapping mechanism described in <xref target="RFC8595"/>, which rely on state configured at every hop of the service chain.</t>

</section>
<section anchor="iana-considerations"><name>IANA Considerations</name>

<section anchor="srv6-endpoint-behaviors"><name>SRv6 Endpoint Behaviors</name>

<t>This I-D requests the IANA to allocate, within the &quot;SRv6 Endpoint Behaviors&quot; sub-registry belonging to the top-level &quot;Segment-routing with IPv6 dataplane (SRv6) Parameters&quot; registry, the following allocations:</t>

<figure><artwork><![CDATA[
Value      Description                               Reference
--------------------------------------------------------------
TBA1-1     End.AN - SR-aware function (native)       [This.ID]
TBA1-2     End.AS - Static proxy                     [This.ID]
TBA1-3     End.AD - Dynamic proxy                    [This.ID]
TBA1-4     End.AM - Masquerading proxy               [This.ID]
TBA1-5     End.AM - Masquerading proxy with NAT      [This.ID]
TBA1-6     End.AM - Masquerading proxy with Caching  [This.ID]
TBA1-7     End.AM - Masquerading proxy with NAT &    [This.ID]
                    Caching
]]></artwork></figure>

</section>
<section anchor="segment-routing-header-tlvs"><name>Segment Routing Header TLVs</name>

<t>This I-D requests the IANA to allocate, within the &quot;Segment Routing Header TLVs&quot; registry, the following allocations:</t>

<figure><artwork><![CDATA[
Value      Description               Reference
----------------------------------------------
TBA2-1     Opaque Metadata TLV       [This.ID]
TBA2-2     NSH Carrier TLV           [This.ID]
]]></artwork></figure>

</section>
</section>
<section anchor="security-considerations"><name>Security Considerations</name>

<t>The security requirements and mechanisms described in <xref target="RFC8402"/>, <xref target="RFC8754"/> and <xref target="RFC8986"/> also apply to this document.</t>

<t>This document does not introduce any new security vulnerabilities.</t>

</section>
<section anchor="acknowledgements"><name>Acknowledgements</name>

<t>The authors would like to thank Thierry Couture, Ketan Talaulikar, Loa Andersson, Andrew G.  Malis, Adrian Farrel, Alexander Vainshtein and Joel M.  Halpern for their valuable comments and suggestions on the document.</t>

</section>


  </middle>

  <back>


    <references title='Normative References' anchor="sec-normative-references">

&RFC8402;
&RFC8660;
&RFC8754;
&RFC8986;
&RFC9256;


    </references>

    <references title='Informative References' anchor="sec-informative-references">

&I-D.dawra-idr-bgp-sr-service-chaining;
&I-D.xu-mpls-payload-protocol-identifier;
&RFC7665;
&RFC8300;
&RFC8595;
<reference anchor="IFIP18" >
  <front>
    <title>SEgment Routing Aware Firewall For Service Function Chaining scenarios</title>
    <author initials="A." surname="Abdelsalam">
      <organization></organization>
    </author>
    <author initials="S." surname="Salsano">
      <organization></organization>
    </author>
    <author initials="F." surname="Clad">
      <organization></organization>
    </author>
    <author initials="P." surname="Camarillo">
      <organization></organization>
    </author>
    <author initials="C." surname="Filsfils">
      <organization></organization>
    </author>
    <date year="2018" month="May"/>
  </front>
  <seriesInfo name="IFIP Networking conference" value=""/>
</reference>
<reference anchor="IPTABLES" target="https://netfilter.org/projects/iptables/files/changes-iptables-1.6.2.txt">
  <front>
    <title>iptables-1.6.2 changes</title>
    <author >
      <organization></organization>
    </author>
    <date year="2018" month="February"/>
  </front>
</reference>
<reference anchor="NFTABLES" target="https://netfilter.org/projects/nftables/files/changes-nftables-0.8.4.txt">
  <front>
    <title>nftables-0.8.4 changes</title>
    <author >
      <organization></organization>
    </author>
    <date year="2018" month="May"/>
  </front>
</reference>
<reference anchor="SNORT" target="https://github.com/SRouting/SR-Snort">
  <front>
    <title>SR-Snort</title>
    <author >
      <organization></organization>
    </author>
    <date year="2018" month="March"/>
  </front>
</reference>


    </references>


    <section anchor="contributors" numbered="false" toc="include" removeInRFC="false">
        <name>Contributors</name>
    <contact initials="P." surname="Camarillo" fullname="Pablo Camarillo">
      <organization>Cisco Systems, Inc.</organization>
      <address>
        <postal>
          <country>Spain</country>
        </postal>
        <email>pcamaril@cisco.com</email>
      </address>
    </contact>
    <contact initials="B." surname="Peirens" fullname="Bart Peirens">
      <organization>Proximus</organization>
      <address>
        <postal>
          <country>Belgium</country>
        </postal>
        <email>bart.peirens@proximus.com</email>
      </address>
    </contact>
    <contact initials="D." surname="Steinberg" fullname="Dirk Steinberg">
      <organization>Lapishills Consulting Limited</organization>
      <address>
        <postal>
          <country>Cyprus</country>
        </postal>
        <email>dirk@lapishills.com</email>
      </address>
    </contact>
    <contact initials="A." surname="AbdelSalam" fullname="Ahmed AbdelSalam">
      <organization>Cisco Systems, Inc.</organization>
      <address>
        <postal>
          <country>Italy</country>
        </postal>
        <email>ahabdels@cisco.com</email>
      </address>
    </contact>
    <contact initials="G." surname="Dawra" fullname="Gaurav Dawra">
      <organization>LinkedIn</organization>
      <address>
        <postal>
          <country>United States of America</country>
        </postal>
        <email>gdawra@linkedin.com</email>
      </address>
    </contact>
    <contact initials="S." surname="Bryant" fullname="Stewart Bryant">
      <organization>Futurewei Technologies Inc</organization>
      <address>
        <email>stewart.bryant@gmail.com</email>
      </address>
    </contact>
    <contact initials="H." surname="Assarpour" fullname="Hamid Assarpour">
      <organization>Broadcom</organization>
      <address>
        <email>hamid.assarpour@broadcom.com</email>
      </address>
    </contact>
    <contact initials="H." surname="Shah" fullname="Himanshu Shah">
      <organization>Ciena</organization>
      <address>
        <email>hshah@ciena.com</email>
      </address>
    </contact>
    <contact initials="L. M." surname="Contreras" fullname="Luis M. Contreras">
      <organization>Telefonica I+D</organization>
      <address>
        <postal>
          <country>Spain</country>
        </postal>
        <email>luismiguel.contrerasmurillo@telefonica.com</email>
      </address>
    </contact>
    <contact initials="J." surname="Tantsura" fullname="Jeff Tantsura">
      <organization>Individual</organization>
      <address>
        <email>jefftant@gmail.com</email>
      </address>
    </contact>
    <contact initials="M." surname="Vigoureux" fullname="Martin Vigoureux">
      <organization>Nokia</organization>
      <address>
        <email>martin.vigoureux@nokia.com</email>
      </address>
    </contact>
    <contact initials="J." surname="Bhattacharya" fullname="Jisu Bhattacharya">
      <organization>Cisco Systems, Inc.</organization>
      <address>
        <postal>
          <country>United States of America</country>
        </postal>
        <email>jisu@cisco.com</email>
      </address>
    </contact>
    </section>

  </back>

<!-- ##markdown-source:
H4sIAAAAAAAAA+192XIbSZLgO74iR2U2S24BKFIlsSTuVJsoUSxyhqK4IqWe
tp7esQQQBLKUyETnQRItaW1/Y39vv2T9jCOROKirqnuE7oLAPCI8PDz8Do9e
r9epkio1+9GFKa6ToYnOi3xcxNNpko2jm6SawI3x1GRV9CqvK7jYGeXDLJ7C
G6Mivqp6iamueuWsgFu9suiV3Exv5prp7TzujOLK7HeG8D3Oi/l+VFajTlkP
pklZJnl2OZ9BeyfPL486nWRW7EdVUZfV/Z2dxzv3O3Fh4v3oF5OZIk47N3nx
dlzk9QwgPn91cvZL562Zw8URvJ9VpshM1TtEwDqdYT6C3vejuuzF5TBJOrNk
P/pzlQ+7UZkXVWGuSvg1n+KPv3Q6cV1N8mK/E/U6UZRk5X501I+epfEI/uQB
HxVxNsyTUq/mxTjOkr/FFQxhP3qWlMM8upiXlZlCwyfZsA/PFDki14ySKi/g
TzONk3Q/uhpCC31E3ZMxXukP8yncHeZ1ViF6qCfjgfLv/ejfawvIvydxPqn5
SgOISZLF0Yt8kKRmae+39S018GQ4Lcv+EF+Z0hsMhu30WT86StLyCv6zXcPQ
CwOw+Xc2wYN0Pbx6MsT7zQE/Nek4qf3OD/twscgSU9i+D6EXk3qXw46hjTR6
FmfxKHYdjuid/oDfeTKAZ/rD2O9a3/CHfZq4AU8MrAS6EHZ3XMc3JvGGhg+m
ye6PTyZ0p4HMp/3o0AyLGOjYtv20qLPcvxz28BKoYGxcDwN8vD+Sx5/kdHst
6Vz0oxex7fJiEuc3JuNLYXcvADdxlt+6DqdxyY/7VOrj6U/xKI1ncZr6+IqT
Ks7mcXgz7Org8p8vPczNdx4/Gj2Jq6o5mNcXB16Hf+xHxyYbmSIZvr21Hf4x
mYaXw67O8reJRw83ybQ/sU8/yfDuemIEHF7EaQnYcYiszBX87V0P+32dJdem
KAEX0SgB5jmNo3uXeRG9MfBYFd9zIJXcUr/klp7UWVLA4/f7SeVDdVLF6Ry5
GvyZDOoq5FXnwKviaVwkaepgPI8HaR5cv8NSnQ35vfYFezGLkywk73OTAGtw
rOJpXFTexbBrEDO3ybQuPeqGx/szfvzJTG5vxCdgKpIMVvjYcYqkeBtcDjs/
jWdJOQGUACvPs7JOUbDBGp8mlRl5vANaeZLaZ5uwPJvPChyABeWgHx0MRiYF
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
CHZIL+vxGPNNUIES54HD2f8HE0lJSwgOAQA=

-->

</rfc>

