Difference between revisions of "RFC6033"
Line 23: | Line 23: | ||
received public review and has been approved for publication by the | received public review and has been approved for publication by the | ||
Internet Engineering Steering Group (IESG). Further information on | Internet Engineering Steering Group (IESG). Further information on | ||
− | Internet Standards is available in Section 2 of RFC 5741. | + | Internet Standards is available in Section 2 of [[RFC5741|RFC 5741]]. |
Information about the current status of this document, any errata, | Information about the current status of this document, any errata, | ||
Line 34: | Line 34: | ||
document authors. All rights reserved. | document authors. All rights reserved. | ||
− | This document is subject to BCP 78 and the IETF Trust's Legal | + | This document is subject to [[BCP78|BCP 78]] and the IETF Trust's Legal |
Provisions Relating to IETF Documents | Provisions Relating to IETF Documents | ||
(http://trustee.ietf.org/license-info) in effect on the date of | (http://trustee.ietf.org/license-info) in effect on the date of | ||
Line 48: | Line 48: | ||
This document describes the conventions for using several | This document describes the conventions for using several | ||
cryptographic algorithms with the Cryptographic Message Syntax (CMS) | cryptographic algorithms with the Cryptographic Message Syntax (CMS) | ||
− | encrypted key package content type | + | encrypted key package content type [[RFC6032]]. Specifically, it |
includes conventions necessary to implement the following CMS content | includes conventions necessary to implement the following CMS content | ||
− | types: EnvelopedData | + | types: EnvelopedData [[RFC5652]], EncryptedData [[RFC5652]], and |
− | AuthEnvelopedData | + | AuthEnvelopedData [[RFC5083]]. |
This document does not define any new algorithms; instead, it refers | This document does not define any new algorithms; instead, it refers | ||
Line 60: | Line 60: | ||
The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", | The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", | ||
"SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this | "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this | ||
− | document are to be interpreted as described in | + | document are to be interpreted as described in [[RFC2119]]. |
== EnvelopedData == | == EnvelopedData == | ||
− | EnvelopedData | + | EnvelopedData [[RFC5652]] supports a number of key management |
techniques. Implementations that claim conformance to this document | techniques. Implementations that claim conformance to this document | ||
MUST support the key transport mechanisms and SHOULD support the key | MUST support the key transport mechanisms and SHOULD support the key | ||
Line 70: | Line 70: | ||
supported. | supported. | ||
− | When key transport is used, RSA encryption | + | When key transport is used, RSA encryption [[RFC3370]] MUST be |
supported and RSA Encryption Scheme - Optimal Asymmetric Encryption | supported and RSA Encryption Scheme - Optimal Asymmetric Encryption | ||
− | Padding (RSAES-OAEP) | + | Padding (RSAES-OAEP) [[RFC3560]] SHOULD be supported. |
When key agreement is used, Ephemeral-Static Diffie-Hellman (DH) | When key agreement is used, Ephemeral-Static Diffie-Hellman (DH) | ||
− | + | [[RFC3370]] MUST be supported. | |
Since the content type is used to carry a cryptographic key and its | Since the content type is used to carry a cryptographic key and its | ||
Line 81: | Line 81: | ||
key with another is employed. Regardless of the key management | key with another is employed. Regardless of the key management | ||
technique choice, implementations MUST support AES-128 Key Wrap with | technique choice, implementations MUST support AES-128 Key Wrap with | ||
− | Padding | + | Padding [[RFC5649]] as the content-encryption algorithm. |
Implementations SHOULD support AES-256 Key Wrap with Padding | Implementations SHOULD support AES-256 Key Wrap with Padding | ||
− | + | [[RFC5649]] as the content-encryption algorithm. | |
When key agreement is used, a key wrap algorithm is also specified to | When key agreement is used, a key wrap algorithm is also specified to | ||
wrap the content-encryption key. If the content-encryption algorithm | wrap the content-encryption key. If the content-encryption algorithm | ||
is AES-128 Key Wrap with Padding, then the key wrap algorithm MUST be | is AES-128 Key Wrap with Padding, then the key wrap algorithm MUST be | ||
− | AES-128 Key Wrap with Padding | + | AES-128 Key Wrap with Padding [[RFC5649]]. If the content-encryption |
algorithm is AES-256 Key Wrap with Padding, then the key wrap | algorithm is AES-256 Key Wrap with Padding, then the key wrap | ||
− | algorithm MUST be AES-256 Key Wrap with Padding | + | algorithm MUST be AES-256 Key Wrap with Padding [[RFC5649]]. |
== EncryptedData == | == EncryptedData == | ||
− | EncryptedData | + | EncryptedData [[RFC5652]] requires that keys be managed by other means; |
therefore, the only algorithm specified is the content-encryption | therefore, the only algorithm specified is the content-encryption | ||
algorithm. Since the content type is used to carry a cryptographic | algorithm. Since the content type is used to carry a cryptographic | ||
key and its attributes, an algorithm that is traditionally used to | key and its attributes, an algorithm that is traditionally used to | ||
encrypt one key with another is employed. Implementations MUST | encrypt one key with another is employed. Implementations MUST | ||
− | support AES-128 Key Wrap with Padding | + | support AES-128 Key Wrap with Padding [[RFC5649]]. Implementations |
− | SHOULD support AES-256 Key Wrap with Padding | + | SHOULD support AES-256 Key Wrap with Padding [[RFC5649]]. |
== AuthEnvelopedData == | == AuthEnvelopedData == | ||
− | AuthEnvelopedData | + | AuthEnvelopedData [[RFC5083]], like EnvelopedData, supports a number of |
key management techniques. The key management requirements for | key management techniques. The key management requirements for | ||
AuthEnvelopedData are the same as for EnvelopedData. The difference | AuthEnvelopedData are the same as for EnvelopedData. The difference | ||
is the content-encryption algorithm. Implementations MUST support | is the content-encryption algorithm. Implementations MUST support | ||
− | 128-bit AES-Galois/Counter Mode (AES-GCM) | + | 128-bit AES-Galois/Counter Mode (AES-GCM) [[RFC5084]] and SHOULD |
− | support 256-bit AES-GCM | + | support 256-bit AES-GCM [[RFC5084]]. Implementations MAY also support |
− | AES-Counter with CBC-MAC (AES-CCM) | + | AES-Counter with CBC-MAC (AES-CCM) [[RFC5084]]. |
== Signed Data == | == Signed Data == | ||
− | Implementations of SignedData | + | Implementations of SignedData [[RFC5652]] MUST support the signature |
− | scheme RSA | + | scheme RSA [[RFC3370]] [[RFC5754]] and SHOULD support the signature |
− | schemes RSA Probabilistic Signature Scheme (RSASSA-PSS) | + | schemes RSA Probabilistic Signature Scheme (RSASSA-PSS) [[RFC4056]] and |
− | Digital Signature Algorithm (DSA) | + | Digital Signature Algorithm (DSA) [[RFC3370]] [[RFC5754]]. Additionally, |
implementations MUST support in concert with these signature schemes | implementations MUST support in concert with these signature schemes | ||
− | the hash function SHA-256 | + | the hash function SHA-256 [[RFC5754]] and it SHOULD support the hash |
− | function SHA-1 | + | function SHA-1 [[RFC3370]]. |
== Public Key Sizes == | == Public Key Sizes == | ||
The easiest way to implement SignedData, EnvelopedData, and | The easiest way to implement SignedData, EnvelopedData, and | ||
− | AuthEnvelopedData is with public key certificates | + | AuthEnvelopedData is with public key certificates [[RFC5280]]. If an |
implementation supports RSA, RSAES-OAEP, DH, RSASSA-PSS, or DSA, then | implementation supports RSA, RSAES-OAEP, DH, RSASSA-PSS, or DSA, then | ||
it MUST support key lengths from 1024 bits to 2048 bits, inclusive. | it MUST support key lengths from 1024 bits to 2048 bits, inclusive. | ||
Line 131: | Line 131: | ||
== Security Considerations == | == Security Considerations == | ||
− | The security considerations from | + | The security considerations from [[RFC3370]], [[RFC3560]], [[RFC4056]], |
− | + | [[RFC5083]], [[RFC5084]], [[RFC5649]], [[RFC5652]], [[RFC5754]], and [[RFC6032]] | |
apply. | apply. | ||
The choice of content-encryption algorithms for this document was | The choice of content-encryption algorithms for this document was | ||
− | based on | + | based on [[RFC5649]]: "In the design of some high assurance |
cryptographic modules, it is desirable to segregate cryptographic | cryptographic modules, it is desirable to segregate cryptographic | ||
keying material from other data. The use of a specific cryptographic | keying material from other data. The use of a specific cryptographic | ||
Line 155: | Line 155: | ||
=== Normative References === | === Normative References === | ||
− | + | [[RFC2119]] Bradner, S., "Key words for use in RFCs to Indicate | |
− | Requirement Levels", BCP 14, RFC 2119, March 1997. | + | Requirement Levels", [[BCP14|BCP 14]], [[RFC2119|RFC 2119]], March 1997. |
− | + | [[RFC3370]] Housley, R., "Cryptographic Message Syntax (CMS) | |
− | Algorithms", RFC 3370, August 2002. | + | Algorithms", [[RFC3370|RFC 3370]], August 2002. |
− | + | [[RFC3560]] Housley, R., "Use of the RSAES-OAEP Key Transport | |
Algorithm in Cryptographic Message Syntax (CMS)", RFC | Algorithm in Cryptographic Message Syntax (CMS)", RFC | ||
3560, July 2003. | 3560, July 2003. | ||
− | + | [[RFC4056]] Schaad, J., "Use of the RSASSA-PSS Signature Algorithm in | |
− | Cryptographic Message Syntax (CMS)", RFC 4056, June 2005. | + | Cryptographic Message Syntax (CMS)", [[RFC4056|RFC 4056]], June 2005. |
− | + | [[RFC5083]] Housley, R., "Cryptographic Message Syntax (CMS) | |
− | Authenticated-Enveloped-Data Content Type", RFC 5083, | + | Authenticated-Enveloped-Data Content Type", [[RFC5083|RFC 5083]], |
November 2007. | November 2007. | ||
− | + | [[RFC5084]] Housley, R., "Using AES-CCM and AES-GCM Authenticated | |
Encryption in the Cryptographic Message Syntax (CMS)", | Encryption in the Cryptographic Message Syntax (CMS)", | ||
− | RFC 5084, November 2007. | + | [[RFC5084|RFC 5084]], November 2007. |
− | + | [[RFC5280]] Cooper, D., Santesson, S., Farrell, S., Boeyen, S., | |
Housley, R., and W. Polk, "Internet X.509 Public Key | Housley, R., and W. Polk, "Internet X.509 Public Key | ||
Infrastructure Certificate and Certificate Revocation | Infrastructure Certificate and Certificate Revocation | ||
− | List (CRL) Profile", RFC 5280, May 2008. | + | List (CRL) Profile", [[RFC5280|RFC 5280]], May 2008. |
− | + | [[RFC5649]] Housley, R. and M. Dworkin, "Advanced Encryption Standard | |
− | (AES) Key Wrap with Padding Algorithm", RFC 5649, | + | (AES) Key Wrap with Padding Algorithm", [[RFC5649|RFC 5649]], |
September 2009. | September 2009. | ||
− | + | [[RFC5652]] Housley, R., "Cryptographic Message Syntax (CMS)", STD | |
− | 70, RFC 5652, September 2009. | + | 70, [[RFC5652|RFC 5652]], September 2009. |
− | + | [[RFC5754]] Turner, S., "Using SHA2 Algorithms with Cryptographic | |
− | Message Syntax", RFC 5754, January 2010. | + | Message Syntax", [[RFC5754|RFC 5754]], January 2010. |
− | + | [[RFC6032]] Turner, S. and R. Housley, "Cryptographic Message Syntax | |
− | (CMS) Encrypted Key Package Content Type", RFC 6032, | + | (CMS) Encrypted Key Package Content Type", [[RFC6032|RFC 6032]], |
December 2010. | December 2010. | ||
Latest revision as of 02:02, 22 October 2020
Internet Engineering Task Force (IETF) S. Turner Request for Comments: 6033 IECA Category: Standards Track December 2010 ISSN: 2070-1721
Algorithms for Cryptographic Message Syntax (CMS) Encrypted Key Package Content Type
Abstract
This document describes the conventions for using several cryptographic algorithms with the Cryptographic Message Syntax (CMS) encrypted key package content type. Specifically, it includes conventions necessary to implement 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 Section 2 of RFC 5741.
Information about the current status of this document, any errata, and how to provide feedback on it may be obtained at http://www.rfc-editor.org/info/rfc6033.
Copyright Notice
Copyright (c) 2010 IETF Trust and the persons identified as the document authors. All rights reserved.
This document is subject to BCP 78 and the IETF Trust's Legal Provisions Relating to IETF Documents (http://trustee.ietf.org/license-info) 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.
Contents
Introduction
This document describes the conventions for using several cryptographic algorithms with the Cryptographic Message Syntax (CMS) encrypted key package content type RFC6032. Specifically, it includes conventions necessary to implement the following CMS content types: EnvelopedData RFC5652, EncryptedData RFC5652, and AuthEnvelopedData RFC5083.
This document does not define any new algorithms; instead, it refers to previously defined algorithms.
Terminology
The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this document are to be interpreted as described in RFC2119.
EnvelopedData
EnvelopedData RFC5652 supports a number of key management techniques. Implementations that claim conformance to this document MUST support the key transport mechanisms and SHOULD support the key agreement mechanisms as defined below. Other techniques MAY be supported.
When key transport is used, RSA encryption RFC3370 MUST be supported and RSA Encryption Scheme - Optimal Asymmetric Encryption Padding (RSAES-OAEP) RFC3560 SHOULD be supported.
When key agreement is used, Ephemeral-Static Diffie-Hellman (DH) RFC3370 MUST be supported.
Since the content type is used to carry a cryptographic key and its attributes, an algorithm that is traditionally used to encrypt one key with another is employed. Regardless of the key management technique choice, implementations MUST support AES-128 Key Wrap with Padding RFC5649 as the content-encryption algorithm. Implementations SHOULD support AES-256 Key Wrap with Padding RFC5649 as the content-encryption algorithm.
When key agreement is used, a key wrap algorithm is also specified to wrap the content-encryption key. If the content-encryption algorithm is AES-128 Key Wrap with Padding, then the key wrap algorithm MUST be AES-128 Key Wrap with Padding RFC5649. If the content-encryption algorithm is AES-256 Key Wrap with Padding, then the key wrap algorithm MUST be AES-256 Key Wrap with Padding RFC5649.
EncryptedData
EncryptedData RFC5652 requires that keys be managed by other means; therefore, the only algorithm specified is the content-encryption algorithm. Since the content type is used to carry a cryptographic key and its attributes, an algorithm that is traditionally used to encrypt one key with another is employed. Implementations MUST support AES-128 Key Wrap with Padding RFC5649. Implementations SHOULD support AES-256 Key Wrap with Padding RFC5649.
AuthEnvelopedData
AuthEnvelopedData RFC5083, like EnvelopedData, supports a number of key management techniques. The key management requirements for AuthEnvelopedData are the same as for EnvelopedData. The difference is the content-encryption algorithm. Implementations MUST support 128-bit AES-Galois/Counter Mode (AES-GCM) RFC5084 and SHOULD support 256-bit AES-GCM RFC5084. Implementations MAY also support AES-Counter with CBC-MAC (AES-CCM) RFC5084.
Signed Data
Implementations of SignedData RFC5652 MUST support the signature scheme RSA RFC3370 RFC5754 and SHOULD support the signature schemes RSA Probabilistic Signature Scheme (RSASSA-PSS) RFC4056 and Digital Signature Algorithm (DSA) RFC3370 RFC5754. Additionally, implementations MUST support in concert with these signature schemes the hash function SHA-256 RFC5754 and it SHOULD support the hash function SHA-1 RFC3370.
Public Key Sizes
The easiest way to implement SignedData, EnvelopedData, and AuthEnvelopedData is with public key certificates RFC5280. If an implementation supports RSA, RSAES-OAEP, DH, RSASSA-PSS, or DSA, then it MUST support key lengths from 1024 bits to 2048 bits, inclusive.
Security Considerations
The security considerations from RFC3370, RFC3560, RFC4056, RFC5083, RFC5084, RFC5649, RFC5652, RFC5754, and RFC6032 apply.
The choice of content-encryption algorithms for this document was based on RFC5649: "In the design of some high assurance cryptographic modules, it is desirable to segregate cryptographic keying material from other data. The use of a specific cryptographic mechanism solely for the protection of cryptographic keying material
can assist in this goal". Unfortunately, there is no AES-GCM or AES-CCM mode that provides the same properties. If an AES-GCM and AES-CCM mode that provides the same properties is defined, then this document will be updated to adopt that algorithm.
[SP800-57] provides comparable bits of security for some algorithms and key sizes. [SP800-57] also provides time frames during which certain numbers of bits of security are appropriate, and some environments may find these time frames useful.
References
Normative References
RFC2119 Bradner, S., "Key words for use in RFCs to Indicate
Requirement Levels", BCP 14, RFC 2119, March 1997.
RFC3370 Housley, R., "Cryptographic Message Syntax (CMS)
Algorithms", RFC 3370, August 2002.
RFC3560 Housley, R., "Use of the RSAES-OAEP Key Transport
Algorithm in Cryptographic Message Syntax (CMS)", RFC 3560, July 2003.
RFC4056 Schaad, J., "Use of the RSASSA-PSS Signature Algorithm in
Cryptographic Message Syntax (CMS)", RFC 4056, June 2005.
RFC5083 Housley, R., "Cryptographic Message Syntax (CMS)
Authenticated-Enveloped-Data Content Type", RFC 5083, November 2007.
RFC5084 Housley, R., "Using AES-CCM and AES-GCM Authenticated
Encryption in the Cryptographic Message Syntax (CMS)", RFC 5084, November 2007.
RFC5280 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", RFC 5280, May 2008.
RFC5649 Housley, R. and M. Dworkin, "Advanced Encryption Standard
(AES) Key Wrap with Padding Algorithm", RFC 5649, September 2009.
RFC5652 Housley, R., "Cryptographic Message Syntax (CMS)", STD
70, RFC 5652, September 2009.
RFC5754 Turner, S., "Using SHA2 Algorithms with Cryptographic
Message Syntax", RFC 5754, January 2010.
RFC6032 Turner, S. and R. Housley, "Cryptographic Message Syntax
(CMS) Encrypted Key Package Content Type", RFC 6032, December 2010.
Informative References
[SP800-57] 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]