<?xml version='1.0' encoding='utf-8'?>
<!DOCTYPE rfc [
  <!ENTITY nbsp    "&#160;">
  <!ENTITY zwsp   "&#8203;">
  <!ENTITY nbhy   "&#8209;">
  <!ENTITY wj     "&#8288;">
]>
<rfc xmlns:xi="http://www.w3.org/2001/XInclude" docName="draft-makarenko-gost2012-dnssec-05" category="info" ipr="trust200902" obsoletes="" updates="" submissionType="IETF" xml:lang="en" symRefs="true" sortRefs="false" tocInclude="true" version="3">
  <!-- xml2rfc v2v3 conversion 3.19.1 -->
  <front>
    <title abbrev="Use of GOST 2012 Signatures in DNSSEC">
    Use of GOST 2012 Signature Algorithms in DNSKEY and RRSIG Resource Records for DNSSEC
    </title>
    <seriesInfo name="Internet-Draft" value="draft-makarenko-gost2012-dnssec-04"/>
    <author fullname="Boris Makarenko" initials="B." surname="Makarenko">
      <organization>The Technical center of Internet, LLC</organization>
      <address>
        <postal>
          <street>8 marta str., 1, bld 12</street>
          <city>Moscow</city>
          <code>127083</code>
          <country>Russian Federation</country>
        </postal>
        <email>bmakarenko@tcinet.ru</email>
      </address>
    </author>
    <author fullname="Vasily Dolmatov" initials="V." surname="Dolmatov" role="editor">
      <organization>JSC "NPK Kryptonite"</organization>
      <address>
        <postal>
          <street>Spartakovskaya sq., 14, bld 2, JSC "NPK Kryptonite"</street>
          <city>Moscow</city>
          <code>105082</code>
          <country>Russian Federation</country>
        </postal>
        <email>vdolmatov@gmail.com</email>
      </address>
    </author>
    <date month="January" year="2024" day="25"/>
    <abstract>
      <t>
      This document describes how to produce digital signatures and hash
      functions using the GOST R 34.10-2012 and GOST R 34.11-2012 algorithms
      for DNSKEY, RRSIG, and DS resource records, for use in the Domain
      Name System Security Extensions (DNSSEC).
      </t>
    </abstract>
  </front>
  <middle>
    <section numbered="true" toc="default">
      <name>Introduction</name>
      <t>
        The Domain Name System (DNS) is the global hierarchically distributed
        database for Internet Naming. The DNS has been extended to use
        cryptographic keys and digital signatures for the verification of the
        authenticity and integrity of its data. RFC 4033 <xref target="RFC4033" format="default"/>, RFC 4034
        <xref target="RFC4034" format="default"/>, and RFC 4035 <xref target="RFC4035" format="default"/> describe these DNS Security
        Extensions, called DNSSEC.
      </t>
      <t>
        RFC 4034 describes how to store DNSKEY and RRSIG resource records,
        and specifies a list of cryptographic algorithms to use. This
        document extends that list with the signature and hash algorithms
        GOST R 34.10-2012 (<xref target="RFC7091" format="default"/>) and GOST R 34.11-2012
        (<xref target="RFC6986" format="default"/>), and specifies how to store DNSKEY data and
        how to produce RRSIG resource records with these algorithms.
      </t>
      <t>
        Algorithms GOsudarstvennyy STandart(GOST) R 34.10-2012 and GOST R 34.11-2012 are Russian national standards.
        Their cryptographic properties haven't been independently verified.
      </t>
      <t>
        Familiarity with DNSSEC and with GOST signature and hash algorithms
        is assumed in this document.
      </t>
      <section numbered="true" toc="default">
        <name>Terminology</name>
        <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" format="default"/> <xref target="RFC8174" format="default"/> when, and only when,
          they appear in all capitals, as shown here.
        </t>
      </section>
    </section>
    <section numbered="true" toc="default">
      <name>DNSKEY Resource Records</name>
      <t>
        The format of the DNSKEY RR can be found in RFC 4034 <xref target="RFC4034" format="default"/>.
      </t>
      <t>
        GOST R 34.10-2012 public keys are stored with the algorithm number TBA1.
      </t>
      <t>
        According to RFC 7091 <xref target="RFC7091" format="default"/>, a GOST R 34.10-2012 public key is a point on the
        elliptic curve Q = (x,y). The wire representation of a public key MUST
        contain 64 octets, where the first 32 octets contain the little-endian
        representation of x and the second 32 octets contain the little-endian
        representation of y.
      </t>
      <t>
        As RFC 6986 and RFC 7091 allows 2 variants of length of the output hash and signature
        and many variants of parameters of the digital signature, for the purpose of this
        document we use 256-bit variant of the digital signature algorithm, corresponding
        256-bit variant of the digest algorithm. We select the parameters for
        the digital signature algorithm to be id-tc26-gost-3410-2012-256-paramSetA
        as specified in RFC 7836 <xref target="RFC7836" format="default"/>.
      </t>
      <section numbered="true" toc="default">
        <name>Using a Public Key with Existing Cryptographic Libraries</name>
        <t>
          At the time of this writing, existing GOST-aware cryptographic
          libraries are capable of reading GOST R 34.10-2012 public keys via a generic X.509
          API if the key is encoded according to RFC 9215 <xref target="RFC9215" format="default"/>, Section 4.
        </t>
        <t>
          To make this encoding from the wire format of a GOST R 34.10-2012 public key with
          the parameters used in this document, prepend the 64 octets of key
          data with the following 30-byte sequence:
        </t>
        <artwork name="" type="" align="left" alt=""><![CDATA[
0x30 0x5c 0x30 0x17 0x06 0x08 0x2a 0x85
0x03 0x07 0x01 0x01 0x01 0x01 0x30 0x0b
0x06 0x09 0x2a 0x85 0x03 0x07 0x01 0x02
0x01 0x01 0x01 0x03 0x41 0x00
]]></artwork>
        <t>
          These bytes provide the following ASN.1 structure suitable for parsing by cryptographic toolkits:
        </t>
        <artwork name="" type="" align="left" alt=""><![CDATA[
  0  92: SEQUENCE {
  2  23:   SEQUENCE {
  4   8:     OBJECT IDENTIFIER '1 2 643 7 1 1 1 1'
 14  11:     SEQUENCE {
 16   9:       OBJECT IDENTIFIER '1 2 643 7 1 2 1 1 1'
       :       }
       :     }
 27  65:   BIT STRING
]]></artwork>
        <t>
          The OIDs in the structure above represent GOST R 34.10-2012 public key with 256 bits private key
          length algorithm and Parameter set A. The structure itself represents SubjectPublicKeyInfo field
          of an X.509 certificate as defined in RFC 5280 <xref target="RFC5280" format="default"/>, Section 4.1.
        </t>
      </section>
      <section numbered="true" toc="default">
        <name>GOST DNSKEY RR Example</name>
        <t>
          Given a private key with the following value:
        </t>
        <artwork name="" type="" align="left" alt=""><![CDATA[
Private-key-format: v1.2
Algorithm: TBA1 (ECC-GOST12)
Gost12Asn1: MD4CAQAwFwYIKoUDBwEBAQEwCwYJKoUDBwECAQEBBCD/Mw9o6R5lQHJ13jz0
            W+C1tdsS4W7RJn04rk9MGJq3Hg==
]]></artwork>
        <t>
          The following DNSKEY RR stores a DNS zone key for example:
        </t>
        <artwork name="" type="" align="left" alt=""><![CDATA[
example.  600  IN  DNSKEY  256 3 TBA1 (
            XGiiHlKUJd5fSeAK5O3L4tUNCPxs4pGqum6wKbqjdkqu
            IQ8nOXrilXZ9HcY8b2AETkWrtWHfwvJD4twPPJFQSA==
    ) ;{id = 47355 (zsk), size = 512b}
]]></artwork>
        <t>
          The private key here is presented in PrivateKeyInfo ASN.1 structure, as described in RFC5208 <xref target="RFC5208" format="default"/>, Section 5.
        </t>
        <t>
          Public key can be calculated from the private key using algorithm described in RFC 7091 <xref target="RFC7091" format="default"/>.
        </t>
        <t>
          [RFC Editor note: Note: Algorithm numbers 23 and 5 are used as an example in this document, as actual numbers have not yet been assigned. If the assigned values will differ, the example keys and signatures will have to be recalculated before the official publication of the RFC.]
        </t>
      </section>
    </section>
    <section numbered="true" toc="default">
      <name>RRSIG Resource Records</name>
      <t>
       The value of the signature field in the RRSIG RR follows RFC 7091
       <xref target="RFC7091" format="default"/> and is calculated as follows.  The values for the RDATA
       fields that precede the signature data are specified in RFC 4034
       <xref target="RFC4034" format="default"/>.
      </t>
      <artwork name="" type="" align="left" alt=""><![CDATA[
hash = GOSTR3411-2012(data)
]]></artwork>
      <t>
        where "data" is the wire format data of the resource record set that
        is signed, as specified in RFC 4034 <xref target="RFC4034" format="default"/>.
      </t>
      <t>
        The signature is calculated from the hash according to the
        GOST R 34.10-2012 standard, and its wire format is compatible with
        RFC 7091 <xref target="RFC7091" format="default"/>.
      </t>
      <section numbered="true" toc="default">
        <name>RRSIG RR Example</name>
        <t>
          Consider a given RRset consisting of one MX RR to be signed with the
          private key described in Section 2.2 of this document:
        </t>
        <artwork name="" type="" align="left" alt=""><![CDATA[
example.  600  IN  MX  10 mail.example.]]></artwork>
        <t>
          Setting the inception date to 2022-10-06 12:32:30 UTC and the
          expiration date to 2022-11-03 12:32:30 UTC, the following signature
          RR will be valid:
        </t>
        <artwork name="" type="" align="left" alt=""><![CDATA[
example.  600 IN  RRSIG MX TBA1 1 600 20221103123230 (
                       20221006123230 47355 example.
                       EuLO0Qpn6zT1pzj9T2H5AWjcgzfmjNiK/vj811bExa0V
                       HMOVD9ma8rpf0B+D+V4Q0CWu1Ayzu+H/SyndnOWGxw==
)
]]></artwork>
        <t>
          The GOST R 34.10-2012 signature algorithm uses random (pseudorandom) integer k as described in Section 6.1
          of RFC 7091 <xref target="RFC7091" format="default"/>.
          The following value for k was used to produce the signature example.</t>
        <artwork name="" type="" align="left" alt=""><![CDATA[
k = 8BBD0CE7CAF3FC1C2503DF30D13ED5DB75EEC44060FA22FB7E29628407C1E34
]]></artwork>
        <t>
          This value for k MUST NOT be used when computing GOST R 34.10-2012 signatures.
          It is provided only so the above signature example can be reproduced.
          The actual signature value will differ between signature calculations.
        </t>
      </section>
    </section>
    <section numbered="true" toc="default">
      <name>DS Resource Records</name>
      <t>
        The GOST R 34.11-2012 digest algorithm is denoted in DS RRs by the
        digest type TBA2. The wire format of a digest value is compatible with
        RFC 6986 <xref target="RFC6986" format="default"/>.
      </t>
      <section numbered="true" toc="default">
        <name>DS RR Example</name>
        <t>
          For Key Signing Key (KSK):
        </t>
        <artwork name="" type="" align="left" alt=""><![CDATA[
example.  IN  DNSKEY  257 3 TBA1 (
                       p8Req8DLJOfPymO5vExuK4gCcihF5N1YL7veCJ47av+w
                       h/qs9yJpD064k02rYUHfWnr7IjvJlbn3Z0sTZe9GRQ==
                       ) ;{id = 29468 (ksk), size = 512b}
]]></artwork>
        <t>
          The DS RR will be:
        </t>
        <artwork name="" type="" align="left" alt=""><![CDATA[
example.  IN  DS  29468 TBA1 TBA2 (
                      6033725b0ccfc05d1e9d844d49c6cf89
                      0b13d5eac9439189947d5db6c8d1c1ec
                      )
]]></artwork>
      </section>
    </section>
    <section numbered="true" toc="default">
      <name>Operational Considerations</name>
      <section numbered="true" toc="default">
        <name>Key Sizes</name>
        <t>
          The key size of GOST R 34.10-2012 public keys conforming to this specification MUST be 512 bits according to RFC 7091 <xref target="RFC7091" format="default"/>.
        </t>
      </section>
      <section numbered="true" toc="default">
        <name>Signature Sizes</name>
        <t>
          The size of a GOST R 34.10-2012 signature conforming to this specification MUST be 512 bits according to RFC 7091 <xref target="RFC7091" format="default"/>.
        </t>
      </section>
      <section numbered="true" toc="default">
        <name>Digest Sizes</name>
        <t>
          The size of a GOST R 34.11-2012 digest conforming to this specification MUST be 256 bits according to RFC 6986 <xref target="RFC6986" format="default"/>.
        </t>
      </section>
    </section>
    <section numbered="true" toc="default">
      <name>Implementation Considerations</name>
      <t>
        The support of this cryptographic suite in DNSSEC-aware systems is OPTIONAL. According to RFC6840 <xref target="RFC6840" format="default"/>, Section 5.2 systems that do not support these algorithms MUST ignore the RRSIG, DNSKEY and DS resource records associated with the GOST R 34.10-2012 digital signature algorithm.
      </t>
      <t>
        [(To be removed in RFC). To check the correctness of the implementation, authors recommend using OpenSSL 1.1.1 or 3.0.x series, a fork of ldns available at https://github.com/beldmit/ldns/tree/gost2012, and a reference implementation of GOST crypto algorithms available at https://github.com/gost-engine/engine.]
      </t>
    </section>
    <section numbered="true" toc="default">
      <name>IANA Considerations</name>
      <t>
        This document updates the IANA registry
        "DNS Security Algorithm Numbers".
        The following entries have been added to the registry:
      </t>
      <artwork name="" type="" align="left" alt=""><![CDATA[
                                   Zone    Trans.
Value  Algorithm         Mnemonic  Signing Sec.  References
TBA1   GOST R 34.10-2012 ECC-GOST12    Y   *     RFC TBA
]]></artwork>
      <t>
        This document updates the IANA registry "Digest Algorithms" in the
        "Delegation Signer (DS) Resource Record (RR) Type Digest Algorithms" registry group
        by adding an entry for the GOST R 34.11-2012 algorithm:
      </t>
      <artwork name="" type="" align="left" alt=""><![CDATA[
Value   Algorithm           Status
TBA2    GOST R 34.11-2012   OPTIONAL
]]></artwork>
      <t>
          [RFC editor note:
          For the purpose of example computations, the following values were used:
          TBA1 = 23, TBA2 = 5. If the assigned values will differ, the example keys and signatures
          will have to be recalculated before the official publication of the RFC.]
      </t>
    </section>
    <section numbered="true" toc="default">
      <name>Security Considerations</name>
      <t>
       It is recommended to use a dual KSK algorithm signed zone until GOST-aware DNSSEC software become more widespread, unless GOST-only cryptography is required.
       Otherwise, GOST-signed zones may be considered unsigned by the DNSSEC software currently in use.
      </t>
      <t>
        Currently, the cryptographic resistance of the GOST R 34.10-2012
        digital signature algorithm is estimated as 2**128 operations of
        multiple elliptic curve point computations on prime modulus of order 2**256.
      </t>
      <t>
        Currently, the cryptographic collision resistance of the GOST R 34.11-2012
        hash algorithm is estimated as 2**128 operations of computations of a step
        hash function.
      </t>
    </section>
    <section numbered="true" toc="default">
      <name>Acknowledgments</name>
      <t>
        This document is a minor extension to RFC 4034 <xref target="RFC4034" format="default"/>. Also, we
        tried to follow the documents RFC 3110 <xref target="RFC3110" format="default"/>, RFC 4509 <xref target="RFC4509" format="default"/>,
        and RFC 5933 <xref target="RFC5933" format="default"/> for consistency. The authors of and
        contributors to these documents are gratefully acknowledged for their hard work.
      </t>
      <t>
        The following people provided additional feedback, text, and valuable
        assistance: Alexander Venedyukhin, Michael StJohns, Valery Smyslov, Tim Wicinski, Stephane Bortzmeyer.
      </t>
    </section>
  </middle>
  <back>
    <references>
      <name>References</name>
      <references>
        <name>Normative References</name>
        <xi:include href="https://bib.ietf.org/public/rfc/bibxml/reference.RFC.2119.xml"/>
        <xi:include href="https://bib.ietf.org/public/rfc/bibxml/reference.RFC.3110.xml"/>
        <xi:include href="https://bib.ietf.org/public/rfc/bibxml/reference.RFC.4033.xml"/>
        <xi:include href="https://bib.ietf.org/public/rfc/bibxml/reference.RFC.4034.xml"/>
        <xi:include href="https://bib.ietf.org/public/rfc/bibxml/reference.RFC.4035.xml"/>
        <xi:include href="https://bib.ietf.org/public/rfc/bibxml/reference.RFC.6840.xml"/>
        <xi:include href="https://bib.ietf.org/public/rfc/bibxml/reference.RFC.6986.xml"/>
        <xi:include href="https://bib.ietf.org/public/rfc/bibxml/reference.RFC.7091.xml"/>
        <xi:include href="https://bib.ietf.org/public/rfc/bibxml/reference.RFC.7836.xml"/>
        <xi:include href="https://bib.ietf.org/public/rfc/bibxml/reference.RFC.8174.xml"/>
      </references>
      <references>
        <name>Informative References</name>
        <xi:include href="https://bib.ietf.org/public/rfc/bibxml/reference.RFC.4509.xml"/>
        <xi:include href="https://bib.ietf.org/public/rfc/bibxml/reference.RFC.5208.xml"/>
        <xi:include href="https://bib.ietf.org/public/rfc/bibxml/reference.RFC.5280.xml"/>
        <xi:include href="https://bib.ietf.org/public/rfc/bibxml/reference.RFC.5933.xml"/>
        <xi:include href="https://bib.ietf.org/public/rfc/bibxml/reference.RFC.9215.xml"/>
      </references>
    </references>
  </back>
</rfc>
