💾 Archived View for gemini.bortzmeyer.org › rfc-mirror › rfc3560.txt captured on 2023-06-14 at 17:41:31.
⬅️ Previous capture (2021-11-30)
-=-=-=-=-=-=-
Network Working Group R. Housley
Request for Comments: 3560 Vigil Security
Category: Standards Track July 2003
Use of the RSAES-OAEP Key Transport Algorithm in
the Cryptographic Message Syntax (CMS)
Status of this Memo
This document specifies an Internet standards track protocol for the
Internet community, and requests discussion and suggestions for
improvements. Please refer to the current edition of the "Internet
Official Protocol Standards" (STD 1) for the standardization state
and status of this protocol. Distribution of this memo is unlimited.
Copyright Notice
Copyright (C) The Internet Society (2003). All Rights Reserved.
Abstract
This document describes the conventions for using the RSAES-OAEP key
transport algorithm with the Cryptographic Message Syntax (CMS). The
CMS specifies the enveloped-data content type, which consists of an
encrypted content and encrypted content-encryption keys for one or
more recipients. The RSAES-OAEP key transport algorithm can be used
to encrypt content-encryption keys for intended recipients.
Table of Contents
1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . . 2
2. Enveloped-data Conventions . . . . . . . . . . . . . . . . . . 3
2.1. EnvelopedData Fields . . . . . . . . . . . . . . . . . . 3
2.2. KeyTransRecipientInfo Fields . . . . . . . . . . . . . . 4
3. RSAES-OAEP Algorithm Identifiers and Parameters. . . . . . . . 4
4. Certificate Conventions. . . . . . . . . . . . . . . . . . . . 6
5. SMIMECapabilities Attribute Conventions. . . . . . . . . . . . 8
6. Security Considerations. . . . . . . . . . . . . . . . . . . . 9
7. IANA Considerations. . . . . . . . . . . . . . . . . . . . . . 11
8. Intellectual Property Rights Statement . . . . . . . . . . . . 11
9. Acknowledgments. . . . . . . . . . . . . . . . . . . . . . . . 11
10. References . . . . . . . . . . . . . . . . . . . . . . . . . . 11
10.1. Normative References. . . . . . . . . . . . . . . . . . 11
10.2. Informative References. . . . . . . . . . . . . . . . . 12
Appendix A. ASN.1 Module . . . . . . . . . . . . . . . . . . . . . 14
Author's Address . . . . . . . . . . . . . . . . . . . . . . . . . 17
Full Copyright Statement . . . . . . . . . . . . . . . . . . . . . 18
Housley Standards Track [Page 1]
RFC 3560 RSAES-OAEP in CMS July 2003
1. Introduction
PKCS #1 Version 1.5 [PKCS#1v1.5] specifies a widely deployed variant
of the RSA key transport algorithm. PKCS #1 Version 1.5 key
transport is vulnerable to adaptive chosen ciphertext attacks,
especially when it is used to for key management in interactive
applications. This attack is often referred to as the "Million
Message Attack," and it explained in [RSALABS] and [CRYPTO98].
Exploitation of this vulnerability, which reveals the result of a
particular RSA decryption, requires access to an oracle which will
respond to hundreds of thousands of ciphertexts, which are
constructed adaptively in response to previously received replies
that provide information on the successes or failures of attempted
decryption operations.
The attack is significantly less feasible in store-and-forward
environments, such as S/MIME. RFC 3218 [MMA] discussed the
countermeasures to this attack that are available when PKCS #1
Version 1.5 key transport is used in conjunction with the
Cryptographic Message Syntax (CMS) [CMS].
When PKCS #1 Version 1.5 key transport is applied as an intermediate
encryption layer within an interactive request-response
communications environment, exploitation could be more feasible.
However, Secure Sockets Layer (SSL) [SSL] and Transport Layer
Security (TLS) [TLS] protocol implementations could include
countermeasures that detect and prevent the Million Message Attack
and other chosen-ciphertext attacks. These countermeasures are
performed within the protocol level.
In the interest of long-term security assurance, it is prudent to
adopt an improved cryptographic technique rather than embedding
countermeasures within protocols. To this end, an updated version of
PKCS #1 has been published. PKCS #1 Version 2.1 [PKCS#1v2.1]
supersedes RFC 2313. It preserves support for the PKCS #1 Version
1.5 encryption padding format, and it also defines a new one. To
resolve the adaptive chosen ciphertext vulnerability, the PKCS #1
Version 2.1 specifies and recommends use of Optimal Asymmetric
Encryption Padding (OAEP) for RSA key transport.
This document specifies the use of RSAES-OAEP key transport algorithm
in the CMS. The CMS can be used in either a store-and-forward or an
interactive request-response environment.
Housley Standards Track [Page 2]
RFC 3560 RSAES-OAEP in CMS July 2003
The CMS supports variety of architectures for certificate-based key
management, particularly the one defined by the PKIX working group
[PROFILE]. PKCS #1 Version 1.5 and PKCS #1 Version 2.1 require the
same RSA public key information. Thus, a certified RSA public key
may be used with either RSA key transport technique.
The CMS uses ASN.1 [X.208-88], the Basic Encoding Rules (BER)
[X.209-88], and the Distinguished Encoding Rules (DER) [X.509-88].
Throughout this document, when the terms "MUST", "MUST NOT",
"SHOULD", and "MAY" are used in capital letters, their use conforms
to the definitions in RFC 2119 [STDWORDS]. These key word
definitions help make the intent of standards documents as clear as
possible. These key words are used in this document to help
implementers achieve interoperability.
2. Enveloped-data Conventions
The CMS enveloped-data content type consists of an encrypted content
and wrapped content-encryption keys for one or more recipients. The
RSAES-OAEP key transport algorithm is used to wrap the
content-encryption key for one recipient.
Compliant software MUST meet the requirements for constructing an
enveloped-data content type stated in [CMS] Section 6,
"Enveloped-data Content Type".
A content-encryption key MUST be randomly generated for each instance
of an enveloped-data content type. The content-encryption key is
used to encipher the content.
2.1. EnvelopedData Fields
The enveloped-data content type is ASN.1 encoded using the
EnvelopedData syntax. The fields of the EnvelopedData syntax MUST be
populated as described in this section when RSAES-OAEP key transport
is employed for one or more recipients.
The EnvelopedData version MUST be 0, 2, or 3.
The EnvelopedData originatorInfo field is not used for the RSAES-OAEP
key transport algorithm. However, this field MAY be present to
support recipients using other key management algorithms.
The EnvelopedData recipientInfos CHOICE MUST be
KeyTransRecipientInfo. See section 2.2 for further discussion of
KeyTransRecipientInfo.
Housley Standards Track [Page 3]
RFC 3560 RSAES-OAEP in CMS July 2003
The EnvelopedData encryptedContentInfo contentEncryptionAlgorithm
field MUST be a symmetric encryption algorithm identifier.
The EnvelopedData unprotectedAttrs MAY be present.
2.2. KeyTransRecipientInfo Fields
The fields of the KeyTransRecipientInfo syntax MUST be populated as
described in this section when RSAES-OAEP key transport is employed
for one or more recipients.
The KeyTransRecipientInfo version MUST be 0 or 2. If the
RecipientIdentifier uses the issuerAndSerialNumber alternative, then
the version MUST be 0. If the RecipientIdentifier uses the
subjectKeyIdentifier alternative, then the version MUST be 2.
The KeyTransRecipientInfo RecipientIdentifier provides two
alternatives for specifying the recipient's certificate, and thereby
the recipient's public key. The recipient's certificate MUST contain
a RSA public key. The content-encryption key is encrypted with the
recipient's RSA public key. The issuerAndSerialNumber alternative
identifies the recipient's certificate by the issuer's distinguished
name and the certificate serial number; the subjectKeyIdentifier
identifies the recipient's certificate by the X.509
subjectKeyIdentifier extension value.
The KeyTransRecipientInfo keyEncryptionAlgorithm specifies use of the
RSAES-OAEP algorithm, and its associated parameters, to encrypt the
content-encryption key for the recipient. The key-encryption process
is described in [PKCS#1v2.1]. See section 3 of this document for the
algorithm identifier and the parameter syntax.
The KeyTransRecipientInfo encryptedKey is the result of encrypting
the content-encryption key in the recipient's RSA public key using
the RSAES-OAEP algorithm. The RSA public key MUST be at least 1024
bits in length. When using a Triple-DES [3DES] content-encryption
key, implementations MUST adjust the parity bits to ensure odd parity
for each octet of each DES key comprising the Triple-DES key prior to
RSAES-OAEP encryption.
3. RSAES-OAEP Algorithm Identifiers and Parameters
The RSAES-OAEP key transport algorithm is the RSA encryption scheme
defined in RFC 3447 [PKCS#1v2.1], where the message to be encrypted
is the content-encryption key. The algorithm identifier for
RSAES-OAEP is:
Housley Standards Track [Page 4]
RFC 3560 RSAES-OAEP in CMS July 2003
id-RSAES-OAEP OBJECT IDENTIFIER ::= { iso(1) member-body(2)
us(840) rsadsi(113549) pkcs(1) pkcs-1(1) 7 }
The AlgorithmIdentifier parameters field MUST be present, and the
parameters field MUST contain RSAES-OAEP-params. RSAES-OAEP-params
has the following syntax:
RSAES-OAEP-params ::= SEQUENCE {
hashFunc [0] AlgorithmIdentifier DEFAULT sha1Identifier,
maskGenFunc [1] AlgorithmIdentifier DEFAULT mgf1SHA1Identifier,
pSourceFunc [2] AlgorithmIdentifier DEFAULT
pSpecifiedEmptyIdentifier }
sha1Identifier AlgorithmIdentifier ::= { id-sha1, NULL }
mgf1SHA1Identifier AlgorithmIdentifier ::=
{ id-mgf1, sha1Identifier }
pSpecifiedEmptyIdentifier AlgorithmIdentifier ::=
{ id-pSpecified, nullOctetString }
nullOctetString OCTET STRING (SIZE (0)) ::= { ''H }
id-sha1 OBJECT IDENTIFIER ::= { iso(1)
identified-organization(3) oiw(14)
secsig(3) algorithms(2) 26 }
pkcs-1 OBJECT IDENTIFIER ::= { iso(1) member-body(2)
us(840) rsadsi(113549) pkcs(1) pkcs-1(1) }
id-mgf1 OBJECT IDENTIFIER ::= { pkcs-1 8 }
id-pSpecified OBJECT IDENTIFIER ::= { pkcs-1 9 }
The fields within RSAES-OAEP-params have the following meanings:
hashFunc identifies the one-way hash function. Implementations MUST
support SHA-1 [SHA1], and implementations MAY support other one-way
hash functions. The SHA-1 algorithm identifier is comprised of the
id-sha1 object identifier and a parameter of NULL. Implementations
that perform encryption MUST omit the hashFunc field when SHA-1 is
used, indicating that the default algorithm was used.
Implementations that perform decryption MUST recognize both the
id-sha1 object identifier and an absent hashFunc field as an
indication that SHA-1 was used.
Housley Standards Track [Page 5]
RFC 3560 RSAES-OAEP in CMS July 2003
maskGenFunc identifies the mask generation function. Implementations
MUST support MFG1 [PKCS#1v2.1]. MFG1 requires a one-way hash
function, and it is identified in the parameter field of the MFG1
algorithm identifier. Implementations MUST support SHA-1 [SHA1], and
implementations MAY support other one-way hash functions. The MFG1
algorithm identifier is comprised of the id-mgf1 object identifier
and a parameter that contains the algorithm identifier of the one-way
hash function employed with MFG1. The SHA-1 algorithm identifier is
comprised of the id-sha1 object identifier and a parameter of NULL.
Implementations that perform encryption MUST omit the maskGenFunc
field when MFG1 with SHA-1 is used, indicating that the default
algorithm was used. Implementations that perform decryption MUST
recognize both the id-mgf1 and id-sha1 object identifiers as well as
an absent maskGenFunc field as an indication that MFG1 with SHA-1 was
used.
pSourceFunc identifies the source (and possibly the value) of the
encoding parameters, commonly called P. Implementations MUST
represent P by the algorithm identifier, id-pSpecified, indicating
that P is explicitly provided as an OCTET STRING in the parameters.
The default value for P is an empty string. In this case, pHash in
EME-OAEP contains the hash of a zero length string. Implementations
MUST support a zero length P value. Implementations that perform
encryption MUST omit the pSourceFunc field when a zero length P value
is used, indicating that the default value was used. Implementations
that perform decryption MUST recognize both the id-pSpecified object
identifier and an absent pSourceFunc field as an indication that a
zero length P value was used.
4. Certificate Conventions
RFC 3280 [PROFILE] specifies the profile for using X.509 Certificates
in Internet applications. When a RSA public key will be used for
RSAES-OAEP key transport, the conventions specified in this section
augment RFC 3280.
Traditionally, the rsaEncryption object identifier is used to
identify RSA public keys. However, to implement all of the
recommendations described in the Security Considerations section of
this document (see section 6), the certificate user needs to be able
to determine the form of key transport that the RSA private key owner
associates with the public key.
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 RSAES-OAEP. In this case, the
Housley Standards Track [Page 6]
RFC 3560 RSAES-OAEP in CMS July 2003
rsaEncryption object identifier MUST be used in the algorithm field
within the subject public key information, and the parameters field
MUST contain NULL.
rsaEncryption OBJECT IDENTIFIER ::= { pkcs-1 1 }
Further discussion of the conventions associated with use of the
rsaEncryption object identifier can be found in RFC 3279 (see
[CERTALGS], section 2.3.1).
When the RSA private key owner wishes to limit the use of the public
key exclusively to RSAES-OAEP, then the id-RSAES-OAEP object
identifier MUST be used in the algorithm field within the subject
public key information, and the parameters field MUST contain
RSAES-OAEP-params. The id-RSAES-OAEP object identifier value and the
RSAES-OAEP-params syntax are fully described in section 3 of this
document.
Regardless of the object identifier used, the RSA public key is
encoded in the same manner in the subject public key information.
The RSA public key MUST be encoded using the type RSAPublicKey type:
RSAPublicKey ::= SEQUENCE {
modulus INTEGER, -- n
publicExponent INTEGER } -- e
Here, the modulus is the modulus n, and publicExponent is the public
exponent e. The DER encoded RSAPublicKey is carried in the
subjectPublicKey BIT STRING within the subject public key
information.
The intended application for the key MAY be indicated in the key
usage certificate extension (see [PROFILE], section 4.2.1.3). If the
keyUsage extension is present in a certificate that conveys an RSA
public key with the id-RSAES-OAEP object identifier, then the key
usage extension MUST contain a combination of the following values:
keyEncipherment; and
dataEncipherment.
However, both keyEncipherment and dataEncipherment SHOULD NOT be
present.
When a certificate that conveys an RSA public key with the
id-RSAES-OAEP object identifier, the certificate user MUST only use
the certified RSA public key for RSAES-OAEP operations, and the
certificate user MUST perform those operations using the parameters
identified in the certificate.
Housley Standards Track [Page 7]
RFC 3560 RSAES-OAEP in CMS July 2003
5. SMIMECapabilities Attribute Conventions
RFC 2633 [MSG], Section 2.5.2 defines the SMIMECapabilities signed
attribute (defined as a SEQUENCE of SMIMECapability SEQUENCEs) to be
used to specify a partial list of algorithms that the software
announcing the SMIMECapabilities can support. When constructing a
signedData object, compliant software MAY include the
SMIMECapabilities signed attribute announcing that it supports the
RSAES-OAEP algorithm.
When all of the default settings are selected, the SMIMECapability
SEQUENCE representing RSAES-OAEP MUST include the id-RSAES-OAEP
object identifier in the capabilityID field and MUST include an empty
SEQUENCE in the parameters field. In this case, RSAES-OAEP is
represented by the rSAES-OAEP-Default-Identifier:
rSAES-OAEP-Default-Identifier AlgorithmIdentifier ::=
{ id-RSAES-OAEP,
{ sha1Identifier,
mgf1SHA1Identifier,
pSpecifiedEmptyIdentifier } }
The SMIMECapability SEQUENCE representing rSAES-OAEP-Default-
Identifier MUST be DER-encoded as the following hexadecimal string:
30 0D 06 09 2A 86 48 86 F7 0D 01 01 07 30 00
When settings other than the defaults are selected, the
SMIMECapability SEQUENCE representing RSAES-OAEP MUST include the
id-RSAES-OAEP object identifier in the capabilityID field and MUST
include the RSAES-OAEP-params SEQUENCE that identifies the
non-default settings in the parameters field.
When SHA-256 is used in the hashFunc and SHA-256 is used with MGF1 in
the maskGenFunc, the SMIMECapability SEQUENCE representing RSAES-OAEP
is the rSAES-OAEP-SHA256-Identifier, as specified in Appendix A. The
SMIMECapability SEQUENCE representing rSAES-OAEP-SHA256-Identifier
MUST be DER-encoded as the following hexadecimal string:
30 38 06 09 2A 86 48 86 F7 0D 01 01 07 30 2B 30
0D 06 09 60 86 48 01 65 03 04 02 01 05 00 30 1A
06 09 2A 86 48 86 F7 0D 01 01 08 30 0D 06 09 60
86 48 01 65 03 04 02 01 05 00
When SHA-384 is used in the hashFunc and SHA-384 is used with MGF1 in
the maskGenFunc, the SMIMECapability SEQUENCE representing RSAES-OAEP
is the rSAES-OAEP-SHA384-Identifier, as specified in Appendix A. The
Housley Standards Track [Page 8]
RFC 3560 RSAES-OAEP in CMS July 2003
SMIMECapability SEQUENCE representing rSAES-OAEP-SHA384-Identifier
MUST be DER-encoded as the following hexadecimal string:
30 38 06 09 2A 86 48 86 F7 0D 01 01 07 30 2B 30
0D 06 09 60 86 48 01 65 03 04 02 02 05 00 30 1A
06 09 2A 86 48 86 F7 0D 01 01 08 30 0D 06 09 60
86 48 01 65 03 04 02 02 05 00
When SHA-512 is used in the hashFunc and SHA-512 is used with MGF1 in
the maskGenFunc, the SMIMECapability SEQUENCE representing RSAES-OAEP
is the rSAES-OAEP-SHA512-Identifier, as specified in Appendix A. The
SMIMECapability SEQUENCE representing rSAES-OAEP-SHA512-Identifier
MUST be DER-encoded as the following hexadecimal string:
30 38 06 09 2A 86 48 86 F7 0D 01 01 07 30 2B 30
0D 06 09 60 86 48 01 65 03 04 02 03 05 00 30 1A
06 09 2A 86 48 86 F7 0D 01 01 08 30 0D 06 09 60
86 48 01 65 03 04 02 03 05 00
6. Security Considerations
Implementations must protect the RSA private key and the
content-encryption key. Compromise of the RSA private key may result
in the disclosure of all messages protected with that key.
Compromise of the content-encryption key may result in disclosure of
the associated encrypted content.
The generation of RSA public/private key pairs relies on a random
numbers. The use of inadequate pseudo-random number generators
(PRNGs) to generate cryptographic keys can result in little or no
security. An attacker may find it much easier to reproduce the PRNG
environment that produced the keys, searching the resulting small set
of possibilities, rather than brute force searching the whole key
space. The generation of quality random numbers is difficult. RFC
1750 [RANDOM] offers important guidance in this area.
Generally, good cryptographic practice employs a given RSA key pair
in only one scheme. This practice avoids the risk that vulnerability
in one scheme may compromise the security of the other, and may be
essential to maintain provable security. While PKCS #1 Version 1.5
[PKCS#1v1.5] has been employed for both key transport and digital
signature without any known bad interactions, such a combined use of
an RSA key pair is not recommended in the future. Therefore, an RSA
key pair used for RSAES-OAEP key transport should not also be used
for other purposes. For similar reasons, one RSA key pair should
always be used with the same RSAES-OAEP parameters.
Housley Standards Track [Page 9]
RFC 3560 RSAES-OAEP in CMS July 2003
This specification requires implementation to support the SHA-1
one-way hash function for interoperability, but support for other
one-way hash function is permitted. At the time of this writing, the
best (known) collision attacks against SHA-1 are generic attacks with
complexity 2^80, where 80 is one-half the bit length of the hash
value. When a one-way hash function is used with a digital signature
scheme, a collision attack is easily translated into a signature
forgery. Therefore, the use of SHA-1 in a digital signature scheme
provides a security level of no more than 80 bits. If a greater
level of security is desired, then a secure one-way hash function
with a longer hash value is needed. SHA-256, SHA-384, and SHA-512
are likely candidates [SHA2].
The metrics for choosing a one-way hash function for use in digital
signatures do not directly apply to the RSAES-OAEP key transport
algorithm, since a collision attack on the one-way hash function does
not directly translate into an attack on the key transport algorithm,
unless the encoding parameters P varies (in which case a collision
the hash value for different encoding parameters might be exploited).
Nevertheless, for consistency with the practice for digital signature
schemes, and in case the encoding parameters P is not the empty
string, it is recommended that the same rule of thumb be applied to
selection of a one-way hash function for use with RSAES-OAEP. That
is, the one-way hash function should be selected so that the bit
length of the hash value is at least twice as long as the desired
security level in bits.
A 1024-bit RSA public key and SHA-1 both provide a security level of
about 80 bits. In [NISTGUIDE], the National Institute of Standards
and Technology suggests that a security level of 80 bits is adequate
for most applications until 2015. If a security level greater than
80 bits is needed, then a longer RSA public key and a secure one-way
hash function with a longer hash value are needed. Again, SHA-256,
SHA-384, and SHA-512 are likely candidates for such a one-way hash
function. For this reason, the algorithm identifiers for these
one-way hash functions are included in the ASN.1 module in Appendix
A.
The same one-way hash function should be employed for the hashFunc
and the maskGenFunc, but it is not required. Using the same one-way
hash function reduces the potential for implementation errors.
Housley Standards Track [Page 10]
RFC 3560 RSAES-OAEP in CMS July 2003
7. IANA Considerations
Within the CMS, algorithms are identified by object identifiers
(OIDs). All of the OIDs used in this document were assigned in
Public-Key Cryptography Standards (PKCS) documents or by the National
Institute of Standards and Technology (NIST). No further action by
the IANA is necessary for this document or any anticipated updates.
8. Intellectual Property Rights Statement
The IETF takes no position regarding the validity or scope of any
intellectual property or other rights that might be claimed to
pertain to the implementation or use of the technology described in
this document or the extent to which any license under such rights
might or might not be available; neither does it represent that it
has made any effort to identify any such rights. Information on the
IETF's procedures with respect to rights in standards-track and
standards-related documentation can be found in BCP-11. Copies of
claims of rights made available for publication and any assurances of
licenses to be made available, or the result of an attempt made to
obtain a general license or permission for the use of such
proprietary rights by implementors or users of this specification can
be obtained from the IETF Secretariat.
The IETF invites any interested party to bring to its attention any
copyrights, patents or patent applications, or other proprietary
rights which may cover technology that may be required to practice
this standard. Please address the information to the IETF Executive
Director.
9. Acknowledgments
This document is the result of contributions from many professionals.
I appreciate the hard work of all members of the IETF S/MIME Working
Group. Further, I extend a special thanks to Burt Kaliski, Jakob
Jonsson, Francois Rousseau, and Jim Schaad.
10. References
This section provides normative and informative references.
10.1. Normative References
[3DES] American National Standards Institute. ANSI X9.52-
1998, Triple Data Encryption Algorithm Modes of
Operation. 1998.
Housley Standards Track [Page 11]
RFC 3560 RSAES-OAEP in CMS July 2003
[CMS] Housley, R., "Cryptographic Message Syntax (CMS)", RFC
3369, August 2002.
[MSG] Ramsdell, B., "S/MIME Version 3 Message Specification",
RFC 2633, June 1999.
[PKCS#1v2.1] Jonsson, J. and B. Kaliski, "Public-Key Cryptography
Standards (PKCS) #1: RSA Cryptography Specifications,
Version 2.1", RFC 3447, February 2003.
[PROFILE] Housley, R., Polk, W., Ford, W. and D. Solo, "Internet
X.509 Public Key Infrastructure: Certificate and
Certificate Revocation List (CRL) Profile", RFC 3280,
April 2002.
[SHA1] National Institute of Standards and Technology. FIPS
Pub 180-1: "Secure Hash Standard." April 1995.
[STDWORDS] Bradner, S., "Key Words for Use in RFCs to Indicate
Requirement Levels", BCP 14, RFC 2119, March 1997.
[X.208-88] CCITT. Recommendation X.208: Specification of Abstract
Syntax Notation One (ASN.1). 1988.
[X.209-88] CCITT. Recommendation X.209: Specification of Basic
Encoding Rules for Abstract Syntax Notation One
(ASN.1). 1988.
[X.509-88] CCITT. Recommendation X.509: The Directory -
Authentication Framework. 1988.
10.2. Informative References
[CERTALGS] Bassham, L., Polk, W. and R. Housley, "Algorithms and
Identifiers for the Internet X.509 Public Key
Infrastructure Certificate and Certificate Revocation
List (CRL) Profile", RFC 3279, April 2002.
[CRYPTO98] Bleichenbacher, D. "Chosen Ciphertext Attacks Against
Protocols Based on the RSA Encryption Standard PKCS
#1", in H. Krawczyk (editor), Advances in Cryptology -
CRYPTO '98 Proceedings, Lecture Notes in Computer
Science 1462 (1998), Springer-Verlag, pp. 1-12.
[MMA] Rescorla, E., "Preventing the Million Message Attack on
Cryptographic Message Syntax", RFC 3218, January 2002.
Housley Standards Track [Page 12]
RFC 3560 RSAES-OAEP in CMS July 2003
[NISTGUIDE] National Institute of Standards and Technology. Second
Draft: "Key Management Guideline, Part 1: General
Guidance." June 2002.
[http://csrc.nist.gov/encryption/kms/guideline-1.pdf]
[PKCS#1v1.5] Kaliski, B., "PKCS #1: RSA Encryption, Version 1.5",
RFC 2313, March 1998.
[RANDOM] Eastlake, D., Crocker, S. and J. Schiller, "Randomness
Recommendations for Security", RFC 1750, December 1994.
[RSALABS] Bleichenbacher, D., B. Kaliski, and J. Staddon. Recent
Results on PKCS #1: RSA Encryption Standard. RSA
Laboratories' Bulletin No. 7, June 26, 1998.
[http://www.rsasecurity.com/rsalabs/bulletins]
[SHA2] National Institute of Standards and Technology. Draft
FIPS Pub 180-2: "Specifications for the Secure Hash
Standard." May 2001.
[http://csrc.nist.gov/encryption/shs/dfips-180-2.pdf]
[SSL] Freier, A., P. Karlton, and P. Kocher. The SSL
Protocol, Version 3.0. Netscape Communications.
November 1996.
[http://wp.netscape.com/eng/ssl3/draft302.txt]
[TLS] Dierks, T. and C. Allen, "The TLS Protocol Version
1.0", RFC 2246, January 1999.
Housley Standards Track [Page 13]
RFC 3560 RSAES-OAEP in CMS July 2003
Appendix A. ASN.1 Module
CMS-RSAES-OAEP
{ iso(1) member-body(2) us(840) rsadsi(113549) pkcs(1)
pkcs-9(9) smime(16) modules(0) cms-rsaes-oaep(20) }
DEFINITIONS IMPLICIT TAGS ::= BEGIN
-- EXPORTS ALL --
IMPORTS
AlgorithmIdentifier
FROM PKIX1Explicit88 -- RFC 3280
{ iso(1) identified-organization(3) dod(6) internet(1)
security(5) mechanisms(5) pkix(7) id-mod(0)
id-pkix1-explicit(18) };
pkcs-1 OBJECT IDENTIFIER ::= { iso(1) member-body(2) us(840)
rsadsi(113549) pkcs(1) pkcs-1(1) }
rsaEncryption OBJECT IDENTIFIER ::= { pkcs-1 1 }
id-RSAES-OAEP OBJECT IDENTIFIER ::= { pkcs-1 7 }
RSAES-OAEP-params ::= SEQUENCE {
hashFunc [0] AlgorithmIdentifier DEFAULT sha1Identifier,
maskGenFunc [1] AlgorithmIdentifier DEFAULT mgf1SHA1Identifier,
pSourceFunc [2] AlgorithmIdentifier DEFAULT
pSpecifiedEmptyIdentifier }
sha1Identifier AlgorithmIdentifier ::= { id-sha1, NULL }
sha256Identifier AlgorithmIdentifier ::= { id-sha256, NULL }
sha384Identifier AlgorithmIdentifier ::= { id-sha384, NULL }
sha512Identifier AlgorithmIdentifier ::= { id-sha512, NULL }
mgf1SHA1Identifier AlgorithmIdentifier ::=
{ id-mgf1, sha1Identifier }
mgf1SHA256Identifier AlgorithmIdentifier ::=
{ id-mgf1, sha256Identifier }
mgf1SHA384Identifier AlgorithmIdentifier ::=
{ id-mgf1, sha384Identifier }
Housley Standards Track [Page 14]
RFC 3560 RSAES-OAEP in CMS July 2003
mgf1SHA512Identifier AlgorithmIdentifier ::=
{ id-mgf1, sha512Identifier }
pSpecifiedEmptyIdentifier AlgorithmIdentifier ::=
{ id-pSpecified, nullOctetString }
nullOctetString OCTET STRING (SIZE (0)) ::= { ''H }
id-sha1 OBJECT IDENTIFIER ::= { iso(1)
identified-organization(3) oiw(14)
secsig(3) algorithms(2) 26 }
id-sha256 OBJECT IDENTIFIER ::= { joint-iso-itu-t(2)
country(16) us(840) organization(1) gov(101)
csor(3) nistalgorithm(4) hashalgs(2) 1 }
id-sha384 OBJECT IDENTIFIER ::= { joint-iso-itu-t(2)
country(16) us(840) organization(1) gov(101)
csor(3) nistalgorithm(4) hashalgs(2) 2 }
id-sha512 OBJECT IDENTIFIER ::= { joint-iso-itu-t(2)
country(16) us(840) organization(1) gov(101)
csor(3) nistalgorithm(4) hashalgs(2) 3 }
id-mgf1 OBJECT IDENTIFIER ::= { pkcs-1 8 }
id-pSpecified OBJECT IDENTIFIER ::= { pkcs-1 9 }
rSAES-OAEP-Default-Identifier AlgorithmIdentifier ::=
{ id-RSAES-OAEP,
{ sha1Identifier,
mgf1SHA1Identifier,
pSpecifiedEmptyIdentifier } }
rSAES-OAEP-SHA256-Identifier AlgorithmIdentifier ::=
{ id-RSAES-OAEP,
{ sha256Identifier,
mgf1SHA256Identifier,
pSpecifiedEmptyIdentifier } }
rSAES-OAEP-SHA384-Identifier AlgorithmIdentifier ::=
{ id-RSAES-OAEP,
{ sha384Identifier,
mgf1SHA384Identifier,
pSpecifiedEmptyIdentifier } }
rSAES-OAEP-SHA512-Identifier AlgorithmIdentifier ::=
{ id-RSAES-OAEP,
Housley Standards Track [Page 15]
RFC 3560 RSAES-OAEP in CMS July 2003
{ sha512Identifier,
mgf1SHA512Identifier,
pSpecifiedEmptyIdentifier } }
END
Housley Standards Track [Page 16]
RFC 3560 RSAES-OAEP in CMS July 2003
Author's Address
Russell Housley
Vigil Security, LLC
918 Spring Knoll Drive
Herndon, VA 20170
USA
EMail: housley@vigilsec.com
Housley Standards Track [Page 17]
RFC 3560 RSAES-OAEP in CMS July 2003
Full Copyright Statement
Copyright (C) The Internet Society (2003). All Rights Reserved.
This document and translations of it may be copied and furnished to
others, and derivative works that comment on or otherwise explain it
or assist in its implementation may be prepared, copied, published
and distributed, in whole or in part, without restriction of any
kind, provided that the above copyright notice and this paragraph are
included on all such copies and derivative works. However, this
document itself may not be modified in any way, such as by removing
the copyright notice or references to the Internet Society or other
Internet organizations, except as needed for the purpose of
developing Internet standards in which case the procedures for
copyrights defined in the Internet Standards process must be
followed, or as required to translate it into languages other than
English.
The limited permissions granted above are perpetual and will not be
revoked by the Internet Society or its successors or assignees.
This document and the information contained herein is provided on an
"AS IS" basis and THE INTERNET SOCIETY AND THE INTERNET ENGINEERING
TASK FORCE DISCLAIMS ALL WARRANTIES, EXPRESS OR IMPLIED, INCLUDING
BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE INFORMATION
HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED WARRANTIES OF
MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.
Acknowledgement
Funding for the RFC Editor function is currently provided by the
Internet Society.
Housley Standards Track [Page 18]