<?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.6.21 (Ruby 3.0.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-07" category="std" consensus="true" 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@cisco.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="2023" month="February" day="15"/>

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

    <abstract>


<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>


<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'>

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


    </references>

    <references title='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:
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
cwlPaNtoKA1rLDfkmMcLW6q5cvSvWU7SD9ZaOXjhFD71wBPloUt3uZddF201
erW8NG6BRb3NlO1XqNpSmF7zhclwnWGr9GFx/umsYn8g9aeY6yI/RQ323s6O
sgCt/LmsZnUplZIruq6bWIgTeqL4c6ocEVnZD6NP9gZerlJpr531dGtb9hUv
cVRbpbUSdbRYzPnaqi5WW9EhcYezRcpY6JIPn6AXO5yy/mBsvS4r0ItwvOfu
lvIu5p8VNWHmEMQG7/xzuhYcWNghqFl609Exj5cLvWNsA++6eg689BpkIGM0
nuZatTeowKqld+3VP1h9t53HI4ByEdtKxuBdxLkY94inPUAz+3QWvyKbDL50
93TjdckJah0F4owrKcs96Yt1+FeB1eWytWidGdwTPf+t7q9cwj/gZQv1+0mm
MKulcu9mTCE0MSNESfT0wq1n2WibFFsQVz5r4BW3RflJh/O0Qntp/BC2Ranx
auwkzfO39cwKXu6tjZEmpVe3nEqFt1x3LiY6R/KS8aTSwC0y3ng5l25hop7f
M9CyOdzvu0L9r/ejT3CMLjXt22XWtyJE39Kl5edbuvSvlC6905oi3cZjdD4r
UqS/fIbx7uapbT7P2cQ9v8ijvmZy8TIO+XEe0MNw+muZ+tJc184neju9XNfO
5y/SshnbX8qRf/i9ceRFaRPu9X+xIk2EzcZMW0Jxt2XbLYzbtZbsdIm4fTam
/bFs+yMY98eu0yMJbDqB9SnnVG5zUuWWQuMLJSCjsPkYLr1h8nE7p0Zt10cU
GXpklDVyW8XO6nTO1dzjXDJl723sLVD8iBvPlRSsf7QDI8JfbWYj50ToAJqM
2LasA06akmBuS7qyyy0XK685Z74R3L3XLlyQ02bo9WezdoRfdUK+7CWwNSP9
O48k0r+j4zSWMjjAYINYbYv94cNGyQJ2T23T/gqTBTY8A9DcVk1FiJmkj+Ct
z7SBN93B63IPiMifSk7AMuJmT4FH3nrvNS6+EDD6IjgtMi6toVy6rU7+Be/K
qnZnyIivB7We5MXs5ZJD5spW8KKpFZmfmnX+wcuaJR3t9iRNkYQDBnBjst69
L2T9oM1fsgFNU8bNZskvH62PB/J3tTRAdfCzpNSsSKj5LIr/Ws1/zbbogU4+
iivHwXshfbiFI16NymqXJq+ZTPYuoqOOJ+HXca7NHBgcAViufG9tdtKs80na
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
/w+3D1t6JQ4BAA==

-->

</rfc>

