<?xml version="1.0" encoding="UTF-8"?>

<?rfc sortrefs="yes"?>
<?rfc subcompact="no"?>
<?rfc symrefs="yes"?>
<?rfc toc="yes"?>
<?rfc tocdepth="3"?>
<?rfc compact="yes"?>
<?rfc subcompact="no"?>

<rfc xmlns:xi="http://www.w3.org/2001/XInclude"
  category="std"
  docName="draft-ietf-sidrops-cms-signing-time-01"
  updates="6488"
  ipr="trust200902"
  submissionType="IETF"
  consensus="true">

<front>

  <title abbrev="RPKI CMS Signing-Time">On the use of the CMS signing-time attribute in RPKI Signed Objects</title>

  <author fullname="Job Snijders" initials="J." surname="Snijders">
    <organization>Fastly</organization>
    <address>
      <postal>
        <street />
        <city>Amsterdam</city>
        <code />
        <country>Netherlands</country>
      </postal>
      <email>job@fastly.com</email>
    </address>
  </author>

  <author fullname="Tom Harrison" initials="T." surname="Harrison">
    <organization abbrev="APNIC">Asia Pacific Network Information Centre</organization>
    <address>
      <postal>
        <street>6 Cordelia St</street>
        <city>South Brisbane</city>
        <code>4101</code>
        <country>Australia</country>
        <region>QLD</region>
      </postal>
      <phone/>
      <email>tomh@apnic.net</email>
    </address>
  </author>

  <date />

  <area>RPKI</area>
  <workgroup>SIDROPS</workgroup>
  <keyword>CMS</keyword>
  <keyword>signing-time</keyword>

  <abstract>

    <t>
      RFC 6488 standardized a template for specifying Cryptographic Message Syntax (CMS) protected content types for use with the Resource Public Key Infrastructure (RPKI) called Signed Objects.
      Since the publication of that document, a new additional protocol for distribution of RPKI repositories was developed: the RPKI Repository Delta Protocol (RRDP) (RFC 8182) and new insights arose with respect to querying and combining the different distribution mechanisms.
      This document describes how Publishers and Relying Parties can use the CMS signing-time attribute to facilitate seamless switchovers from RRDP to RSYNC.
      Additionally, this document updates RFC 6488 by mandating the presence of the CMS signing-time attribute and disallowing the binary-signing-time attribute in Signed Objects.
    </t>

  </abstract>

  <note title="Requirements Language">
      <t>
        The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "NOT RECOMMENDED", "MAY", and "OPTIONAL" in this document are to be interpreted as described in BCP 14 <xref target="RFC2119"/> <xref target="RFC8174"/> when, and only when, they appear in all capitals, as shown here.
      </t>
  </note>

</front>

<middle>

  <section title="Introduction">
    <t>
      <xref target="RFC6488"/> standardized a template for specifying Cryptographic Message Syntax (CMS) <xref target="RFC5652"/> <xref target="RFC6268"/> protected content types for use with the Resource Public Key Infrastructure (RPKI) <xref target="RFC6480"/> called Signed Objects.
      Since the publication of that document, a new additional protocol for distribution of RPKI repositories was developed, the RPKI Repository Delta Protocol (RRDP) <xref target="RFC8182"/>, and new insights arose with respect to querying and combining the different distribution mechanisms.
      This document describes how Publishers and Relying Parties can use the CMS signing-time attribute to facilitate seamless switchover from RRDP to RSYNC.
      Additionally, this document updates <xref target="RFC6488"/> by mandating the presence of the CMS signing-time attribute and disallowing the binary-signing-time attribute in Signed Objects.
    </t>
  </section>

  <section title="Seamless switchovers from RRDP to RSYNC">
    <t>
      To avoid needless re-transfers of unchanged files in consecutive RSYNC synchronizations, <xref target="I-D.timbru-sidrops-publication-server-bcp"/> recommends the use of so-called 'deterministic' (normalized) timestamps for files: as long as a given file's contents are unchanged, Publishers SHOULD ensure that file's last modification timestamp also doesn't change.
    </t>
    <t>
      This document advances the aforementioned concept by describing a synchronization strategy through which needless transfers are also avoided upon first use of RSYNC, by leveraging data previously fetched via RRDP.
    </t>
    <t>
      As described in <xref target="I-D.ietf-sidrops-prefer-rrdp"/> and as implemented by all major RPKI cache software projects, modern RPs will first attempt synchronization via RRDP, and if and only if this synchronization via RRDP for some reason fails (malformed XML, expired TLS certificate, HTTP connection timeout, etc.) - then proceed to attempt to synchronize via RSYNC instead.
    </t>
    <t>
      In the RSYNC synchronization protocol, a file's last modification timestamp (from here on 'mod-time') and filesize are used to determine whether the general-purpose RSYNC synchronization algorithm needs to be executed for the file.
      This is the default mode for both GPL <xref target="rsync"/> and BSD <xref target="openrsync"/>.
      If the sender's copy of the file and the receiver's copy of the file both have the same mod-time and filesize, the files are assumed to contain the same content, and will be omitted from the list of files to be transferred.
      Ensuring consistency with respect to mod-time for both senders and receivers helps to reduce the burden of RSYNC synchronization in terms of network bandwidth, disk I/Ooperations, and CPU usage.
    </t>
    <t>
      In order to reduce the burden of the RSYNC synchronization (following a RRDP failure), Publishers and Relying Parties SHOULD adhere to the following guidelines.
    </t>
    <section title="Guidance for Publishers">
      <t>
        When serializing RPKI Signed Objects to a filesystem hierarchy for publication via RSYNC, the mod-time of the file containing the Signed Object SHOULD be set to the value of the CMS signing-time attribute contained within the Signed Object.
      </t>
    </section>
    <section title="Guidance for Relying Parties" anchor="rpguidance">
      <t>
        When serializing RPKI Signed Objects retrieved via RRDP to a filesystem hierarchy, the mod-time of the file containing the Signed Object SHOULD be set to the value of the CMS signing-time attribute contained within the Signed Object.
      </t>
      <t>
        If an RP uses RRDP to synthesize a filesystem hierarchy for the repository, then synchronizing from the publisher to the corresponding directory directly is an option.
        Alternatively, the RP can synchronize to a new (empty) directory using the <em>--compare-dest=DIR</em> rsync feature, in order to avoid retrieving files that are already available by way of the synthesized filesystem hierarchy stemming from previous RRDP fetches.
        The <em>DIR</em> component is to be substituted with the name of the directory containing previously fetched and validated RPKI data (in its original DER-encoded form, to ensure the filesize parameter matches).
      </t>
      <t>
        Quoted from the GPL rsync man page for <em>--compare-dest=DIR</em>:
      </t>
      <t>
        <list style="empty">
          <t>
            This option instructs rsync to use <em>DIR</em> on the destination machine as an additional hierarchy to compare destination files against doing transfers (if the files are missing in the destination directory).
            If a file is found in <em>DIR</em> that is identical to the sender's file, the file will NOT be transferred to the destination directory.
            This is useful for creating a sparse backup of just files that have changed from an earlier backup.
          </t>
        </list>
      </t>
      <t>
        Quoted from the BSD openrsync man page for <em>--compare-dest=directory</em>:
      </t>
      <t>
        <list style="empty">
          <t>
             Use <em>directory</em> as an alternate base directory to compare files against on the destination machine.
             If file in <em>directory</em> is found and identical to the sender's file, the file will not be transferred.
          </t>
        </list>
      </t>
    </section>
  </section>

  <section title="Presence of the CMS signing-time attribute in the field">
    <t>
      Analysing an archive <xref target="rpkiviews"/> containing valid RPKI Signed Objects discovered via the five RIR Trust Anchors in the last 12 months (2022-06-06 to 2023-06-06), all of the 3,004,296,251 inspected Signed Objects contain a CMS signing-time attribute.
    </t>
    <t>
      The above means that - already today - all Certificate Authorities produce Signed Objects which contain a CMS signing-time attribute. <!-- and have done so for quite a while. -->
      Thus, making the CMS signing-time attribute mandatory would not make any existing CA operations non-compliant.
    </t>
    <t>
      As of 3 June, 2023, for 25.8% of Signed Objects the CMS signing-time timestamp exactly matches the file's mod-time observed via RSYNC.
      This means that it is already the case that RPs would see a significant reduction in the amount of processing required in RSYNC if they adopted the strategy outlined in <xref target="rpguidance"/>.
    </t>
    <t>
      In the above-mentioned period of time, zero Signed Objects were discovered with a CMS binary-signing-time <xref target="RFC6019"/> attribute.
      Therefore, disallowing the CMS binary-signing-time attribute would not make any existing CA operations non-compliant.
    </t>
  </section>

  <section title="Update to RFC 6488">
    <t>
      This section updates <xref target="RFC6488"/> to make the CMS signing-time attribute mandatory and disallow the presence of the CMS binary-signing-time attribute.
    </t>
    <t>
      In section 2.1.6.4 the paragraph starting with "The signedAttrs element MUST be present and ..." and ending in "Other signed attributes MUST NOT be included." is replaced with the following text:
    </t>
    <t>
      <list style="empty">
        <t>
          The signedAttrs element MUST be present and MUST include the content-type, message-digest, and signing-time attributes <xref target="RFC5652"/>.
          Other signed attributes MUST NOT be included.
        </t>
      </list>
    </t>
    <t>
      In section 2.1.6.4.3 the first sentence "The signing-time attribute MAY be present." is replaced with the following text:
    </t>
    <t>
      <list style="empty">
        <t>
          The signing-time attribute MUST be present.
        </t>
      </list>
    </t>
    <t>
      Section 2.1.6.4.4 is removed in its entirety.
    </t>
  </section>

  <section title="Security Considerations">
    <t>
      This document has no Security Considerations.
    </t>
  </section>

  <section title="IANA Considerations">
    <t>
      This document has no IANA actions.
    </t>
  </section>

  <section title="Acknowledgements">
    <t>
      The authors would like to thank
      <contact fullname="Ties de Kock"/>
      for their helpful review of this document.
    </t>
  </section>

</middle>

<back>

  <references title="Normative References">
    <?rfc include="reference.RFC.2119.xml"?>
    <?rfc include="reference.RFC.8174.xml"?>
    <?rfc include="reference.RFC.8182.xml"?>
    <?rfc include="reference.RFC.5652.xml"?>
    <?rfc include="reference.RFC.6268.xml"?>
    <?rfc include="reference.RFC.6480.xml"?>
    <?rfc include="reference.RFC.6488.xml"?>
  </references>

  <references title="Informative References">
    <?rfc include="reference.RFC.6019.xml"?>
    <?rfc include="reference.RFC.9286.xml"?>

    <xi:include href="https://bib.ietf.org/public/rfc/bibxml3/reference.I-D.timbru-sidrops-publication-server-bcp.xml"/>
    <xi:include href="https://bib.ietf.org/public/rfc/bibxml3/reference.I-D.ietf-sidrops-prefer-rrdp.xml"/>

    <reference anchor="rsync" target="https://rsync.samba.org/">
      <front>
        <title>rsync</title>
        <author fullname="Andrew Tridgell"/>
        <author fullname="Paul Mackerras"/>
        <author fullname="Wayne Davison"/>
        <date year="2022" />
      </front>
    </reference>

    <reference anchor="openrsync" target="https://www.openrsync.org/">
      <front>
        <title>openrsync</title>
        <author fullname="Claudio Jeker"/>
        <author fullname="Florian Obser"/>
        <author fullname="Kristaps Dzonsons"/>
        <date year="2023" />
      </front>
    </reference>

    <reference anchor="rpkitouch" target="https://github.com/job/rpkitouch">
      <front>
        <title>rpkitouch</title>
        <author fullname="Job Snijders">
          <organization>Fastly</organization>
        </author>
        <date month="June" year="2023" />
      </front>
    </reference>

    <reference anchor="rsyncit" target="https://github.com/RIPE-NCC/rsyncit/">
      <front>
        <title>rsyncit</title>
        <author>
          <organization>RIPE NCC</organization>
        </author>
        <date month="November" year="2023" />
      </front>
    </reference>

    <reference anchor="apnicrepository" target="https://rpki.apnic.net/">
      <front>
        <title>APNIC Repository</title>
        <author>
          <organization>APNIC</organization>
        </author>
        <date year="2023" />
      </front>
    </reference>

    <reference anchor="rpki-rrdp-tools-py" target="https://github.com/ties/rpki-rrdp-tools-py/">
      <front>
        <title>rpki-rrdp-tools-py</title>
        <author fullname="Ties de Kock"/>
        <date month="November" year="2023" />
      </front>
    </reference>

    <reference anchor="rpkiviews" target="http://www.rpkiviews.org/">
      <front>
        <title>rpkiviews</title>
        <author fullname="Job Snijders"/>
        <date month="June" year="2023" />
      </front>
    </reference>

    <reference anchor="rpki-client" target="https://www.rpki-client.org/">
      <front>
        <title>rpki-client</title>
        <author fullname="Claudio Jeker"/>
        <author fullname="Job Snijders"/>
        <author fullname="Kristaps Dzonsons"/>
        <author fullname="Theo Buehler"/>
        <date month="June" year="2023" />
      </front>
    </reference>

    <reference anchor="PAM23" target="https://www.iijlab.net/en/members/romain/pdf/romain_pam23.pdf">
      <front>
        <title>RPKI Time-of-Flight: Tracking Delays in the Management, Control, and Data Planes</title>
        <author fullname="Romain Fontugne"/>
        <author fullname="Amreesh Phokeer"/>
        <author fullname="Cristel Pelsser"/>
        <author fullname="Kevin Vermeulen"/>
        <author fullname="Randy Bush"/>
        <date month="February" year="2023" />
      </front>
    </reference>

    <reference anchor="ls" target="https://pubs.opengroup.org/onlinepubs/9699919799/utilities/ls.html">
      <front>
        <title>ls - The Open Group Base Specifications Issue 7</title>
        <author>
          <organization>IEEE and The Open Group</organization>
        </author>
        <date year="2018"/>
      </front>
    </reference>

  </references>

  <section title="Considerations and Alternative Approaches">
    <t>
      A slightly different approach that has been suggested is to normalize file mod-times based on the Signed Object's embedded End-Entity (EE) X.509 notBefore timestamp value.
      A downside of this approach is that objects from CAs not using one-time use EE certificates, per section 5.1.1 of <xref target="RFC9286" /> would result in multiple objects singed at different points in time with the same mod-times.
    </t>
    <t>
      Additionally, CAs might backdate the notBefore timestamp to increase the validity window of the Signed Object, which in turn decreases insight for RPKI operators as to when exactly the Signed Object purportedly came into existence.
      Along similar lines, the notBefore timestamp may be set in the future for contractual reasons.
      Setting the mod-time of a file to a future date may be unintuitive for users, and some programs (e.g. GNU make) will warn on encountering files with such mod-times.
    </t>
    <t>
      There is also an increased chance of two distinct objects published to the same path having the same mod-time and filesize under this approach, due to CAs setting the notBefore timestamp to some stable value for a given object and reissuance often not changing the file size (e.g. where a prefix or a max-length value is changed in a ROA).
      In such a situation, if the receiver has the first copy of a file, RSYNC retrieval will skip the second copy of the file, and the synchronization operation for the associated repository will result in a "failed fetch", per section 6.6 of <xref target="RFC9286" />, due to an inconsistency between the file's hash and the hash listed in the associated manifest.
      That in turn necessitates further retrieval operations on the part of the receiver.
      The chance of two distinct objects being issued with the same mod-time and filesize when CMS signing-time is used to set the mod-time is much smaller, since it requires that those distinct objects be issued in very close succession.
    </t>
    <t>
      Another downside of using notBefore is that Publishers would need to deserialize both the CMS envelope and the X.509 EE certificate contained therein to extract a timestamp, instead of merely parsing the CMS envelope.
    </t>
    <t>
      Ensuring the mod-time is set to the CMS signing-time gives RPKI operators a headstart when using tools like <xref target="ls"/>, in the sense that the mod-time aligns with the purported time of object issuance.
    </t>
    <t>
      The CMS signing-time attribute has proven useful in researching and tracking delays in various layers of the RPKI <xref target="PAM23"/>.
      Mandating the CMS signing-time to be present might aid future researchers studying the RPKI ecosystem.
    </t>
    <t>
      The <strong>--checksum</strong> option to rsync disables the mod-time and filesize comparison check in favour of a check based on a whole-file checksum.
      This check is slower than the mod-time and filesize check, but (in instances where the file content has not changed) faster than the general-purpose RSYNC synchronization algorithm.
      Since ensuring consistency between the mod-time and filesize on both sides of the transaction is straightforward, there is no particular reason to pursue an approach based on rsync's <strong>--checksum</strong> feature.
    </t>
  </section>

  <section title="Implementation status - RFC EDITOR: REMOVE BEFORE PUBLICATION">
    <t>
      This section records the status of known implementations of the protocol defined by this specification at the time of posting of this Internet-Draft, and is based on a proposal described in RFC 7942.
      The description of implementations in this section is intended to assist the IETF in its decision processes in progressing drafts to RFCs.
      Please note that the listing of any individual implementation here does not imply endorsement by the IETF.
      Furthermore, no effort has been spent to verify the information presented here that was supplied by IETF contributors.
      This is not intended as, and must not be construed to be, a catalog of available implementations or their features.
      Readers are advised to note that other implementations may exist.
    </t>

    <t>
      According to RFC 7942, "this will allow reviewers and working groups to assign due consideration to documents that have the benefit of running code, which may serve as evidence of valuable experimentation and feedback that have made the implemented protocols more mature.
      It is up to the individual working groups to use this information as they see fit".
    </t>

    <t>
      <list style="symbols">
        <t><xref target="rpkitouch"/> - a timestamp setter utility for both RSYNC servers and RRDP clients by Job Snijders in C.</t>
        <t><xref target="rpki-client"/> - a Relying Party implementation by OpenBSD in C, a client side implementation.</t>
        <t><xref target="rsyncit"/> - a RRDP-to-RSYNC sync tool by RIPE NCC in Java, run on the server side.</t>
        <t><xref target="apnicrepository"/> - the public APNIC RPKI repository - the APNIC RSYNC server normalizes timestamps.</t>
        <t><xref target="rpki-rrdp-tools-py"/> - a number of client-side RRDP utilities by Ties de Kock in Python.</t>
      </list>
    </t>

  </section>

</back>

</rfc>
