<?xml version='1.0' encoding='utf-8'?>
<rfc xmlns:xi="http://www.w3.org/2001/XInclude" version="3" category="std" consensus="true" docName="draft-ietf-lamps-pkix-shake-15" indexInclude="true" ipr="trust200902" number="8692" prepTime="2019-12-11T14:18:07" scripts="Common,Latin" sortRefs="true" submissionType="IETF" symRefs="true" tocDepth="4" tocInclude="true" updates="3279" xml:lang="en">
  <link href="https://datatracker.ietf.org/doc/draft-ietf-lamps-pkix-shake-15" rel="prev"/>
  <link href="https://dx.doi.org/10.17487/rfc8692" rel="alternate"/>
  <link href="urn:issn:2070-1721" rel="alternate"/>
  <front>
    <title abbrev="SHAKE Identifiers in X.509">Internet X.509 Public Key Infrastructure: Additional Algorithm Identifiers for RSASSA-PSS and ECDSA Using SHAKEs</title>
    <seriesInfo name="RFC" value="8692" stream="IETF"/>
    <author fullname="Panos Kampanakis" initials="P." surname="Kampanakis">
      <organization showOnFrontPage="true">Cisco Systems</organization>
      <address>
        <email>pkampana@cisco.com</email>
      </address>
    </author>
    <author fullname="Quynh Dang" initials="Q." surname="Dang">
      <organization showOnFrontPage="true">NIST</organization>
      <address>
        <postal>
          <street>100 Bureau Drive, Stop 8930</street>
          <city>Gaithersburg</city>
          <region>MD</region>
          <code>20899-8930</code>
          <country>United States of America</country>
        </postal>
        <email>quynh.dang@nist.gov</email>
      </address>
    </author>
    <date month="12" year="2019"/>
    <area>Security</area>
    <workgroup>LAMPS WG</workgroup>
    <keyword>SHAKE in X.509</keyword>
    <keyword>SHAKEs in PKIX</keyword>
    <keyword>certificates with SHAKE hashes</keyword>
    <abstract pn="section-abstract">
      <t pn="section-abstract-1">Digital signatures are used to sign messages, X.509 
	  certificates, and Certificate Revocation Lists (CRLs). This document updates the 
	  "Algorithms and Identifiers for the Internet 
	  X.509 Public Key Infrastructure Certificate and 
	  Certificate Revocation List (CRL) Profile" (RFC 3279)
	  and describes the conventions for using the SHAKE function 
	  family in Internet X.509 certificates and revocation lists 
	  as one-way hash functions with the RSA Probabilistic signature 
	  and Elliptic Curve Digital Signature Algorithm (ECDSA) signature algorithms. The conventions for the 
	  associated subject public keys are also described.</t>
    </abstract>
    <boilerplate>
      <section anchor="status-of-memo" numbered="false" removeInRFC="false" toc="exclude" pn="section-boilerplate.1">
        <name slugifiedName="name-status-of-this-memo">Status of This Memo</name>
        <t pn="section-boilerplate.1-1">
            This is an Internet Standards Track document.
        </t>
        <t pn="section-boilerplate.1-2">
            This document is a product of the Internet Engineering Task Force
            (IETF).  It represents the consensus of the IETF community.  It has
            received public review and has been approved for publication by
            the Internet Engineering Steering Group (IESG).  Further
            information on Internet Standards is available in Section 2 of 
            RFC 7841.
        </t>
        <t pn="section-boilerplate.1-3">
            Information about the current status of this document, any
            errata, and how to provide feedback on it may be obtained at
            <eref target="https://www.rfc-editor.org/info/rfc8692" brackets="none"/>.
        </t>
      </section>
      <section anchor="copyright" numbered="false" removeInRFC="false" toc="exclude" pn="section-boilerplate.2">
        <name slugifiedName="name-copyright-notice">Copyright Notice</name>
        <t pn="section-boilerplate.2-1">
            Copyright (c) 2019 IETF Trust and the persons identified as the
            document authors. All rights reserved.
        </t>
        <t pn="section-boilerplate.2-2">
            This document is subject to BCP 78 and the IETF Trust's Legal
            Provisions Relating to IETF Documents
            (<eref target="https://trustee.ietf.org/license-info" brackets="none"/>) in effect on the date of
            publication of this document. Please review these documents
            carefully, as they describe your rights and restrictions with
            respect to this document. Code Components extracted from this
            document must include Simplified BSD License text as described in
            Section 4.e of the Trust Legal Provisions and are provided without
            warranty as described in the Simplified BSD License.
        </t>
      </section>
    </boilerplate>
    <toc>
      <section anchor="toc" numbered="false" removeInRFC="false" toc="exclude" pn="section-toc.1">
        <name slugifiedName="name-table-of-contents">Table of Contents</name>
        <ul bare="true" empty="true" indent="2" spacing="compact" pn="section-toc.1-1">
          <li pn="section-toc.1-1.1">
            <t keepWithNext="true" pn="section-toc.1-1.1.1"><xref derivedContent="1" format="counter" sectionFormat="of" target="section-1"/>.  <xref derivedContent="" format="title" sectionFormat="of" target="name-introduction">Introduction</xref></t>
          </li>
          <li pn="section-toc.1-1.2">
            <t keepWithNext="true" pn="section-toc.1-1.2.1"><xref derivedContent="2" format="counter" sectionFormat="of" target="section-2"/>.  <xref derivedContent="" format="title" sectionFormat="of" target="name-terminology">Terminology</xref></t>
          </li>
          <li pn="section-toc.1-1.3">
            <t keepWithNext="true" pn="section-toc.1-1.3.1"><xref derivedContent="3" format="counter" sectionFormat="of" target="section-3"/>.  <xref derivedContent="" format="title" sectionFormat="of" target="name-identifiers">Identifiers</xref></t>
          </li>
          <li pn="section-toc.1-1.4">
            <t keepWithNext="true" pn="section-toc.1-1.4.1"><xref derivedContent="4" format="counter" sectionFormat="of" target="section-4"/>.  <xref derivedContent="" format="title" sectionFormat="of" target="name-use-in-pkix">Use in PKIX</xref></t>
            <ul bare="true" empty="true" indent="2" spacing="compact" pn="section-toc.1-1.4.2">
              <li pn="section-toc.1-1.4.2.1">
                <t keepWithNext="true" pn="section-toc.1-1.4.2.1.1"><xref derivedContent="4.1" format="counter" sectionFormat="of" target="section-4.1"/>.  <xref derivedContent="" format="title" sectionFormat="of" target="name-signatures">Signatures</xref></t>
                <ul bare="true" empty="true" indent="2" spacing="compact" pn="section-toc.1-1.4.2.1.2">
                  <li pn="section-toc.1-1.4.2.1.2.1">
                    <t keepWithNext="true" pn="section-toc.1-1.4.2.1.2.1.1"><xref derivedContent="4.1.1" format="counter" sectionFormat="of" target="section-4.1.1"/>.  <xref derivedContent="" format="title" sectionFormat="of" target="name-rsassa-pss-signatures">RSASSA-PSS Signatures</xref></t>
                  </li>
                  <li pn="section-toc.1-1.4.2.1.2.2">
                    <t keepWithNext="true" pn="section-toc.1-1.4.2.1.2.2.1"><xref derivedContent="4.1.2" format="counter" sectionFormat="of" target="section-4.1.2"/>.  <xref derivedContent="" format="title" sectionFormat="of" target="name-ecdsa-signatures">ECDSA Signatures</xref></t>
                  </li>
                </ul>
              </li>
              <li pn="section-toc.1-1.4.2.2">
                <t keepWithNext="true" pn="section-toc.1-1.4.2.2.1"><xref derivedContent="4.2" format="counter" sectionFormat="of" target="section-4.2"/>.  <xref derivedContent="" format="title" sectionFormat="of" target="name-public-keys">Public Keys</xref></t>
              </li>
            </ul>
          </li>
          <li pn="section-toc.1-1.5">
            <t keepWithNext="true" pn="section-toc.1-1.5.1"><xref derivedContent="5" format="counter" sectionFormat="of" target="section-5"/>.  <xref derivedContent="" format="title" sectionFormat="of" target="name-iana-considerations">IANA Considerations</xref></t>
          </li>
          <li pn="section-toc.1-1.6">
            <t keepWithNext="true" pn="section-toc.1-1.6.1"><xref derivedContent="6" format="counter" sectionFormat="of" target="section-6"/>.  <xref derivedContent="" format="title" sectionFormat="of" target="name-security-considerations">Security Considerations</xref></t>
          </li>
          <li pn="section-toc.1-1.7">
            <t keepWithNext="true" pn="section-toc.1-1.7.1"><xref derivedContent="7" format="counter" sectionFormat="of" target="section-7"/>.  <xref derivedContent="" format="title" sectionFormat="of" target="name-references">References</xref></t>
            <ul bare="true" empty="true" indent="2" spacing="compact" pn="section-toc.1-1.7.2">
              <li pn="section-toc.1-1.7.2.1">
                <t keepWithNext="true" pn="section-toc.1-1.7.2.1.1"><xref derivedContent="7.1" format="counter" sectionFormat="of" target="section-7.1"/>.  <xref derivedContent="" format="title" sectionFormat="of" target="name-normative-references">Normative References</xref></t>
              </li>
              <li pn="section-toc.1-1.7.2.2">
                <t keepWithNext="true" pn="section-toc.1-1.7.2.2.1"><xref derivedContent="7.2" format="counter" sectionFormat="of" target="section-7.2"/>.  <xref derivedContent="" format="title" sectionFormat="of" target="name-informative-references">Informative References</xref></t>
              </li>
            </ul>
          </li>
          <li pn="section-toc.1-1.8">
            <t keepWithNext="true" pn="section-toc.1-1.8.1"><xref derivedContent="Appendix A" format="default" sectionFormat="of" target="section-appendix.a"/>.  <xref derivedContent="" format="title" sectionFormat="of" target="name-asn1-module">ASN.1 Module</xref></t>
          </li>
          <li pn="section-toc.1-1.9">
            <t keepWithNext="true" pn="section-toc.1-1.9.1"><xref derivedContent="" format="none" sectionFormat="of" target="section-appendix.b"/><xref derivedContent="" format="title" sectionFormat="of" target="name-acknowledgements">Acknowledgements</xref></t>
          </li>
          <li pn="section-toc.1-1.10">
            <t keepWithNext="true" pn="section-toc.1-1.10.1"><xref derivedContent="" format="none" sectionFormat="of" target="section-appendix.c"/><xref derivedContent="" format="title" sectionFormat="of" target="name-authors-addresses">Authors' Addresses</xref></t>
          </li>
        </ul>
      </section>
    </toc>
  </front>
  <middle>
    <section numbered="true" toc="include" removeInRFC="false" pn="section-1">
      <name slugifiedName="name-introduction">Introduction</name>
      <t pn="section-1-1"><xref target="RFC3279" format="default" sectionFormat="of" derivedContent="RFC3279"/> defines cryptographic algorithm 
      identifiers for the "Internet X.509 Public Key Infrastructure Certificate
             and Certificate Revocation List (CRL) Profile"
 <xref target="RFC5280" format="default" sectionFormat="of" derivedContent="RFC5280"/>. This document updates RFC 3279 
	  and defines identifiers for several cryptographic algorithms that use 
	  variable-length output SHAKE functions introduced in 
	  <xref target="SHA3" format="default" sectionFormat="of" derivedContent="SHA3"/>  
      which can be used with RFC 5280.</t>
      <t pn="section-1-2">In the SHA-3 family, two extendable-output functions (SHAKEs)
      are defined: SHAKE128 and SHAKE256. Four other hash function
      instances, SHA3-224, SHA3-256, SHA3-384, and SHA3-512, are also
      defined but are out of scope for this document.  A SHAKE is a
      variable-length hash function defined as SHAKE(M, d) where the
      output is a d-bits-long digest of message M. The corresponding
      collision and second-preimage-resistance strengths for SHAKE128
      are min(d/2, 128) and min(d, 128) bits, respectively (see Appendix A.1 of
      <xref target="SHA3" format="default" sectionFormat="of" derivedContent="SHA3"/>).  And the corresponding collision and
      second-preimage-resistance strengths for SHAKE256 are
      min(d/2, 256) and min(d, 256) bits, respectively.</t>
      <t pn="section-1-3">A SHAKE can be used as the message digest function (to hash the message to be signed) 
	  in RSA Probabilistic Signature Scheme (RSASSA-PSS) <xref target="RFC8017" format="default" sectionFormat="of" derivedContent="RFC8017"/> and ECDSA <xref target="X9.62" format="default" sectionFormat="of" derivedContent="X9.62"/> 
      and as the hash in the mask generation function (MGF) in RSASSA-PSS. 
      </t>
    </section>
    <section anchor="terminology" numbered="true" toc="include" removeInRFC="false" pn="section-2">
      <name slugifiedName="name-terminology">Terminology</name>
      <t pn="section-2-1">
    The key words "<bcp14>MUST</bcp14>", "<bcp14>MUST NOT</bcp14>",
    "<bcp14>REQUIRED</bcp14>", "<bcp14>SHALL</bcp14>", "<bcp14>SHALL NOT</bcp14>",
    "<bcp14>SHOULD</bcp14>", "<bcp14>SHOULD NOT</bcp14>",
    "<bcp14>RECOMMENDED</bcp14>", "<bcp14>NOT RECOMMENDED</bcp14>",
    "<bcp14>MAY</bcp14>", and "<bcp14>OPTIONAL</bcp14>" in this document are to be
    interpreted as described in BCP 14 <xref target="RFC2119" format="default" sectionFormat="of" derivedContent="RFC2119"/> <xref target="RFC8174" format="default" sectionFormat="of" derivedContent="RFC8174"/> when, and only when, they appear in all capitals, as
    shown here.
      </t>
    </section>
    <section anchor="oids" numbered="true" toc="include" removeInRFC="false" pn="section-3">
      <name slugifiedName="name-identifiers">Identifiers</name>
      <t pn="section-3-1">This section defines four new object identifiers (OIDs), for RSASSA-PSS and ECDSA with each 
	  of SHAKE128 and SHAKE256. The same algorithm identifiers can be  
	  used for identifying a public key in RSASSA-PSS.</t>
      <t pn="section-3-2">The new identifiers for RSASSA-PSS signatures using SHAKEs are below.</t>
      <sourcecode type="asn.1" markers="false" pn="section-3-3">
  id-RSASSA-PSS-SHAKE128  OBJECT IDENTIFIER  ::=  { iso(1) 
            identified-organization(3) dod(6) internet(1) 
            security(5) mechanisms(5) pkix(7) algorithms(6)
            30 }

  id-RSASSA-PSS-SHAKE256  OBJECT IDENTIFIER  ::=  { iso(1) 
            identified-organization(3) dod(6) internet(1) 
            security(5) mechanisms(5) pkix(7) algorithms(6)
            31 }
</sourcecode>
      <t pn="section-3-4">The new algorithm identifiers of ECDSA signatures using SHAKEs are below.
      
      </t>
      <sourcecode type="asn.1" markers="false" pn="section-3-5">
  id-ecdsa-with-shake128 OBJECT IDENTIFIER  ::=  { iso(1) 
            identified-organization(3) dod(6) internet(1) 
            security(5) mechanisms(5) pkix(7) algorithms(6)
            32 }            

  id-ecdsa-with-shake256 OBJECT IDENTIFIER  ::=  { iso(1) 
            identified-organization(3) dod(6) internet(1) 
            security(5) mechanisms(5) pkix(7) algorithms(6)
            33 }
</sourcecode>
      <t pn="section-3-6">The parameters for the four identifiers above <bcp14>MUST</bcp14> be absent. That is, 
	  the identifier <bcp14>SHALL</bcp14> be a SEQUENCE of one component: the OID.</t>
      <t pn="section-3-7">Sections <xref target="rsa-sigs" format="counter" sectionFormat="of" derivedContent="4.1.1"/> and <xref target="ecdsa-sigs" format="counter" sectionFormat="of" derivedContent="4.1.2"/> specify the required output length 
	  for each use of SHAKE128 or SHAKE256 in RSASSA-PSS and ECDSA. In summary, when hashing messages
	  to be signed, output lengths of SHAKE128 and SHAKE256 are 256 and 512 bits, respectively.


	  
	  When the SHAKEs are used as MGFs in RSASSA-PSS, their output length is 
	  (8*ceil((n-1)/8) - 264) or (8*ceil((n-1)/8) - 520) bits, respectively, where n is the RSA modulus size in bits.</t>
    </section>
    <section numbered="true" toc="include" removeInRFC="false" pn="section-4">
      <name slugifiedName="name-use-in-pkix">Use in PKIX</name>
      <section anchor="sigs" numbered="true" toc="include" removeInRFC="false" pn="section-4.1">
        <name slugifiedName="name-signatures">Signatures</name>
        <t pn="section-4.1-1">Signatures are used in a number of different ASN.1 structures.
        As shown in the ASN.1 representation from <xref target="RFC5280" format="default" sectionFormat="of" derivedContent="RFC5280"/> 
		below, in an X.509 certificate, a signature is encoded with an 
		algorithm identifier in the signatureAlgorithm attribute and 
		a signatureValue attribute that contains the actual signature.  
        </t>
        <sourcecode type="asn.1" markers="false" pn="section-4.1-2">
   Certificate  ::=  SEQUENCE  {
      tbsCertificate       TBSCertificate,
      signatureAlgorithm   AlgorithmIdentifier,
      signatureValue       BIT STRING  }
</sourcecode>
        <t pn="section-4.1-3">The identifiers defined in <xref target="oids" format="default" sectionFormat="of" derivedContent="Section 3"/> can be used 
		as the AlgorithmIdentifier in the signatureAlgorithm field in the sequence 
		Certificate and the signature field in the sequence TBSCertificate in X.509  
		<xref target="RFC5280" format="default" sectionFormat="of" derivedContent="RFC5280"/>. 
		The parameters of these signature algorithms are absent, as explained 
		in <xref target="oids" format="default" sectionFormat="of" derivedContent="Section 3"/>.</t>
        <t pn="section-4.1-4">Conforming Certification Authority (CA) implementations <bcp14>MUST</bcp14> specify the algorithms  
		explicitly by using the OIDs specified in <xref target="oids" format="default" sectionFormat="of" derivedContent="Section 3"/> when 
		encoding RSASSA-PSS or ECDSA with SHAKE signatures 
		in certificates and CRLs.
		Conforming client implementations that process certificates and CRLs 
		using RSASSA-PSS or ECDSA with SHAKE <bcp14>MUST</bcp14> recognize the corresponding OIDs.
		Encoding rules for RSASSA-PSS and ECDSA 
		signature values are specified in <xref target="RFC4055" format="default" sectionFormat="of" derivedContent="RFC4055"/> and 
		<xref target="RFC5480" format="default" sectionFormat="of" derivedContent="RFC5480"/>, respectively.</t>
        <t pn="section-4.1-5">When using RSASSA-PSS or ECDSA with SHAKEs, the RSA modulus and ECDSA 
		curve order <bcp14>SHOULD</bcp14> be chosen in line with the SHAKE output length. 
		Refer to <xref target="Security" format="default" sectionFormat="of" derivedContent="Section 6"/> for more details.</t>
        <section anchor="rsa-sigs" numbered="true" toc="include" removeInRFC="false" pn="section-4.1.1">
          <name slugifiedName="name-rsassa-pss-signatures">RSASSA-PSS Signatures</name>
          <t pn="section-4.1.1-1">The RSASSA-PSS algorithm is defined in <xref target="RFC8017" format="default" sectionFormat="of" derivedContent="RFC8017"/>. 
		  When id-RSASSA-PSS-SHAKE128 or id-RSASSA-PSS-SHAKE256 (specified in <xref target="oids" format="default" sectionFormat="of" derivedContent="Section 3"/>)
		  is used, the encoding <bcp14>MUST</bcp14> omit the parameters field. That is, 
		  the AlgorithmIdentifier <bcp14>SHALL</bcp14> be a SEQUENCE of one component:  
		  id-RSASSA-PSS-SHAKE128 or id-RSASSA-PSS-SHAKE256.


		  <xref target="RFC4055" format="default" sectionFormat="of" derivedContent="RFC4055"/>
		  defines RSASSA-PSS-params that is used to define the algorithms and inputs 
		  to the algorithm. This specification does not use parameters because the 
		  hash, mask generation algorithm, trailer, and salt are embedded in 
		  the OID definition.</t>
          <t pn="section-4.1.1-2">The hash algorithm to hash a message being signed and the hash algorithm used as the
		 MGF 
		  in RSASSA-PSS <bcp14>MUST</bcp14> be the same: both SHAKE128 or both SHAKE256. The 
		  output length of the hash algorithm that hashes the message <bcp14>SHALL</bcp14> be 32 bytes
		  (for SHAKE128) or 64 bytes (for SHAKE256). </t>
          <t pn="section-4.1.1-3">The MGF takes an octet string of variable length and
		  a desired output length as input and outputs an octet 
		  string of the desired length. In RSASSA-PSS with SHAKEs, the SHAKEs <bcp14>MUST</bcp14> be 
		  used natively as the MGF, instead of the MGF1 algorithm that uses 
		  the hash function in multiple iterations, as specified in 
		  <xref target="RFC8017" section="B.2.1" sectionFormat="of" format="default" derivedLink="https://rfc-editor.org/rfc/rfc8017#appendix-B.2.1" derivedContent="RFC8017"/>. In other words, the MGF is defined as 
          the SHAKE128 or SHAKE256 output of the mgfSeed for id-RSASSA-PSS-SHAKE128 and 
	  id-RSASSA-PSS-SHAKE256, respectively.

	  The mgfSeed is the seed 
		  from which the mask is generated, an octet string <xref target="RFC8017" format="default" sectionFormat="of" derivedContent="RFC8017"/>.		  
		  As explained in Step 9 of <xref target="RFC8017" sectionFormat="of" section="9.1.1" format="default" derivedLink="https://rfc-editor.org/rfc/rfc8017#section-9.1.1" derivedContent="RFC8017"/>, the output 
		  length of the MGF is emLen - hLen - 1 bytes. emLen is the maximum message 
		  length ceil((n-1)/8), where n is the RSA modulus in bits. hLen is 32 and 
		  64 bytes for id-RSASSA-PSS-SHAKE128 and id-RSASSA-PSS-SHAKE256, respectively. 
		  Thus, when SHAKE is used as the MGF, the SHAKE output length maskLen is 
		  (8*emLen - 264) or (8*emLen - 520) bits, respectively.


		  For example, when RSA modulus n is 2048 bits, 
		  the output length of SHAKE128 or SHAKE256 as the MGF will be 1784 or 1528 bits 
		  when id-RSASSA-PSS-SHAKE128 or id-RSASSA-PSS-SHAKE256 is used, respectively. </t>
          <t pn="section-4.1.1-4">The RSASSA-PSS saltLength <bcp14>MUST</bcp14> be 32 bytes for id-RSASSA-PSS-SHAKE128 
		  or 64 bytes for id-RSASSA-PSS-SHAKE256. 
		  Finally, the trailerField <bcp14>MUST</bcp14> be 1, which represents 
		  the trailer field with hexadecimal value 0xBC <xref target="RFC8017" format="default" sectionFormat="of" derivedContent="RFC8017"/>.</t>
        </section>
        <section anchor="ecdsa-sigs" numbered="true" toc="include" removeInRFC="false" pn="section-4.1.2">
          <name slugifiedName="name-ecdsa-signatures">ECDSA Signatures</name>
          <t pn="section-4.1.2-1">The Elliptic Curve Digital Signature Algorithm (ECDSA) is defined in 
	      <xref target="X9.62" format="default" sectionFormat="of" derivedContent="X9.62"/>. When the id-ecdsa-with-shake128 or id-ecdsa-with-shake256
		  (specified in <xref target="oids" format="default" sectionFormat="of" derivedContent="Section 3"/>) algorithm identifier appears, the respective SHAKE 
		  function (SHAKE128 or SHAKE256) is used as the hash. 
		  The encoding <bcp14>MUST</bcp14> omit the parameters field. That is, the AlgorithmIdentifier 
		  <bcp14>SHALL</bcp14> be a SEQUENCE of one component: the OID id-ecdsa-with-shake128 or 
		  id-ecdsa-with-shake256.</t>
          <t pn="section-4.1.2-2">For simplicity and compliance with the ECDSA standard specification 
		  <xref target="X9.62" format="default" sectionFormat="of" derivedContent="X9.62"/>, 
	      the output length of the hash function must be explicitly determined. The 
	      output length, d, for SHAKE128 or SHAKE256 used in ECDSA <bcp14>MUST</bcp14> be 256 or 512  
		  bits, respectively. </t>
          <t pn="section-4.1.2-3">Conforming CA implementations that generate ECDSA with SHAKE signatures 
		  in certificates or CRLs <bcp14>SHOULD</bcp14> generate such signatures with a 
		  deterministically generated, nonrandom k in accordance with all 
		  the requirements specified in <xref target="RFC6979" format="default" sectionFormat="of" derivedContent="RFC6979"/>. 
		 
		  They <bcp14>MAY</bcp14> also generate such signatures 
		  in accordance with all other recommendations in <xref target="X9.62" format="default" sectionFormat="of" derivedContent="X9.62"/> or 
		  <xref target="SEC1" format="default" sectionFormat="of" derivedContent="SEC1"/> if they have a stated policy that requires 
		  conformance to those standards. Those standards have not specified  
		  SHAKE128 and SHAKE256 as hash algorithm options. However, SHAKE128 and 
		  SHAKE256 with output length being 32 and 64 octets, respectively, can  
		  be used instead of 256- and 512-bit output hash algorithms such as SHA256 
		  and SHA512.</t>
        </section>
      </section>
      <section numbered="true" toc="include" removeInRFC="false" pn="section-4.2">
        <name slugifiedName="name-public-keys">Public Keys</name>
        <t pn="section-4.2-1">Certificates conforming to <xref target="RFC5280" format="default" sectionFormat="of" derivedContent="RFC5280"/> can convey a 
		public key for any public key algorithm. The certificate indicates 
		the public key algorithm through an algorithm identifier.
		
		This algorithm identifier is an OID with optionally associated
		parameters. The conventions and encoding for RSASSA-PSS and
		ECDSA public key algorithm identifiers are as specified in
		Sections <xref target="RFC3279" section="2.3.1" sectionFormat="bare" format="default" derivedLink="https://rfc-editor.org/rfc/rfc3279#section-2.3.1" derivedContent="RFC3279"/> and <xref target="RFC3279" section="2.3.5" sectionFormat="bare" format="default" derivedLink="https://rfc-editor.org/rfc/rfc3279#section-2.3.5" derivedContent="RFC3279"/> of <xref target="RFC3279" format="default" sectionFormat="of" derivedContent="RFC3279"/>,
		<xref target="RFC4055" sectionFormat="of" section="3.1" format="default" derivedLink="https://rfc-editor.org/rfc/rfc4055#section-3.1" derivedContent="RFC4055"/> 
		and <xref target="RFC5480" sectionFormat="of" section="2.1" format="default" derivedLink="https://rfc-editor.org/rfc/rfc5480#section-2.1" derivedContent="RFC5480"/>.
        </t>
        <t pn="section-4.2-2">Traditionally, the rsaEncryption object identifier is used to
		identify RSA public keys. The rsaEncryption object identifier 
		continues to identify the subject public key when the RSA private 
		key owner does not wish to limit the use of the public key 
		exclusively to RSASSA-PSS with SHAKEs. When the RSA private 
		key owner wishes to limit the use of the public key exclusively 
		to RSASSA-PSS with SHAKEs, the AlgorithmIdentifiers for 
		RSASSA-PSS defined in <xref target="oids" format="default" sectionFormat="of" derivedContent="Section 3"/> <bcp14>SHOULD</bcp14> be used as the algorithm 
		field in the SubjectPublicKeyInfo sequence <xref target="RFC5280" format="default" sectionFormat="of" derivedContent="RFC5280"/>. 
		Conforming client implementations that process RSASSA-PSS 
		with SHAKE public keys when processing certificates and CRLs <bcp14>MUST</bcp14> 
		recognize the corresponding OIDs. </t>
        <t pn="section-4.2-3">Conforming CA implementations <bcp14>MUST</bcp14> specify the X.509 public key 
		algorithm explicitly by using the OIDs specified in <xref target="oids" format="default" sectionFormat="of" derivedContent="Section 3"/> 
		when encoding ECDSA with SHAKE public keys in certificates and CRLs. 
		Conforming client implementations that process ECDSA with 
		SHAKE public keys when processing certificates and CRLs <bcp14>MUST</bcp14> recognize 
		the corresponding OIDs. </t>
        <t pn="section-4.2-4">The identifier parameters, as explained in <xref target="oids" format="default" sectionFormat="of" derivedContent="Section 3"/>, 
		<bcp14>MUST</bcp14> be absent.</t>
      </section>
    </section>
    <section anchor="IANA" numbered="true" toc="include" removeInRFC="false" pn="section-5">
      <name slugifiedName="name-iana-considerations">IANA Considerations</name>
      <t pn="section-5-1">One object identifier for the ASN.1 module in <xref target="asn" format="default" sectionFormat="of" derivedContent="Appendix A"/> 
	  has been assigned in the "SMI Security for PKIX Module Identifier" 
	  (1.3.6.1.5.5.7.0) registry: </t>
      <table align="center" pn="table-1">
        <thead>
          <tr>
            <th align="center" colspan="1" rowspan="1">Decimal</th>
            <th align="center" colspan="1" rowspan="1">Description</th>
            <th align="center" colspan="1" rowspan="1">References</th>
          </tr>
        </thead>
        <tbody>
          <tr>
            <td align="center" colspan="1" rowspan="1">94</td>
            <td align="center" colspan="1" rowspan="1">id-mod-pkix1-shakes-2019</td>
            <td align="center" colspan="1" rowspan="1">RFC 8692</td>
          </tr>
        </tbody>
      </table>
      <t pn="section-5-3">IANA has updated the 
	  "SMI Security for PKIX Algorithms" 
	  (1.3.6.1.5.5.7.6) registry <xref target="SMI-PKIX" format="default" sectionFormat="of" derivedContent="SMI-PKIX"/> with four additional entries: </t>
      <table align="center" pn="table-2">
        <thead>
          <tr>
            <th align="center" colspan="1" rowspan="1">Decimal</th>
            <th align="center" colspan="1" rowspan="1">Description</th>
            <th align="center" colspan="1" rowspan="1">References</th>
          </tr>
        </thead>
        <tbody>
          <tr>
            <td align="center" colspan="1" rowspan="1">30</td>
            <td align="center" colspan="1" rowspan="1">id-RSASSA-PSS-SHAKE128</td>
            <td align="center" colspan="1" rowspan="1">RFC 8692</td>
          </tr>
          <tr>
            <td align="center" colspan="1" rowspan="1">31</td>
            <td align="center" colspan="1" rowspan="1">id-RSASSA-PSS-SHAKE256</td>
            <td align="center" colspan="1" rowspan="1">RFC 8692</td>
          </tr>
          <tr>
            <td align="center" colspan="1" rowspan="1">32</td>
            <td align="center" colspan="1" rowspan="1">id-ecdsa-with-shake128</td>
            <td align="center" colspan="1" rowspan="1">RFC 8692</td>
          </tr>
          <tr>
            <td align="center" colspan="1" rowspan="1">33</td>
            <td align="center" colspan="1" rowspan="1">id-ecdsa-with-shake256</td>
            <td align="center" colspan="1" rowspan="1">RFC 8692</td>
          </tr>
        </tbody>
      </table>
      <t pn="section-5-5">IANA has updated the 
	  "Hash Function Textual Names" registry <xref target="Hash-Texts" format="default" sectionFormat="of" derivedContent="Hash-Texts"/>
      with two additional entries for SHAKE128
      and SHAKE256: </t>
      <table align="center" pn="table-3">
        <thead>
          <tr>
            <th align="center" colspan="1" rowspan="1">Hash Function Name</th>
            <th align="center" colspan="1" rowspan="1">OID</th>
            <th align="center" colspan="1" rowspan="1">Reference</th>
          </tr>
        </thead>
        <tbody>
          <tr>
            <td align="center" colspan="1" rowspan="1">shake128</td>
            <td align="center" colspan="1" rowspan="1">2.16.840.1.101.3.4.2.11</td>
            <td align="center" colspan="1" rowspan="1">RFC 8692</td>
          </tr>
          <tr>
            <td align="center" colspan="1" rowspan="1">shake256</td>
            <td align="center" colspan="1" rowspan="1">2.16.840.1.101.3.4.2.12</td>
            <td align="center" colspan="1" rowspan="1">RFC 8692</td>
          </tr>
        </tbody>
      </table>
    </section>
    <section anchor="Security" numbered="true" toc="include" removeInRFC="false" pn="section-6">
      <name slugifiedName="name-security-considerations">Security Considerations</name>
      <t pn="section-6-1">This document updates <xref target="RFC3279" format="default" sectionFormat="of" derivedContent="RFC3279"/>. The Security Considerations
      section of that document applies to this specification as well.</t>
      <t pn="section-6-2">NIST has defined appropriate use of the hash functions in terms of the algorithm 
      strengths and expected time frames for secure use in Special Publications (SPs) 
      <xref target="SP800-78-4" format="default" sectionFormat="of" derivedContent="SP800-78-4"/> and <xref target="SP800-107" format="default" sectionFormat="of" derivedContent="SP800-107"/>. 
      These documents can be used as guides to choose appropriate key sizes 
      for various security scenarios. </t>
      <t pn="section-6-3">SHAKE128 with output length of 256 bits offers 128 bits
	  of collision and preimage resistance. Thus, SHAKE128 OIDs in
	  this specification are <bcp14>RECOMMENDED</bcp14> with 2048- (112-bit
	  security) or 3072-bit (128-bit security) RSA modulus or
	  curves with group order of 256 bits (128-bit
	  security). SHAKE256 with a 512-bit output length offers
	  256 bits of collision and preimage resistance. Thus, the
	  SHAKE256 OIDs in this specification are <bcp14>RECOMMENDED</bcp14> with
	  4096-bit RSA modulus or higher or curves with a group order of
	  at least 512 bits, such as the NIST Curve P-521 (256-bit
	  security). Note that we recommended a 4096-bit RSA because we
	  would need a 15360-bit modulus for 256 bits of security, which
	  is impractical for today's technology.</t>
    </section>
  </middle>
  <back>
    <references pn="section-7">
      <name slugifiedName="name-references">References</name>
      <references pn="section-7.1">
        <name slugifiedName="name-normative-references">Normative References</name>
        <reference anchor="RFC2119" target="https://www.rfc-editor.org/info/rfc2119" quoteTitle="true" derivedAnchor="RFC2119">
          <front>
            <title>Key words for use in RFCs to Indicate Requirement Levels</title>
            <author initials="S." surname="Bradner" fullname="S. Bradner">
              <organization showOnFrontPage="true"/>
            </author>
            <date year="1997" month="March"/>
            <abstract>
              <t>In many standards track documents several words are used to signify the requirements in the specification.  These words are often capitalized. This document defines these words as they should be interpreted in IETF documents.  This document specifies an Internet Best Current Practices for the Internet Community, and requests discussion and suggestions for improvements.</t>
            </abstract>
          </front>
          <seriesInfo name="BCP" value="14"/>
          <seriesInfo name="RFC" value="2119"/>
          <seriesInfo name="DOI" value="10.17487/RFC2119"/>
        </reference>
        <reference anchor="RFC3279" target="https://www.rfc-editor.org/info/rfc3279" quoteTitle="true" derivedAnchor="RFC3279">
          <front>
            <title>Algorithms and Identifiers for the Internet X.509 Public Key Infrastructure Certificate and Certificate Revocation List (CRL) Profile</title>
            <author initials="L." surname="Bassham" fullname="L. Bassham">
              <organization showOnFrontPage="true"/>
            </author>
            <author initials="W." surname="Polk" fullname="W. Polk">
              <organization showOnFrontPage="true"/>
            </author>
            <author initials="R." surname="Housley" fullname="R. Housley">
              <organization showOnFrontPage="true"/>
            </author>
            <date year="2002" month="April"/>
            <abstract>
              <t>This document specifies algorithm identifiers and ASN.1 encoding formats for digital signatures and subject public keys used in the Internet X.509 Public Key Infrastructure (PKI).  Digital signatures are used to sign certificates and certificate revocation list (CRLs).  Certificates include the public key of the named subject.  [STANDARDS-TRACK]</t>
            </abstract>
          </front>
          <seriesInfo name="RFC" value="3279"/>
          <seriesInfo name="DOI" value="10.17487/RFC3279"/>
        </reference>
        <reference anchor="RFC4055" target="https://www.rfc-editor.org/info/rfc4055" quoteTitle="true" derivedAnchor="RFC4055">
          <front>
            <title>Additional Algorithms and Identifiers for RSA Cryptography for use in the Internet X.509 Public Key Infrastructure Certificate and Certificate Revocation List (CRL) Profile</title>
            <author initials="J." surname="Schaad" fullname="J. Schaad">
              <organization showOnFrontPage="true"/>
            </author>
            <author initials="B." surname="Kaliski" fullname="B. Kaliski">
              <organization showOnFrontPage="true"/>
            </author>
            <author initials="R." surname="Housley" fullname="R. Housley">
              <organization showOnFrontPage="true"/>
            </author>
            <date year="2005" month="June"/>
            <abstract>
              <t>This document supplements RFC 3279.  It describes the conventions for using the RSA Probabilistic Signature Scheme (RSASSA-PSS) signature algorithm, the RSA Encryption Scheme - Optimal Asymmetric Encryption Padding (RSAES-OAEP) key transport algorithm and additional one-way hash functions with the Public-Key Cryptography Standards (PKCS) #1 version 1.5 signature algorithm in the Internet X.509 Public Key Infrastructure (PKI).  Encoding formats, algorithm identifiers, and parameter formats are specified.  [STANDARDS-TRACK]</t>
            </abstract>
          </front>
          <seriesInfo name="RFC" value="4055"/>
          <seriesInfo name="DOI" value="10.17487/RFC4055"/>
        </reference>
        <reference anchor="RFC5280" target="https://www.rfc-editor.org/info/rfc5280" quoteTitle="true" derivedAnchor="RFC5280">
          <front>
            <title>Internet X.509 Public Key Infrastructure Certificate and Certificate Revocation List (CRL) Profile</title>
            <author initials="D." surname="Cooper" fullname="D. Cooper">
              <organization showOnFrontPage="true"/>
            </author>
            <author initials="S." surname="Santesson" fullname="S. Santesson">
              <organization showOnFrontPage="true"/>
            </author>
            <author initials="S." surname="Farrell" fullname="S. Farrell">
              <organization showOnFrontPage="true"/>
            </author>
            <author initials="S." surname="Boeyen" fullname="S. Boeyen">
              <organization showOnFrontPage="true"/>
            </author>
            <author initials="R." surname="Housley" fullname="R. Housley">
              <organization showOnFrontPage="true"/>
            </author>
            <author initials="W." surname="Polk" fullname="W. Polk">
              <organization showOnFrontPage="true"/>
            </author>
            <date year="2008" month="May"/>
            <abstract>
              <t>This memo profiles the X.509 v3 certificate and X.509 v2 certificate revocation list (CRL) for use in the Internet.  An overview of this approach and model is provided as an introduction.  The X.509 v3 certificate format is described in detail, with additional information regarding the format and semantics of Internet name forms.  Standard certificate extensions are described and two Internet-specific extensions are defined.  A set of required certificate extensions is specified.  The X.509 v2 CRL format is described in detail along with standard and Internet-specific extensions.  An algorithm for X.509 certification path validation is described.  An ASN.1 module and examples are provided in the appendices.  [STANDARDS-TRACK]</t>
            </abstract>
          </front>
          <seriesInfo name="RFC" value="5280"/>
          <seriesInfo name="DOI" value="10.17487/RFC5280"/>
        </reference>
        <reference anchor="RFC5480" target="https://www.rfc-editor.org/info/rfc5480" quoteTitle="true" derivedAnchor="RFC5480">
          <front>
            <title>Elliptic Curve Cryptography Subject Public Key Information</title>
            <author initials="S." surname="Turner" fullname="S. Turner">
              <organization showOnFrontPage="true"/>
            </author>
            <author initials="D." surname="Brown" fullname="D. Brown">
              <organization showOnFrontPage="true"/>
            </author>
            <author initials="K." surname="Yiu" fullname="K. Yiu">
              <organization showOnFrontPage="true"/>
            </author>
            <author initials="R." surname="Housley" fullname="R. Housley">
              <organization showOnFrontPage="true"/>
            </author>
            <author initials="T." surname="Polk" fullname="T. Polk">
              <organization showOnFrontPage="true"/>
            </author>
            <date year="2009" month="March"/>
            <abstract>
              <t>This document specifies the syntax and semantics for the Subject Public Key Information field in certificates that support Elliptic Curve Cryptography.  This document updates Sections 2.3.5 and 5, and the ASN.1 module of "Algorithms and Identifiers for the Internet X.509 Public Key Infrastructure Certificate and Certificate Revocation List (CRL) Profile", RFC 3279.  [STANDARDS-TRACK]</t>
            </abstract>
          </front>
          <seriesInfo name="RFC" value="5480"/>
          <seriesInfo name="DOI" value="10.17487/RFC5480"/>
        </reference>
        <reference anchor="RFC8017" target="https://www.rfc-editor.org/info/rfc8017" quoteTitle="true" derivedAnchor="RFC8017">
          <front>
            <title>PKCS #1: RSA Cryptography Specifications Version 2.2</title>
            <author initials="K." surname="Moriarty" fullname="K. Moriarty" role="editor">
              <organization showOnFrontPage="true"/>
            </author>
            <author initials="B." surname="Kaliski" fullname="B. Kaliski">
              <organization showOnFrontPage="true"/>
            </author>
            <author initials="J." surname="Jonsson" fullname="J. Jonsson">
              <organization showOnFrontPage="true"/>
            </author>
            <author initials="A." surname="Rusch" fullname="A. Rusch">
              <organization showOnFrontPage="true"/>
            </author>
            <date year="2016" month="November"/>
            <abstract>
              <t>This document provides recommendations for the implementation of public-key cryptography based on the RSA algorithm, covering cryptographic primitives, encryption schemes, signature schemes with appendix, and ASN.1 syntax for representing keys and for identifying the schemes.</t>
              <t>This document represents a republication of PKCS #1 v2.2 from RSA Laboratories' Public-Key Cryptography Standards (PKCS) series.  By publishing this RFC, change control is transferred to the IETF.</t>
              <t>This document also obsoletes RFC 3447.</t>
            </abstract>
          </front>
          <seriesInfo name="RFC" value="8017"/>
          <seriesInfo name="DOI" value="10.17487/RFC8017"/>
        </reference>
        <reference anchor="RFC8174" target="https://www.rfc-editor.org/info/rfc8174" quoteTitle="true" derivedAnchor="RFC8174">
          <front>
            <title>Ambiguity of Uppercase vs Lowercase in RFC 2119 Key Words</title>
            <author initials="B." surname="Leiba" fullname="B. Leiba">
              <organization showOnFrontPage="true"/>
            </author>
            <date year="2017" month="May"/>
            <abstract>
              <t>RFC 2119 specifies common key words that may be used in protocol  specifications.  This document aims to reduce the ambiguity by clarifying that only UPPERCASE usage of the key words have the  defined special meanings.</t>
            </abstract>
          </front>
          <seriesInfo name="BCP" value="14"/>
          <seriesInfo name="RFC" value="8174"/>
          <seriesInfo name="DOI" value="10.17487/RFC8174"/>
        </reference>
        <reference anchor="SHA3" quoteTitle="true" target="https://doi.org/10.6028/NIST.FIPS.202" derivedAnchor="SHA3">
          <front>
            <title>SHA-3 Standard: Permutation-Based Hash and Extendable-Output Functions</title>
            <seriesInfo name="DOI" value="10.6028/NIST.FIPS.202"/>
            <seriesInfo name="FIPS PUB" value="202"/>
            <author>
              <organization showOnFrontPage="true">National Institute of Standards and Technology</organization>
            </author>
            <date year="2015" month="August"/>
          </front>
        </reference>
      </references>
      <references pn="section-7.2">
        <name slugifiedName="name-informative-references">Informative References</name>
        <reference anchor="Hash-Texts" target="https://www.iana.org/assignments/hash-function-text-names/" quoteTitle="true" derivedAnchor="Hash-Texts">
          <front>
            <title>Hash Function Textual Names</title>
            <author>
              <organization showOnFrontPage="true">IANA</organization>
            </author>
            <date/>
          </front>
        </reference>
        <reference anchor="RFC5912" target="https://www.rfc-editor.org/info/rfc5912" quoteTitle="true" derivedAnchor="RFC5912">
          <front>
            <title>New ASN.1 Modules for the Public Key Infrastructure Using X.509 (PKIX)</title>
            <author initials="P." surname="Hoffman" fullname="P. Hoffman">
              <organization showOnFrontPage="true"/>
            </author>
            <author initials="J." surname="Schaad" fullname="J. Schaad">
              <organization showOnFrontPage="true"/>
            </author>
            <date year="2010" month="June"/>
            <abstract>
              <t>The Public Key Infrastructure using X.509 (PKIX) certificate format, and many associated formats, are expressed using ASN.1.  The current ASN.1 modules conform to the 1988 version of ASN.1.  This document updates those ASN.1 modules to conform to the 2002 version of ASN.1. There are no bits-on-the-wire changes to any of the formats; this is simply a change to the syntax.  This document is not an Internet  Standards Track specification; it is published for informational  purposes.</t>
            </abstract>
          </front>
          <seriesInfo name="RFC" value="5912"/>
          <seriesInfo name="DOI" value="10.17487/RFC5912"/>
        </reference>
        <reference anchor="RFC6979" target="https://www.rfc-editor.org/info/rfc6979" quoteTitle="true" derivedAnchor="RFC6979">
          <front>
            <title>Deterministic Usage of the Digital Signature Algorithm (DSA) and Elliptic Curve Digital Signature Algorithm (ECDSA)</title>
            <author initials="T." surname="Pornin" fullname="T. Pornin">
              <organization showOnFrontPage="true"/>
            </author>
            <date year="2013" month="August"/>
            <abstract>
              <t>This document defines a deterministic digital signature generation procedure.  Such signatures are compatible with standard Digital Signature Algorithm (DSA) and Elliptic Curve Digital Signature Algorithm (ECDSA) digital signatures and can be processed with unmodified verifiers, which need not be aware of the procedure described therein.  Deterministic signatures retain the cryptographic security features associated with digital signatures but can be more easily implemented in various environments, since they do not need access to a source of high-quality randomness.</t>
            </abstract>
          </front>
          <seriesInfo name="RFC" value="6979"/>
          <seriesInfo name="DOI" value="10.17487/RFC6979"/>
        </reference>
        <reference anchor="SEC1" target="http://www.secg.org/sec1-v2.pdf" quoteTitle="true" derivedAnchor="SEC1">
          <front>
            <title>SEC 1: Elliptic Curve Cryptography</title>
            <author>
              <organization showOnFrontPage="true">Standards for Efficient Cryptography Group</organization>
            </author>
            <date month="May" year="2009"/>
          </front>
        </reference>
        <reference anchor="SMI-PKIX" target="https://www.iana.org/assignments/smi-numbers" quoteTitle="true" derivedAnchor="SMI-PKIX">
          <front>
            <title>SMI Security for PKIX Algorithms</title>
            <author>
              <organization showOnFrontPage="true">IANA</organization>
            </author>
            <date/>
          </front>
        </reference>
        <reference anchor="SP800-107" target="http://dx.doi.org/10.6028/NIST.SP.800-107r1" quoteTitle="true" derivedAnchor="SP800-107">
          <front>
            <title>Recommendation for Applications Using Approved Hash Algorithms</title>
            <seriesInfo name="DOI" value="10.6028/NIST.SP.800-107r1"/>
            <seriesInfo name="Revision" value="1"/>
            <seriesInfo name="NIST Special Publication (SP)" value="800-107"/>
            <author>
              <organization showOnFrontPage="true">National Institute of Standards and Technology (NIST)</organization>
            </author>
            <date month="August" year="2012"/>
          </front>
        </reference>
        <reference anchor="SP800-78-4" target="http://dx.doi.org/10.6028/NIST.SP.800-78-4" quoteTitle="true" derivedAnchor="SP800-78-4">
          <front>
            <title>Cryptographic Algorithms and Key Sizes for Personal Identity Verification</title>
            <seriesInfo name="DOI" value="10.6028/NIST.SP.800-78-4"/>
            <seriesInfo name="NIST Special Publication (SP)" value="800-78-4"/>
            <author>
              <organization showOnFrontPage="true">National Institute of Standards and Technology (NIST)</organization>
            </author>
            <date month="May" year="2015"/>
          </front>
        </reference>
        <reference anchor="X9.62" quoteTitle="true" derivedAnchor="X9.62">
          <front>
            <title>Public Key Cryptography for the Financial Services Industry: the Elliptic Curve Digital Signature Algorithm (ECDSA)</title>
            <seriesInfo name="ANSI" value="X9.62"/>
            <author>
              <organization showOnFrontPage="true">ANSI</organization>
            </author>
            <date year="2005"/>
          </front>
        </reference>
      </references>
    </references>
    <section anchor="asn" numbered="true" toc="include" removeInRFC="false" pn="section-appendix.a">
      <name slugifiedName="name-asn1-module">ASN.1 Module</name>
      <t pn="section-appendix.a-1">This appendix includes the ASN.1 module for SHAKEs in X.509. 
    This module does not come from any previously existing RFC. This module references <xref target="RFC5912" format="default" sectionFormat="of" derivedContent="RFC5912"/>.</t>
      <sourcecode type="asn.1" markers="false" pn="section-appendix.a-2">
PKIXAlgsForSHAKE-2019 { iso(1) identified-organization(3) dod(6)
  internet(1) security(5) mechanisms(5) pkix(7) id-mod(0)
  id-mod-pkix1-shakes-2019(94) }

DEFINITIONS EXPLICIT TAGS ::=

BEGIN

-- EXPORTS ALL;

IMPORTS

-- FROM RFC 5912

PUBLIC-KEY, SIGNATURE-ALGORITHM, DIGEST-ALGORITHM, SMIME-CAPS
FROM AlgorithmInformation-2009
  { iso(1) identified-organization(3) dod(6) internet(1) security(5)
    mechanisms(5) pkix(7) id-mod(0)
    id-mod-algorithmInformation-02(58) }

-- FROM RFC 5912

RSAPublicKey, rsaEncryption, pk-rsa, pk-ec,
CURVE, id-ecPublicKey, ECPoint, ECParameters, ECDSA-Sig-Value
FROM PKIXAlgs-2009 { iso(1) identified-organization(3) dod(6)
     internet(1) security(5) mechanisms(5) pkix(7) id-mod(0)
     id-mod-pkix1-algorithms2008-02(56) }
;

--
-- Message Digest Algorithms (mda-)
--
DigestAlgorithms DIGEST-ALGORITHM ::= {
  -- This expands DigestAlgorithms from RFC 5912
  mda-shake128   |
  mda-shake256,
  ...
}

--
-- One-Way Hash Functions
--

-- SHAKE128
mda-shake128 DIGEST-ALGORITHM ::= {
  IDENTIFIER id-shake128  -- with output length 32 bytes.
}
id-shake128 OBJECT IDENTIFIER ::= { joint-iso-itu-t(2) country(16)
                                    us(840) organization(1) gov(101)
                                    csor(3) nistAlgorithm(4)
                                    hashAlgs(2) 11 }

-- SHAKE256
mda-shake256 DIGEST-ALGORITHM ::= {
  IDENTIFIER id-shake256  -- with output length 64 bytes.
}
id-shake256 OBJECT IDENTIFIER ::= { joint-iso-itu-t(2) country(16)
                                    us(840) organization(1) gov(101)
                                    csor(3) nistAlgorithm(4)
                                    hashAlgs(2) 12 }

--
-- Public Key (pk-) Algorithms
--
PublicKeys PUBLIC-KEY ::= {
  -- This expands PublicKeys from RFC 5912
  pk-rsaSSA-PSS-SHAKE128 |
  pk-rsaSSA-PSS-SHAKE256,
  ...
}

-- The hashAlgorithm is mda-shake128
-- The maskGenAlgorithm is id-shake128
-- Mask Gen Algorithm is SHAKE128 with output length
-- (8*ceil((n-1)/8) - 264) bits, where n is the RSA 
-- modulus in bits.
-- The saltLength is 32.  The trailerField is 1.
pk-rsaSSA-PSS-SHAKE128 PUBLIC-KEY ::= {
  IDENTIFIER id-RSASSA-PSS-SHAKE128
  KEY RSAPublicKey
  PARAMS ARE absent
  -- Private key format not in this module --
  CERT-KEY-USAGE { nonRepudiation, digitalSignature,
                   keyCertSign, cRLSign }
}

-- The hashAlgorithm is mda-shake256
-- The maskGenAlgorithm is id-shake256
-- Mask Gen Algorithm is SHAKE256 with output length
-- (8*ceil((n-1)/8) - 520)-bits, where n is the RSA 
-- modulus in bits.
-- The saltLength is 64.  The trailerField is 1.
pk-rsaSSA-PSS-SHAKE256 PUBLIC-KEY ::= {
  IDENTIFIER id-RSASSA-PSS-SHAKE256
  KEY RSAPublicKey
  PARAMS ARE absent
  -- Private key format not in this module --
  CERT-KEY-USAGE { nonRepudiation, digitalSignature,
                   keyCertSign, cRLSign }
}

--
-- Signature Algorithms (sa-)
--
SignatureAlgs SIGNATURE-ALGORITHM ::= {
  -- This expands SignatureAlgorithms from RFC 5912
  sa-rsassapssWithSHAKE128 |
  sa-rsassapssWithSHAKE256 |
  sa-ecdsaWithSHAKE128 |
  sa-ecdsaWithSHAKE256,
  ...
}

--
-- SMIME Capabilities (sa-)
--
SMimeCaps SMIME-CAPS ::= {
  -- The expands SMimeCaps from RFC 5912
  sa-rsassapssWithSHAKE128.&amp;smimeCaps |
  sa-rsassapssWithSHAKE256.&amp;smimeCaps |
  sa-ecdsaWithSHAKE128.&amp;smimeCaps |
  sa-ecdsaWithSHAKE256.&amp;smimeCaps,
  ...
}

-- RSASSA-PSS with SHAKE128
sa-rsassapssWithSHAKE128 SIGNATURE-ALGORITHM ::= {
  IDENTIFIER id-RSASSA-PSS-SHAKE128
  PARAMS ARE absent
      -- The hashAlgorithm is mda-shake128
      -- The maskGenAlgorithm is id-shake128
      -- Mask Gen Algorithm is SHAKE128 with output length
      -- (8*ceil((n-1)/8) - 264) bits, where n is the RSA 
      -- modulus in bits.
      -- The saltLength is 32. The trailerField is 1
  HASHES { mda-shake128 }
  PUBLIC-KEYS { pk-rsa | pk-rsaSSA-PSS-SHAKE128 }
  SMIME-CAPS { IDENTIFIED BY id-RSASSA-PSS-SHAKE128 }
}
id-RSASSA-PSS-SHAKE128  OBJECT IDENTIFIER  ::=  { iso(1) 
        identified-organization(3) dod(6) internet(1) 
        security(5) mechanisms(5) pkix(7) algorithms(6)
        30 }

-- RSASSA-PSS with SHAKE256
sa-rsassapssWithSHAKE256 SIGNATURE-ALGORITHM ::= {
  IDENTIFIER id-RSASSA-PSS-SHAKE256
  PARAMS ARE absent
      -- The hashAlgorithm is mda-shake256
      -- The maskGenAlgorithm is id-shake256
      -- Mask Gen Algorithm is SHAKE256 with output length
      -- (8*ceil((n-1)/8) - 520)-bits, where n is the 
      -- RSA modulus in bits.
      -- The saltLength is 64. The trailerField is 1.
 HASHES { mda-shake256 }
 PUBLIC-KEYS { pk-rsa | pk-rsaSSA-PSS-SHAKE256 }
 SMIME-CAPS { IDENTIFIED BY id-RSASSA-PSS-SHAKE256 }
}
id-RSASSA-PSS-SHAKE256  OBJECT IDENTIFIER  ::=  { iso(1) 
        identified-organization(3) dod(6) internet(1) 
        security(5) mechanisms(5) pkix(7) algorithms(6)
        31 }

-- ECDSA with SHAKE128
sa-ecdsaWithSHAKE128 SIGNATURE-ALGORITHM ::= {
  IDENTIFIER id-ecdsa-with-shake128
  VALUE ECDSA-Sig-Value
  PARAMS ARE absent
  HASHES { mda-shake128 }
  PUBLIC-KEYS { pk-ec }
  SMIME-CAPS { IDENTIFIED BY id-ecdsa-with-shake128 }
}
id-ecdsa-with-shake128 OBJECT IDENTIFIER  ::=  { iso(1) 
        identified-organization(3) dod(6) internet(1) 
        security(5) mechanisms(5) pkix(7) algorithms(6)
        32 } 

-- ECDSA with SHAKE256
sa-ecdsaWithSHAKE256 SIGNATURE-ALGORITHM ::= {
  IDENTIFIER id-ecdsa-with-shake256
  VALUE ECDSA-Sig-Value
  PARAMS ARE absent
  HASHES { mda-shake256 }
  PUBLIC-KEYS { pk-ec }
  SMIME-CAPS { IDENTIFIED BY id-ecdsa-with-shake256 }
}
id-ecdsa-with-shake256 OBJECT IDENTIFIER  ::=  { iso(1) 
        identified-organization(3) dod(6) internet(1) 
        security(5) mechanisms(5) pkix(7) algorithms(6)
        33 }

END
</sourcecode>
    </section>
    <section anchor="Acknowledgements" numbered="false" toc="include" removeInRFC="false" pn="section-appendix.b">
      <name slugifiedName="name-acknowledgements">Acknowledgements</name>
      <t pn="section-appendix.b-1">We would like to thank Sean Turner, Jim Schaad, and Eric 
	  Rescorla for their valuable contributions to this document.</t>
      <t pn="section-appendix.b-2">The authors would like to thank Russ Housley for his guidance and 
	  very valuable contributions with the ASN.1 module.</t>
    </section>
    <section anchor="authors-addresses" numbered="false" removeInRFC="false" toc="include" pn="section-appendix.c">
      <name slugifiedName="name-authors-addresses">Authors' Addresses</name>
      <author fullname="Panos Kampanakis" initials="P." surname="Kampanakis">
        <organization showOnFrontPage="true">Cisco Systems</organization>
        <address>
          <email>pkampana@cisco.com</email>
        </address>
      </author>
      <author fullname="Quynh Dang" initials="Q." surname="Dang">
        <organization showOnFrontPage="true">NIST</organization>
        <address>
          <postal>
            <street>100 Bureau Drive, Stop 8930</street>
            <city>Gaithersburg</city>
            <region>MD</region>
            <code>20899-8930</code>
            <country>United States of America</country>
          </postal>
          <email>quynh.dang@nist.gov</email>
        </address>
      </author>
    </section>
  </back>
</rfc>
