Algorithms for Cryptographic Message Syntax (CMS) Key Package Receipt and Error Content Types

[RFC Home] [TEXT|PDF|HTML] [Tracker] [IPR] [Info page]

PROPOSED STANDARD

Internet Engineering Task Force (IETF)                         S. Turner
Request for Comments: 7192                                          IECA
Category: Standards Track                                     April 2014
ISSN: 2070-1721


           <span class="h1">Algorithms for Cryptographic Message Syntax (CMS)</span>
              <span class="h1">Key Package Receipt and Error Content Types</span>

Abstract

   This document describes the conventions for using several
   cryptographic algorithms with the Cryptographic Message Syntax (CMS)
   key package receipt and error content types.  Specifically, it
   includes conventions necessary to implement SignedData,
   EnvelopedData, EncryptedData, and AuthEnvelopedData.

Status of This Memo

   This is an Internet Standards Track document.

   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 <a href="./rfc5741#section-2">Section 2 of RFC 5741</a>.

   Information about the current status of this document, any errata,
   and how to provide feedback on it may be obtained at
   <a href="https://www.rfc-editor.org/info/rfc7192">http://www.rfc-editor.org/info/rfc7192</a>.

Copyright Notice

   Copyright (c) 2014 IETF Trust and the persons identified as the
   document authors.  All rights reserved.

   This document is subject to <a href="https://www.rfc-editor.org/bcp/bcp78">BCP 78</a> and the IETF Trust's Legal
   Provisions Relating to IETF Documents
   (<a href="http://trustee.ietf.org/license-info">http://trustee.ietf.org/license-info</a>) 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.






<span class="grey">Turner                       Standards Track                    [Page 1]</span>

---

<span id="page-2" ></span>
<span class="grey"><a href="./rfc7192">RFC 7192</a>       Algs for CMS Key Package Rcpt Content Type     April 2014</span>


<span class="h2"><a class="selflink" id="section-1" href="#section-1">1</a>.  Introduction</span>

   This document describes the conventions for using several
   cryptographic algorithms with the Cryptographic Message Syntax (CMS)
   key package receipt and error content types [<a href="./rfc7191" title=""Cryptographic Message Syntax (CMS) Key Package Receipt and Error Content Types"">RFC7191</a>].  Specifically,
   it includes conventions necessary to implement SignedData [<a href="./rfc5652" title=""Cryptographic Message Syntax (CMS)"">RFC5652</a>],
   EnvelopedData [<a href="./rfc5652" title=""Cryptographic Message Syntax (CMS)"">RFC5652</a>], EncryptedData [<a href="./rfc5652" title=""Cryptographic Message Syntax (CMS)"">RFC5652</a>], and
   AuthEnvelopedData [<a href="./rfc5083" title=""Cryptographic Message Syntax (CMS) Authenticated-Enveloped-Data Content Type"">RFC5083</a>].

   This document does not define any new algorithms; instead, it refers
   to previously defined algorithms.  In fact, the algorithm
   requirements in this document are the same as those in [<a href="./rfc5959" title=""Algorithms for Asymmetric Key Package Content Type"">RFC5959</a>],
   [<a href="./rfc6033" title=""Algorithms for Cryptographic Message Syntax (CMS) Encrypted Key Package Content Type"">RFC6033</a>], [<a href="./rfc6160" title=""Algorithms for Cryptographic Message Syntax (CMS) Protection of Symmetric Key Package Content Types"">RFC6160</a>], [<a href="./rfc6161" title=""Elliptic Curve Algorithms for Cryptographic Message Syntax (CMS) Encrypted Key Package Content Type"">RFC6161</a>], and [<a href="./rfc6162" title=""Elliptic Curve Algorithms for Cryptographic Message Syntax (CMS) Asymmetric Key Package Content Type"">RFC6162</a>] with the following
   exceptions: the content-encryption algorithm is AES in Cipher Block
   Chaining (CBC) mode as opposed to AES Key Wrap with Message Length
   Indicator (MLI) and the key-wrap algorithm is AES Key Wrap as opposed
   to AES Key Wrap with MLI.  The rationale for the difference is that
   the receipt and error content types are not keys; therefore, AES Key
   Wrap with MLI is not appropriate for the content-encryption
   algorithm.  If an implementation is not using AES Key Wrap with MLI
   as the content-encryption algorithm, then there's no need to keep the
   key-wrap algorithm the same as the content encryption algorithm.

   NOTE: [<a href="./rfc7191" title=""Cryptographic Message Syntax (CMS) Key Package Receipt and Error Content Types"">RFC7191</a>] only requires that the key package receipt be signed.

<span class="h3"><a class="selflink" id="section-1.1" href="#section-1.1">1.1</a>.  Terminology</span>

   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
   [<a href="./rfc2119" title=""Key words for use in RFCs to Indicate Requirement Levels"">RFC2119</a>].

<span class="h2"><a class="selflink" id="section-2" href="#section-2">2</a>.  SignedData</span>

   If an implementation supports SignedData, then it MUST support the
   signature scheme RSA [<a href="./rfc3370" title=""Cryptographic Message Syntax (CMS) Algorithms"">RFC3370</a>] and SHOULD support the signature
   schemes RSA Probabilistic Signature Scheme (RSASSA-PSS) [<a href="./rfc4056" title=""Use of the RSASSA-PSS Signature Algorithm in Cryptographic Message Syntax (CMS)"">RFC4056</a>] and
   Digital Signature Algorithm (DSA) [<a href="./rfc3370" title=""Cryptographic Message Syntax (CMS) Algorithms"">RFC3370</a>].  Additionally,
   implementations MUST support the hash function SHA-256 [<a href="./rfc5754" title=""Using SHA2 Algorithms with Cryptographic Message Syntax"">RFC5754</a>] in
   concert with these signature schemes, and they SHOULD support the
   hash function SHA-1 [<a href="./rfc3370" title=""Cryptographic Message Syntax (CMS) Algorithms"">RFC3370</a>].  Implementations can also choose the
   to support Elliptic Curve Digital Signature Algorithm (ECDSA)
   [<a href="./rfc5753" title=""Use of Elliptic Curve Cryptography (ECC) Algorithms in Cryptographic Message Syntax (CMS)"">RFC5753</a>] and [<a href="./rfc6090" title=""Fundamental Elliptic Curve Cryptography Algorithms"">RFC6090</a>].








<span class="grey">Turner                       Standards Track                    [Page 2]</span>

---

<span id="page-3" ></span>
<span class="grey"><a href="./rfc7192">RFC 7192</a>       Algs for CMS Key Package Rcpt Content Type     April 2014</span>


<span class="h2"><a class="selflink" id="section-3" href="#section-3">3</a>.  EnvelopedData</span>

   If an implementation supports EnvelopedData, then it MUST implement
   key transport and it MAY implement key agreement.

   When key transport is used, RSA encryption [<a href="./rfc3370" title=""Cryptographic Message Syntax (CMS) Algorithms"">RFC3370</a>] MUST be
   supported, and RSA Encryption Scheme - Optimal Asymmetric Encryption
   Padding (RSAES-OAEP) [<a href="./rfc3560" title=""Use of the RSAES-OAEP Key Transport Algorithm in Cryptographic Message Syntax (CMS)"">RFC3560</a>] SHOULD be supported.

   When key agreement is used, Diffie-Hellman (DH) ephemeral-static
   [<a href="./rfc3370" title=""Cryptographic Message Syntax (CMS) Algorithms"">RFC3370</a>] MUST be supported.  When key agreement is used, Elliptic
   Curve Diffie-Hellman (ECDH) [<a href="./rfc5753" title=""Use of Elliptic Curve Cryptography (ECC) Algorithms in Cryptographic Message Syntax (CMS)"">RFC5753</a>] [<a href="./rfc6090" title=""Fundamental Elliptic Curve Cryptography Algorithms"">RFC6090</a>] MAY be supported.

   Regardless of the key management technique choice, implementations
   MUST support AES-128 in CBC mode [<a href="#ref-AES" title="FIPS Pub 197: Advanced Encryption Standard (AES)">AES</a>] as the content-encryption
   algorithm.  Implementations SHOULD support AES-256 in CBC mode [<a href="#ref-AES" title="FIPS Pub 197: Advanced Encryption Standard (AES)">AES</a>]
   as the content-encryption algorithm.

   When key agreement is used, the same length for the underlying block
   algorithm MUST be used.  If the content-encryption algorithm is
   AES-128 in CBC mode, then the key-wrap algorithm MUST be AES-128 Key
   Wrap [<a href="./rfc3394" title=""Advanced Encryption Standard (AES) Key Wrap Algorithm"">RFC3394</a>].  If the content-encryption algorithm is AES-256 in
   CBC mode, then the key-wrap algorithm MUST be AES-256 Key Wrap
   [<a href="./rfc3394" title=""Advanced Encryption Standard (AES) Key Wrap Algorithm"">RFC3394</a>].

<span class="h2"><a class="selflink" id="section-4" href="#section-4">4</a>.  EncryptedData</span>

   If an implementation supports EncryptedData, then it MUST implement
   AES-128 in CBC mode [<a href="#ref-AES" title="FIPS Pub 197: Advanced Encryption Standard (AES)">AES</a>] and SHOULD implement AES-256 in CBC mode
   [<a href="#ref-AES" title="FIPS Pub 197: Advanced Encryption Standard (AES)">AES</a>].

   NOTE: EncryptedData requires that keys be managed by other means;
   therefore, the only algorithm specified is the content-encryption
   algorithm.

<span class="h2"><a class="selflink" id="section-5" href="#section-5">5</a>.  AuthEnvelopedData</span>

   If an implementation supports AuthEnvelopedData, then it MUST
   implement the EnvelopedData recommendations except for the content-
   encryption algorithm, which, in this case, MUST be AES-GCM [<a href="./rfc5084" title=""Using AES-CCM and AES-GCM Authenticated Encryption in the Cryptographic Message Syntax (CMS)"">RFC5084</a>];
   the 128-bit version MUST be implemented, and the 256-bit version
   SHOULD be implemented.  Implementations MAY also support AES-CCM
   [<a href="./rfc5084" title=""Using AES-CCM and AES-GCM Authenticated Encryption in the Cryptographic Message Syntax (CMS)"">RFC5084</a>].








<span class="grey">Turner                       Standards Track                    [Page 3]</span>

---

<span id="page-4" ></span>
<span class="grey"><a href="./rfc7192">RFC 7192</a>       Algs for CMS Key Package Rcpt Content Type     April 2014</span>


<span class="h2"><a class="selflink" id="section-6" href="#section-6">6</a>.  Public Key Sizes</span>

   The easiest way to implement SignedData, EnvelopedData, and
   AuthEnvelopedData is with public key certificates [<a href="./rfc5280" title=""Internet X.509 Public Key Infrastructure Certificate and Certificate Revocation List (CRL) Profile"">RFC5280</a>].  If an
   implementation supports RSA, RSASSA-PSS, DSA, RSAES-OAEP, or Diffie-
   Hellman, then it MUST support key lengths from 1024-bit to 2048-bit,
   inclusive.  If an implementation supports ECDSA or ECDH, then it MUST
   support keys on the P-256 curve [<a href="./rfc6090" title=""Fundamental Elliptic Curve Cryptography Algorithms"">RFC6090</a>].

<span class="h2"><a class="selflink" id="section-7" href="#section-7">7</a>.  Security Considerations</span>

   The security considerations from [<a href="./rfc3370" title=""Cryptographic Message Syntax (CMS) Algorithms"">RFC3370</a>], [<a href="./rfc3394" title=""Advanced Encryption Standard (AES) Key Wrap Algorithm"">RFC3394</a>], [<a href="./rfc3560" title=""Use of the RSAES-OAEP Key Transport Algorithm in Cryptographic Message Syntax (CMS)"">RFC3560</a>],
   [<a href="./rfc4056" title=""Use of the RSASSA-PSS Signature Algorithm in Cryptographic Message Syntax (CMS)"">RFC4056</a>], [<a href="./rfc5084" title=""Using AES-CCM and AES-GCM Authenticated Encryption in the Cryptographic Message Syntax (CMS)"">RFC5084</a>], [<a href="./rfc5652" title=""Cryptographic Message Syntax (CMS)"">RFC5652</a>], [<a href="./rfc5753" title=""Use of Elliptic Curve Cryptography (ECC) Algorithms in Cryptographic Message Syntax (CMS)"">RFC5753</a>], and [<a href="./rfc5754" title=""Using SHA2 Algorithms with Cryptographic Message Syntax"">RFC5754</a>] apply.

   [<a id="ref-SP800-57">SP800-57</a>] provides comparable bits of security for some algorithms
   and key sizes.  [<a href="#ref-SP800-57" title=" Special Publication 800-57: Recommendation for Key Management - Part 1 (Revised)">SP800-57</a>] also provides time frames during which
   certain numbers of bits of security are appropriate, and some
   environments may find these time frames useful.

<span class="h2"><a class="selflink" id="section-8" href="#section-8">8</a>.  Acknowledgements</span>

   I'd like to thank Russ Housley for his early feedback on this
   document.

<span class="h2"><a class="selflink" id="section-9" href="#section-9">9</a>.  References</span>

<span class="h3"><a class="selflink" id="section-9.1" href="#section-9.1">9.1</a>.  Normative References</span>

   [<a id="ref-AES">AES</a>]      National Institute of Standards and Technology, FIPS Pub
              197: Advanced Encryption Standard (AES), 26 November 2001.

   [<a id="ref-RFC2119">RFC2119</a>]  Bradner, S., "Key words for use in RFCs to Indicate
              Requirement Levels", <a href="https://www.rfc-editor.org/bcp/bcp14">BCP 14</a>, <a href="./rfc2119">RFC 2119</a>, March 1997.

   [<a id="ref-RFC3370">RFC3370</a>]  Housley, R., "Cryptographic Message Syntax (CMS)
              Algorithms", <a href="./rfc3370">RFC 3370</a>, August 2002.

   [<a id="ref-RFC3394">RFC3394</a>]  Schaad, J. and R. Housley, "Advanced Encryption Standard
              (AES) Key Wrap Algorithm", <a href="./rfc3394">RFC 3394</a>, September 2002.

   [<a id="ref-RFC3560">RFC3560</a>]  Housley, R., "Use of the RSAES-OAEP Key Transport
              Algorithm in Cryptographic Message Syntax (CMS)", <a href="./rfc3560">RFC</a>
              <a href="./rfc3560">3560</a>, July 2003.

   [<a id="ref-RFC4056">RFC4056</a>]  Schaad, J., "Use of the RSASSA-PSS Signature Algorithm in
              Cryptographic Message Syntax (CMS)", <a href="./rfc4056">RFC 4056</a>, June 2005.





<span class="grey">Turner                       Standards Track                    [Page 4]</span>

---

<span id="page-5" ></span>
<span class="grey"><a href="./rfc7192">RFC 7192</a>       Algs for CMS Key Package Rcpt Content Type     April 2014</span>


   [<a id="ref-RFC5083">RFC5083</a>]  Housley, R., "Cryptographic Message Syntax (CMS)
              Authenticated-Enveloped-Data Content Type", <a href="./rfc5083">RFC 5083</a>,
              November 2007.

   [<a id="ref-RFC5084">RFC5084</a>]  Housley, R., "Using AES-CCM and AES-GCM Authenticated
              Encryption in the Cryptographic Message Syntax (CMS)", <a href="./rfc5084">RFC</a>
              <a href="./rfc5084">5084</a>, November 2007.

   [<a id="ref-RFC5280">RFC5280</a>]  Cooper, D., Santesson, S., Farrell, S., Boeyen, S.,
              Housley, R., and W. Polk, "Internet X.509 Public Key
              Infrastructure Certificate and Certificate Revocation List
              (CRL) Profile", <a href="./rfc5280">RFC 5280</a>, May 2008.

   [<a id="ref-RFC5652">RFC5652</a>]  Housley, R., "Cryptographic Message Syntax (CMS)", STD 70,
              <a href="./rfc5652">RFC 5652</a>, September 2009.

   [<a id="ref-RFC5753">RFC5753</a>]  Turner, S. and D. Brown, "Use of Elliptic Curve
              Cryptography (ECC) Algorithms in Cryptographic Message
              Syntax (CMS)", <a href="./rfc5753">RFC 5753</a>, January 2010.

   [<a id="ref-RFC5754">RFC5754</a>]  Turner, S., "Using SHA2 Algorithms with Cryptographic
              Message Syntax", <a href="./rfc5754">RFC 5754</a>, January 2010.

   [<a id="ref-RFC6090">RFC6090</a>]  McGrew, D., Igoe, K., and M. Salter, "Fundamental Elliptic
              Curve Cryptography Algorithms", <a href="./rfc6090">RFC 6090</a>, February 2011.

   [<a id="ref-RFC7191">RFC7191</a>]  Housley, R., "Cryptographic Message Syntax (CMS) Key
              Package Receipt and Error Content Types", <a href="./rfc7191">RFC 7191</a>, April
              2014.

<span class="h2"><a class="selflink" id="section-9" href="#section-9">9</a>.   Informative References</span>

   [<a id="ref-RFC5959">RFC5959</a>]  Turner, S., "Algorithms for Asymmetric Key Package Content
              Type", <a href="./rfc5959">RFC 5959</a>, August 2010.

   [<a id="ref-RFC6033">RFC6033</a>]  Turner, S., "Algorithms for Cryptographic Message Syntax
              (CMS) Encrypted Key Package Content Type", <a href="./rfc6033">RFC 6033</a>,
              December 2010.

   [<a id="ref-RFC6160">RFC6160</a>]  Turner, S., "Algorithms for Cryptographic Message Syntax
              (CMS) Protection of Symmetric Key Package Content Types",
              <a href="./rfc6160">RFC 6160</a>, April 2011.

   [<a id="ref-RFC6161">RFC6161</a>]  Turner, S., "Elliptic Curve Algorithms for Cryptographic
              Message Syntax (CMS) Encrypted Key Package Content Type",
              <a href="./rfc6161">RFC 6161</a>, April 2011.





<span class="grey">Turner                       Standards Track                    [Page 5]</span>

---

<span id="page-6" ></span>
<span class="grey"><a href="./rfc7192">RFC 7192</a>       Algs for CMS Key Package Rcpt Content Type     April 2014</span>


   [<a id="ref-RFC6162">RFC6162</a>]  Turner, S., "Elliptic Curve Algorithms for Cryptographic
              Message Syntax (CMS) Asymmetric Key Package Content Type",
              <a href="./rfc6162">RFC 6162</a>, April 2011.

   [<a id="ref-SP800-57">SP800-57</a>] National Institute of Standards and Technology (NIST),
              Special Publication 800-57: Recommendation for Key
              Management - Part 1 (Revised), March 2007.

Author's Address

   Sean Turner
   IECA, Inc.
   3057 Nutley Street, Suite 106
   Fairfax, VA 22031
   USA

   EMail: [email protected]


































Turner                       Standards Track                    [Page 6]