view Side-By-Side changes
Network Working Group J. Schaad Internet-Draft Soaring Hawk Consulting Expires:September 3, 2006May 22, 2008 M. Myers TraceRoute Security, Inc.March 2, 2006November 19, 2007 Certificate Management Messages over CMSdraft-ietf-pkix-2797-bis-04.txtdraft-ietf-pkix-2797-bis-05.txt Status of this Memo By submitting this Internet-Draft, each author represents that any applicable patent or other IPR claims of which he or she is aware have been or will be disclosed, and any of which he or she becomes aware will be disclosed, in accordance with Section 6 of BCP 79. Internet-Drafts are working documents of the Internet Engineering Task Force (IETF), its areas, and its working groups. Note that other groups may also distribute working documents as Internet- Drafts. Internet-Drafts are draft documents valid for a maximum of six months and may be updated, replaced, or obsoleted by other documents at any time. It is inappropriate to use Internet-Drafts as reference material or to cite them other than as "work in progress." The list of current Internet-Drafts can be accessed at http://www.ietf.org/ietf/1id-abstracts.txt. The list of Internet-Draft Shadow Directories can be accessed at http://www.ietf.org/shadow.html. This Internet-Draft will expire onSeptember 3, 2006.May 22, 2008. Copyright Notice Copyright (C) TheInternet Society (2006).IETF Trust (2007). Schaad & Myers Expires May 22, 2008 [Page 1] Internet-Draft CMC: Structures November 2007 Abstract This document defines the base syntax for CMC, a Certificate Management protocol usingCMS (Cryptographicthe Cryptographic MessageSyntax).Syntax (CMS). This protocol addresses two immediate needs within the InternetPKIPublic Key Infrastructure (PKI) community: 1. The need for an interface to public key certification products and services based on CMS and PKCS #10 (Public KeyCrytpography Schaad & Myers Expires September 3, 2006 [Page 1] Internet-Draft CMS: Structures March 2006Cryptography Standard), and 2. The needin S/MIME (Secure MIME)for acertificatePKI enrollment protocol forDSA-signed certificates with Diffie-Hellman public keys.encryption only keys due to algorithm or hardware design. CMC also requires the use of the transport document and the requirements usage document along with this document for a full definition. Schaad & Myers Expires May 22, 2008 [Page 2] Internet-Draft CMC: Structures November 2007 Table of Contents 1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . .45 1.1. Protocol Requirements . . . . . . . . . . . . . . . . . .45 1.2.NotationRequirements Terminology . . . . . . . . . . . . . . . . . 6 1.3. Changes since RFC 2797 . . . . . . . . .5. . . . . . . . . 6 2. Protocol Overview . . . . . . . . . . . . . . . . . . . . . .67 2.1. Terminology . . . . . . . . . . . . . . . . . . . . . . .78 2.2. ProtocolFlow ChartsRequest/Responses . . . . . . . . . . . . . . . . 9 3. PKI Requests . . .8 3. Protocol Elements. . . . . . . . . . . . . . . . . . . . . .1012 3.1.PKIData Object . .Simple PKI Request . . . . . . . . . . . . . . . . . . . .1012 3.2.ResponseBody ObjectFull PKI Request . . . . . . . . . . . . . . . . . . .11 3.3. Certification Requests (PKCS10/CRMF). . 13 3.2.1. PKIData content type . . . . . . . . . .12 3.3.1. PKCS10 Request Body. . . . . . . 14 3.2.1.1. Control Syntax . . . . . . . . . .12 3.3.2. CRMF Request Body. . . . . . . . 16 3.2.1.2. Certification Request Formats . . . . . . . . . .13 3.3.3. Production of Diffie-Hellman Public Key16 3.2.1.2.1. PKCS #10 CertificationRequests .Syntax . . . . . . . . 17 3.2.1.2.2. CRMF Certification Syntax . . . . . . .14 3.4. Body Part Identifiers. . . 18 3.2.1.2.3. Other Certification Request . . . . . . . . . 19 3.2.1.3. Content Info Objects . . . . . .15 3.5. Control Attributes. . . . . . . . . 20 3.2.1.3.1. Authenticated Data . . . . . . . . . . .15 3.6. Content Info objects. . . 20 3.2.1.3.2. Data . . . . . . . . . . . . . . . .16 3.6.1. Signed Data. . . . . 21 3.2.1.3.3. Enveloped Data . . . . . . . . . . . . . . . .17 3.6.2. Enveloped21 3.2.1.3.4. Signed Data . . . . . . . . . . . . . . . . .. . . 17 3.6.3. Authenticated Data .21 3.2.1.4. Other Message Bodies . . . . . . . . . . . . . . . 22 3.2.2. Body Part Identification . .17 3.7. Other Message Bodies. . . . . . . . . . . . . 22 3.2.3. CMC Unsigned Data Attribute . . . . . .18 3.8. Unsigned Attributes. . . . . . . 23 4. PKI Responses . . . . . . . . . . . .18 4. PKI Messages. . . . . . . . . . . . 25 4.1. Simple PKI Response . . . . . . . . . . . . .20 4.1. Simple Enrollment Request. . . . . . 25 4.2. Full PKI Response . . . . . . . . . .20 4.2. Full PKI Request. . . . . . . . . . 25 4.2.1. PKIResponse Content Type . . . . . . . . . . .20 4.3. Simple Enrollment Response. . . . 26 5. Application of Encryption to a PKI Request/Response . . . . . 28 6. Controls . . . . . . .21 4.4. Full PKI Response. . . . . . . . . . . . . . . . . . . .22 4.5. Application of Encryption to a PKI Message . . . . . . . . 22 5. Control Attributes . . . . .29 6.1. CMC Status Info Controls . . . . . . . . . . . . . . . . .24 5.1.31 6.1.1. Extended CMC Status Info ControlAttributes. . . . . . . . . . .. 24 5.1.1. Extended31 6.1.2. CMC Status Info ControlAttribute .. . . . .25 5.1.2. CMC Status Info Control Attribute. . . . . . . . . .26 5.1.3.33 6.1.3. CMCStatus values . . . . . . . . . . . . . . . . . . .27 5.1.4.34 6.1.4. CMCFailInfo . . . . . . . . . . . . . . . . . . . . .27 5.2.35 6.2. Identification andIdentityProof Control Attributes . .Identity Proof Controls .28 Schaad & Myers Expires September 3, 2006 [Page 2] Internet-Draft CMS: Structures March 2006 5.2.1. Hardware Shared Secret Token Generation. . . . . . .30 5.3. Linking36 6.2.1. Identityand POP Information . . . . .Proof Version 2 Control . . . . . .30 5.3.1. Witness values derived from the shared-secret. . . .30 5.3.2. Shared-secret/subject DN matching. 37 6.2.2. Identity Proof Control . . . . . . . . .31 5.3.3. Renewal and Re-Key Messages. . . . . . . 38 6.2.3. Identification Control . . . . . .32 5.4. Data Return Control Attribute. . . . . . . . . . 39 6.2.4. Hardware Shared-Secret Token Generation . . . .32 5.5. RA Certificate Modification Controls. . . 39 6.3. Linking Identity and POP Information . . . . . . . .33 5.5.1. Modify Certificate Request Control. . . 40 6.3.1. Cryptographic Linkage . . . . . . .33 5.5.2. Add Extensions Control. . . . . . . . . 40 6.3.1.1. POP Link Witness Version 2 Controls . . . . . . .34 5.6. Transaction Management40 6.3.1.2. POP Link Witness ControlAttributes. . . . . . . .36 5.7. Proof-of-possession (POP) for encryption-only keys. . . .36 5.8. LRA. 42 6.3.1.3. POPWitnessesLink Random ControlAttribute. . . . . . . . . . .40 5.9. Get Certificate Control Attribute. . 42 6.3.2. Shared-secret/subject DN linking . . . . . . . . . .40 5.10. Get CRL Control Attribute. 42 Schaad & Myers Expires May 22, 2008 [Page 3] Internet-Draft CMC: Structures November 2007 6.3.3. Renewal and Re-Key Messages . . . . . . . . . . . . . 43 6.4. Data Return Control . .41 5.11. Revocation Request Control Attribute. . . . . . . . . . .42 5.12. Registration and Response Information Control Attributes. . . . . . 43 6.5. RA Certificate Modification Controls . . . . . . . . . . . 44 6.5.1. Modify Certificate Request Control . . . . . . .43 5.13. Query Pending Control Attribute. . . 44 6.5.2. Add Extensions Control . . . . . . . . . .43 5.14. Confirm Certificate Acceptance. . . . . . 46 6.6. Transaction Identifier, Sender and Recipient Nonce Controls . . . . . . . .44 5.15. Publish Trust Roots. . . . . . . . . . . . . . . . . 47 6.7. Encrypted and Decrypted POP Controls . .45 5.16. Provide Autenticated Data. . . . . . . . . 48 6.8. RA POP Witness Control . . . . . . .46 5.17. Batch Process Identification. . . . . . . . . . . 51 6.9. Get Certificate Control . . . .46 5.18. Publication Information Control. . . . . . . . . . . . .46 5.19.52 6.10. Get CRL ControlProcessed. . . . . . . . . . . . . . . . . . . .47 6. Local. 53 6.11. Revocation Request Control . . . . . . . . . . . . . . . . 54 6.12. Registration and Response Information Controls . . . . . . 55 6.13. Query Pending Control . . . . . . . . . . . . . . . . . . 56 6.14. Confirm Certificate Acceptance Control . . . . . . . . . . 56 6.15. Publish Trust Anchors Control . . . . . . . . . . . . . . 57 6.16. Authenticated Data Control . . . . . . . . . . . . . . . . 58 6.17. Batch Request and Response Controls . . . . . . . . . . . 59 6.18. Publication Information Control . . . . . . . . . . . . . 60 6.19. Control Processed Control . . . . . . . . . . . . . . . . 61 7. Registration Authorities . . . . . . . . . . . . . . . .48 6.1.. . . 63 7.1. Encryption Removal . . . . . . . . . . . . . . . . . . . .49 6.2.64 7.2. Signature Layer Removal . . . . . . . . . . . . . . . . .49 7.64 8. Security Considerations . . . . . . . . . . . . . . . . . . .50 8.65 9. IANA Considerations . . . . . . . . . . . . . . . . . . . . .52 9.67 10. Acknowledgments . . . . . . . . . . . . . . . . . . . . . . .53 10.68 11. References . . . . . . . . . . . . . . . . . . . . . . . . . .54 10.1.69 11.1. Normative References . . . . . . . . . . . . . . . . . . .54 10.2.69 11.2. Informational References . . . . . . . . . . . . . . . . .5469 Appendix A. ASN.1 Module . . . . . . . . . . . . . . . . . . . .5671 Appendix B. Enrollment Message Flows . . . . . . . . . . . . . .6479 Appendix B.1. Request of a Signing Certificate . . . . . . . . . .6479 Appendix B.2. SingleCertificateCertification Request, But Modified by RA . .. 6580 Appendix B.3. Indirect POP for an RSA certificate . . . . . . . .6883 Appendix C. Production of Diffie-Hellman Public Key Certification Requests . . . . . . . . . . . . . . . 88 Appendix C.1. No-Signature Signature Mechanism . . . . . . . . . . 88 Appendix D. Change History . . . . . . . . . . . . . . . . . . .7389 Authors' Addresses . . . . . . . . . . . . . . . . . . . . . . . .7491 Intellectual Property and Copyright Statements . . . . . . . . . .7592 Schaad & Myers ExpiresSeptember 3, 2006May 22, 2008 [Page3]4] Internet-DraftCMS:CMC: StructuresMarch 2006November 2007 1. Introduction This document defines the base syntax for CMC, a Certificate Management protocol usingCMS (Cryptographicthe Cryptographic MessageSyntax).Syntax (CMS). This protocol addresses two immediate needs within the Internet PKI community: 1. The need for an interface to public key certification products and services based on CMS andthePKCS#10 (Public Key Cryptography Standard),#10, and 2. The needin S/MIME (Secure MIME)for acertificatePKI enrollment protocol forDSA-signed certificates with Diffie-Hellman public keys. A small number ofencryption only keys due to algorithm or hardware design. A small number of additional services are defined to supplement the corecertificatecertification request service.Throughout this specification the term CMS is used to refer to both [CMS] and [PKCS7]. For both signedData and envelopedData, CMS is a superset of the PKCS7. In general, the use of PKCS7 in this document is aligned to the Cryptographic Message Syntax [CMS] that provides a superset of the PKCS7 syntax. The term CMC refers to this specification.1.1. Protocol RequirementsoThe protocolis tomust be based as much as possible on the existing CMS,PKCS#10PKCS #10 [PKCS10] and CRMF (Certificate Request Message Format) [CRMF] specifications.oThe protocol must support the current industry practice of aPKCS#10PKCS #10 certification request followed by a PKCS#7 "certs-only" response as a subset of the protocol.oThe protocolneeds tomust easily support the multi-key enrollment protocols required by S/MIME and other groups.oThe protocol must supply a way of doing all enrollment operations in a single-round trip. When this is not possible the number of round trips is to be minimized.oThe protocolwillmust be designed such that all key generation can occur on the client.o The mandatory algorithmsSupport mustsupersetexist for therequiredmandatory algorithmsforused by S/MIME.Schaad & Myers Expires September 3, 2006 [Page 4] Internet-Draft CMS: Structures March 2006 oSupport should exist for all other algorithms cited by the S/MIME core documents. The protocolwillmust containPOPProof-of-Possession (POP) methods. Optional provisions for multiple-round trip POP will be made if necessary.oThe protocolwillmust support deferred and pending responses tocertificate requestenrollment requests for cases where external procedures are required to issue a certificate.oSchaad & Myers Expires May 22, 2008 [Page 5] Internet-Draft CMC: Structures November 2007 The protocolneeds tomust support arbitrary chains oflocal registration authoritiesRegistration Authorities (RAs) as intermediaries betweencertificatecertification requesters andissuers.Certification Authorities (CAs). 1.2.NotationRequirements 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].Schaad & Myers Expires September 3, 2006 [Page 5] Internet-Draft CMS: Structures March 2006 2. Protocol Overview An enrollment transaction in this specification is generally composed of1.3. Changes since RFC 2797 We have done asingle round tripmajor overhaul on the layout ofmessages. Inthesimplest case an enrollment request is sentdocument. This included two different steps. Firstly we removed some sections from theclient to the serverdocument andan enrollment response is then returned from the servermoved them tothe client. In some more complicated cases, such as delayed certificate issuance and polling for responses, more than one round trip is required. This specification supportstwodifferent requestother documents. Information on how to transport our messagesand two different response messages. Public key certification requestsare now found in [CMC-TRANS]. Information on which controls and sections of this document must be implemented along with which algorithms are required can now bebased onfound in [CMC-MUST]. A number of new controls have been added in this version: Extended CMC Status Info Section 6.1.1 Publish Trust Anchors Section 6.15 Authenticate Data Section 6.16 Batch Request and Response Processing Section 6.17 Publication Information Section 6.18 Modify Certificate Request Section 6.5.1 Control Processed Section 6.19 Identity Proof Section 6.2.2 Identity POP Link Witness V2 Section 6.3.1.1 Schaad & Myers Expires May 22, 2008 [Page 6] Internet-Draft CMC: Structures November 2007 2. Protocol Overview A PKI enrollment transaction in this specification is generally composed of a single round trip of messages. In the simplest case a PKI enrollment request, henceforth referred to as a PKI Request, is sent from the client to the server and a PKI enrollment response, henceforth referred to as a PKI Responses, is then returned from the server to the client. In more complicated cases, such as delayed certificate issuance, more than one round trip is required. This specification defines two PKI Request types and two PKI Response types. PKI Requests are formed using either thePKCS10PKCS #10 or CRMFobject.structure. The twodifferent request messages are (a)PKI Requests are: Simple PKI Request: the barePKCS10PKCS #10 (in the event that no other services are needed), and(b) the PKCS10Full PKI Request: one or more PKCS #10, CRMFmessageor Other Request Messages structures wrapped in a CMS encapsulation as part of aPKIData object. Public key certification responsesPKIData. PKI Responses are based onthe CMS signedData object.SignedData [CMS]. Theresponse may be either (a)two PKI Responses are Simple PKI Response: adegenerate CMS signedData object"certs-only" SignedData (in the event no other services are needed), or(b)Full PKI Response aResponseBody objectPKIResponse content-type wrapped in aCMS signedData object.SignedData. No special services are provided fordoingeither renewal(new certificates(i.e., a new certificate with the same key) orre-keying (new certificates onre-key (i.e., a new certificate with a newkeys)key) ofclients.client certificates. Insteada renewal/re-key message looks the same as any enrollment message, withrenewal and re-key requests look the same as any certification request, except that the identity proofbeingis supplied by existing certificates fromthea trusted CA. (This is usually the same CA, but could be a different CA in the same organization where naming is shared.) No special services are provided to distinguish betweendoingare- keying operationre-key request andobtaininga newcertificatecertification request (generally for a new purpose). A control to unpublish a certificate would normally be included in areplacement operation,re-key request, and be omittedifin a newcertificate was desired.certification request. CAs or other publishing agents are also expected to have policies for removing certificates from publication either based on new certificates being added or the expiration or revocation of a certificate. Schaad & Myers Expires May 22, 2008 [Page 7] Internet-Draft CMC: Structures November 2007 A provision exists forLocal Registration Authorities (LRAs)RAs to participate in the protocol by takingclient enrollment messages,PKI Requests, wrapping them in a second layer ofenrollment messagePKI Request with additional requirements or statements from theLRARA and then passing this new expandedrequestPKI Request on to theCertification Authority.CA. This specification makes no assumptions about the underlying transport mechanism. The use of CMSisdoes notmeant toimply anemail- basedemail-based transport.Schaad & Myers Expires September 3, 2006 [Page 6] Internet-Draft CMS: Structures March 2006Several different possible transport methods are defined in [CMC-TRANS]. Optional services available through this specification are transaction management, replay detection (through nonces), deferred certificate issuance, certificate revocation requests andcertificate/CRLcertificate/certificate revocation list (CRL) retrieval. 2.1. Terminology There are several different terms, abbreviations and acronyms used in thisdocument that we definedocument. These are defined here for convenience and consistency ofusage:usage in no particular order: End-Entity (EE) refers to the entity that owns a key pair and for whom a certificate is issued.LRARegistration Authority (RA) or"RA"Local RA (LRA) refers toa (Local) Registration Authority. A registration authorityan entity that acts as an intermediary betweenan End- Entitythe EE anda Certification Authority.the CA. Multiple RAs can exist between the End-Entity and the Certification Authority.CA refers to a Certification Authority. ARAs may perform additional services such as key generation or key archival. This document uses the term RA for both RA and LRA. Certification Authorityis(CA) refers to the entity thatperforms the actual issuance of a certificate.issues certificates. Client refers to an entity that creates a PKIrequest.Request. In this document both RAs andEnd-EntitiesEEs can be clients. Server refers to the entities that process PKIrequestsRequests and create PKIresponses.Responses. In this document both CAs and RAs can beservers in this document. PKCS#10servers. PKCS #10 refers to the Public Key Cryptography Standard#10. This is one of a set of standards defined by RSA Laboratories in the 1980s. PKCS#10#10 [PKCS10], which defines aCertificate Request Messagecertification request syntax. CRMF refers to the Certificate Request Message Format RFC [CRMF].We are using certificateCMC uses this certification requestmessage formatsyntax defined in this document as part ofour managementthe protocol. Schaad & Myers Expires May 22, 2008 [Page 8] Internet-Draft CMC: Structures November 2007 CMS refers to the Cryptographic Message Syntax RFC [CMS]. This document provides for basic cryptographic services including encryption and signing with and without key management.POP is an acronym for "Proof of Possession". POPPKI Request/Response refers toa value that can be used to prove thattheprivate key correspondingrequests/responses described in this document. PKI Requests include certification requests, revocation requests, etc. PKI Responses include certs-only messages, failure messages, etc. Proof-Of-Identity refers to the client proving they are who they say that are to the server. Enrollment or certification request refers to the process of a client requesting a certificate. A certification request is a subset of the PKI Requests. Proof-Of-Possession (POP) refers to a value that can be used to prove that the private key corresponding to a public key is in the possession and can be used by an end-entity.Transport wrapper refers to the outermost CMS wrapping layer. Schaad & Myers Expires September 3, 2006 [Page 7] Internet-Draft CMS: Structures March 2006Object IDentifier (OID) is a primitive type in Abstract Syntax Notation One (ASN.1). 2.2. ProtocolFlow ChartsRequest/Responses Figure 1 shows the SimpleEnrollment RequestPKI Requests andResponse messages.Responses. The contents ofthese messagesSimple PKI Request and Response are detailed inSections 4.1Section 3.1 and4.3 below.Section 4.1. Schaad & Myers Expires May 22, 2008 [Page 9] Internet-Draft CMC: Structures November 2007 Simple PKI Request Simple PKI Response ------------------------- -------------------------- +----------+ +------------------+ | PKCS #10 | | CMS"certs-only"ContentInfo | +----------+--------------+| message | | |+------------------+------+ |CertificateCertification Request | | CMS Signed Data, | | | |CMS Signed Data,no SignerInfo | | Subject Name | |no signerInfo || Subject Public Key Info | || | (K_PUB) | | signedDataSignedData contains one | |Attributes(K_PUB) | | or more certificates in | | Attributes | | the"certificates"certificates field | | | | Relevant CA certs and | +-----------+-------------+ |portion of theCRLs can be included | | signed with | |signedData.as well. | | matching | | | | K_PRIV | | encapsulatedContentInfo | +-------------+ | isempty. | |absent. | +--------------+----------+ | unsigned | +----------+ Figure 1: Simple PKI Requests and Responses Figure 2 shows the Full PKI Requests and Responses. The contents of the Full PKI Request andResponse MessagesResponses are detailed in Section 3.2 and Section 4.2. Schaad & Myers ExpiresSeptember 3, 2006May 22, 2008 [Page8]10] Internet-DraftCMS:CMC: StructuresMarch 2006November 2007 Full PKI Request Full PKI Response ----------------------- ------------------------ +----------------+ +----------------+ | CMSsignedDataContentInfo| | CMS ContentInfo| | CMS SignedData | | CMSsignedDataSignedData | | object | | object | +----------------+--------+ +----------------+--------+ | | | | | PKIDataobject| |ResponseBody objectPKIResponseBody | | | | | | Sequence of: | | Sequence of: | | <enrollmentattribute>*control>* | | <enrollmentattribute>*control>* | | <certification request>*| | <CMS object>* | | <CMSobjects>*object>* | | <other message>* | | <other message>* | | | | | | where * == zero or more | | where * == zero or more | | | | | | All certificates issued | |CertificateCertification requests | | as part of the response | | areCRMFCRMF, PKCS #10, orPKCS#10| | are included in the | |objects. Attributes areOther. | | "certificates"portionfield | |(OID, ANY defined by| | of thesignedData. | | OID) pairs.SignedData. | +-------+-----------------+ | Relevant CA certs and | | signed (keypair | | CRLs can be included as |+-------+-----------------+| used may be pre-| | well. | |signed (keypairexisting or | | | |used may be pre-|identified in | +---------+---------------+ |existing orthe request) | | signed by the || identified in |+-----------------+ | CA or an LRA || the request) |+---------------++-----------------+Figure 2: Full PKIRequest and Response Messages Figure 2 shows the Full Enrollment Request and Response messages. The contents of these messages are detailed in Sections 4.2Requests and4.4 below.Responses Schaad & Myers ExpiresSeptember 3, 2006May 22, 2008 [Page9]11] Internet-DraftCMS:CMC: StructuresMarch 2006November 2007 3.Protocol ElementsPKI Requests Two types of PKI Requests exist. This sectioncovers each ofgives thedifferent elements that maydetails for both types. 3.1. Simple PKI Request A Simple PKI Request uses the PKCS #10 syntax CertificationRequest [PKCS10]. When a server processes a Simple PKI Request, the PKI Response returned is: Simple PKI Response on success. Full PKI Response on failure. The server MAY choose not to return a PKI Response in this case. The Simple PKI Request MUST NOT be used if a proof-of-identity needs toconstruct enrollment request and enrollment response messages. Section 4 will cover how to build the enrollment request and response messages. 3.1. PKIData Objectbe included. Thenew content object PKIData has been defined for this protocol. This new object isSimple PKI Request cannot be usedasif thebodyprivate key is not capable of producing some type of signature (i.e. DH keys can use the signature algorithms in [DH-POP] for production of thefullsignature). The Simple PKI Request cannot be used for any of the advanced services specified in this document. The client MAY incorporate one or more X.509v3 extensions in any certification requestmessage.based on PKCS #10 as an ExtensionReq control. Thenew bodyExtensionReq control is defined as: ExtensionReq ::= SEQUENCE SIZE (1..MAX) OF Extension where Extension is imported from [PKIXCERT] and ExtensionReq is identified by:id-cct-PKIDataid-ExtensionReq OBJECT IDENTIFIER ::={id-pkix id-cct(12) 2 } The ASN.1 structure corresponding{iso(1) member-body(2) us(840) rsadsi(113549) pkcs(1) pkcs-9(9) 14} Servers MUST be able tothis new content type is: PKIData ::= SEQUENCE { controlSequence SEQUENCE SIZE(0..MAX) OF TaggedAttribute, reqSequence SEQUENCE SIZE(0..MAX) OF TaggedRequest, cmsSequence SEQUENCE SIZE(0..MAX) OF TaggedContentInfo, otherMsgSequence SEQUENCE SIZE(0..MAX) OF OtherMsg } controlSequence consists of a sequence of control attributes. The control attributes definedprocess all extensions defined, but not prohibited, in [PKIXCERT]. Servers are not required to be able to process other X.509v3 extensions transmitted using thisdocumentprotocol, nor arefound in section 5. As control sequencesthey required to be able to process private extensions. Servers aredefined by OIDs, other parties can define additional control attributes. Unrecognized OIDsnot required to put all client-requested extensions into a certificate. Servers are permitted to modify client-requested extensions. Servers MUSTresult in no part ofNOT alter an extension so as to invalidate Schaad & Myers Expires May 22, 2008 [Page 12] Internet-Draft CMC: Structures November 2007 therequest being successfully processed. reqSequence consists of a sequenceoriginal intent ofrequests. The requests can beaCertificateRequest (PKCS10 request),client-requested extension. (For example, changing key usage from keyAgreement to digitalSignature.) If aCertReqMsg or an externally definedcertification request(orm). Details onis denied due to thefirst two request types are found in sections 3.3.1inability to handle a requested extension and3.3.2 respectively. If an externally defined request messagea PKI Response ispresent, butreturned, the serverdoes not understandMUST return a PKI Response with a CMCFailInfo value with therequest (or will not process it),value unsupportedExt. 3.2. Full PKI Request The Full PKI Request provides the most functionality and flexibility. The Full PKI Request is encapsulated in either aCMCStatusSignedData or an AuthenticatedData with an encapsulated content type ofnoSupportid-cct-PKIData (Section 3.2.1). When a server process a Full PKI Request, a PKI Response MUST be returned. The PKI Response returnedfor the request item and no requests processed. cmsSequence consists of a sequence of [CMS] message objects. This protocol uses EnvelopedData, SignedData, EncryptedData and AuthenticatedData. See section 3.6 for more details. otherMsgSequence allows for other arbitrary data items to be placed intois: Simple PKI Response if the enrollmentprotocol. The {OID, any} pair of values allows for arbitrary definition of material. Data objectswas successful and only certificates areplaced here whilereturned. (A CMCStatusInfoV2 controlobjects are placed in the controlSequence field. See section 3.7 for more details. Schaad & Myers Expires September 3, 2006 [Page 10] Internet-Draft CMS: Structures March 2006 Processing of this object by a recipientwith success isas follows: 1. All control attributes should be examinedimplied.) Full PKI Response if the enrollment was successful andprocessedinformation is returned inan appropriate manner. The appropriate processing may be eitheraddition todo complete processing at this time, ignorecertificates, if thecontrol attributeenrollment is pending, orto placeif thecontrol attribute on a to-do list for later processing. 2. An implicit control attributeenrollment failed. If SignedData isthen processed for each item inused, thereqSequence. Again this maysignature can be generated using eitherimmediate processingthe private key material of an embedded signature certification request (i.e., included in the TaggedRequest tcr oraddition to a to-do list for later processing. No processing is required for cmsSequencecrm fields), orotherMsgSequence membersa previously certified signature key. If the private key of a signature certification request used, then: a. The certification request containing theelement. If items are present and are not referenced bycorresponding public key MUST include acontrol sequence, they are to be ignored. 3.2. ResponseBody ObjectSubject Key Identifier extension. b. Thenew content object ResponseBody has been defined for this protocol. This new object is used as the bodysubjectKeyIdentifier form of thefull PKI response message. The new body is identified by: id-cct-PKIResponse ::= {id-pkix id-cct(12) 3 }signerIdentifier in SignerInfo MUST be used. c. TheASN.1 structure corresponding to this body content type is: ResponseBody ::= SEQUENCE { controlSequence SEQUENCE SIZE(0..MAX) OF TaggedAttribute, cmsSequence SEQUENCE SIZE(0..MAX) OF TaggedContentInfo, otherMsgSequence SEQUENCE SIZE(0..MAX) OF OtherMsg } controlSequence consistsvalue ofa sequencethe subjectKeyIdentifier form ofcontrol attributes. The control attributes defined in this document are foundSignerInfo MUST be the Subject Key Identifier specified insection 3.5. Other parties can define additional control attributes. cmsSequence consists of a sequencethe corresponding certification request. (The subjectKeyIdentifier form of[CMS] message objects. This protocol only uses EnvelopedData, SignedData, EncryptedData and AuthenticatedData. See section 3.6 for more details. otherMsgSequence allowsSignerInfo is used here because no certificates have yet been issued forother arbitrary items to be placed intotheenrollment protocol. The {OID, any} pair of values allowssigning key.) If the request key is used forarbitrary definition of material. Data objects are placed here while control objects are placedsigning, there MUST be only one SignerInfo in thecontrolSequence field. See section 3.7 for more details. Processing of this object by a recipientSignedData. If AuthenticatedData isas follows:used, then: Schaad & Myers ExpiresSeptember 3, 2006May 22, 2008 [Page11]13] Internet-DraftCMS:CMC: StructuresMarch 2006 1. All control attributes should be examined and processed in an appropriate manner.November 2007 a. Theappropriate processing mayPassword Recipient Info option of RecipientInfo MUST beeither to do complete processing at this time, ignore the control attribute orused. b. A randomly generated key is used toplacecompute thecontrol attributeMAC value ona to-do listthe encapsulated content. c. The input forlater processing. 2. Additional processing of non-element items includesthesaving of certificates and CRLs present in wrapping layers. This type of processingkey derivation algorithm isbased on the consumera concatenation of theelementidentifier (encoded as UTF8) andshould not be relied on by generators. No processing is required for cmsSequence or otherMsgSequence members oftheelement. If items are present and are not referenced byshared-secret. When creating acontrol sequence, they arePKI Request tobe ignored. 3.3. Certification Requests (PKCS10/CRMF) Certification Requests are based on either PKCS10renew orCRMF messages. Section 3.3.1 specifies mandatory and optional requirements for clients and servers dealing with PKCS10 request messages. Section 3.3.2 specifies mandatory and optional requirements for clientsrekey a certificate: a. The Identification andservers dealing with CRMF request messages. AllIdentity Proof controls are absent. The same information is provided by the use of an existing certificaterequests directly encoded intofrom asingle PKIData object SHOULD be forCA when signing thesame identity. RAsPKI Request. In this case the CA thatbatch processing are expected to placeissued thesigned PKIData sequences received intooriginal certificate and thecmsSequence ofCA thePKIData object it generates. 3.3.1. PKCS10 Request Body Servers MUST be able to understand and process PKCS10 request bodies. Clients MUST produce a PKCS10requestbody when usingis made to will usually be theSimple Enrollment Request message. Clients MAY producesame, but could have aPKCS10 request body when usingcommon operator. b. CAs and RAs can impose additional restrictions on theFull Enrollment Request message. When producingsigning certificate used. They may require that the most recently issued signing certificate for aPKCS10 request body, clientsclient be used. c. Some CAs may prevent renewal operations (i.e., reuse of the same keys). In this case the CA MUSTproducereturn aPKCS10 message body containing a subject name and public key. Some certification products are operated using a central repository of information to assign subject names upon receipt of a public keyPKI Response with noKeyReuse as the CMCFailInfo failure code. 3.2.1. PKIData content type The PKIData content type is used forcertification. To accommodate this mode of operation,thesubject name in a CertificationRequest MAY be NULL, but MUST be present. CAs that receive a CertificationRequest with a NULL subject name MAY reject such requests. If rejected and a responseFull PKI Request. A PKIData content type isreturned,identified by: id-cct-PKIData ::= {id-pkix id-cct(12) 2 } The ASN.1 structure corresponding to theCA MUST respond withPKIData content type is: PKIData ::= SEQUENCE { controlSequence SEQUENCE SIZE(0..MAX) OF TaggedAttribute, reqSequence SEQUENCE SIZE(0..MAX) OF TaggedRequest, cmsSequence SEQUENCE SIZE(0..MAX) OF TaggedContentInfo, otherMsgSequence SEQUENCE SIZE(0..MAX) OF OtherMsg } The fields in PKIData have thefailInfo attributefollowing meaning: controlSequence is a sequence ofbadRequest.controls. Theclient MAY incorporate one or more standard X.509 v3 extensionscontrols defined inany PKCS10 request as an ExtensionReq attribute. An ExtensionReq attribute isthis document are found in Section 6. Controls can be definedasby other parties. Details on the TaggedAttribute structure can be found in Section 3.2.1.1. Schaad & Myers ExpiresSeptember 3, 2006May 22, 2008 [Page12]14] Internet-DraftCMS:CMC: StructuresMarch 2006 ExtensionReq ::= SEQUENCE OF Extension where Extension is imported from [PKIXCERT] and ExtensionReqNovember 2007 reqSequence isidentified by {pkcs-9 14}. Servers MUSTa sequence of certification requests. The certification requests can beable to process all extensions defined, but not prohibited, in [PKIXCERT]. Serversa CertificationRequest (PKCS #10), a CertReqMsg (CRMF) or an externally defined PKI request. Full details arenot required to be able to process other V3 X.509 extensions transmitted using this protocol, nor are they required to be able to process other, private extensions. Servers are not required to put all client-requested extensions into a certificate. Servers are permitted to modify client-requested extensions. Servers MUST NOT alter an extension so as to invalidate the original intent of a client-requested extension. (For example, changing key usage from key exchange to signing.)found in Section 3.2.1.2. Ifaan externally defined certification request isdenied due to the inability to handle a requested extension and a response is returned,present, but the serverMUST respond withdoes not understand thefailInfo attributecertification request (or will not process it), a CMCStatus ofunsupportedExt. 3.3.2. CRMF Request Body ServersnoSupport MUST beable to understandreturned for the certification request item andprocess CRMFno other certification requestbody. Clients MAY produceare processed. cmsSequence is aCRMF message body when using the Full Enrollment Request message. This memo imposes the following additional changes on the construction and processingsequence ofCRMF messages: o When CRMF[CMS] messagebodiesobjects. See Section 3.2.1.3 for more details. otherMsgSequence is a sequence of arbitrary data objects. Data objects placed here areusedreferred to by one or more controls. This allows for controls to use large amounts of data without the data being embedded in theFull Enrollment Request message, each CRMF message MUST include bothcontrol. See Section 3.2.1.4 for more details. All certification requests encoded into a single PKIData SHOULD be for thesubject and publicKey fields insame identity. RAs that batch process (see Section 6.17) are expected to place theCertTemplate. As inPKI Requests received into thecasecmsSequence of a PKIData. Processing ofPKCS10 requests,thesubject may be encodedPKIData by a recipient is asNULL, but MUST be present. o When both CRMF and CMCfollows: 1. All controlsexist with equivalent functionality, the CMC control SHOULDshould beused.examined and processed in an appropriate manner. TheCMCappropriate processing is to complete processing at this time, to ignore the controlMUST overrideor to place theCRMF control. o The regInfo field MUST NOT be usedcontrol on aCRMF message. Equivalent functionality is providedto-do list for later processing. Controls can be processed in any order; theregInfo control attribute (section 5.12). o The indirect method of proving POPorder in the sequence is notsupportedsignificant. 2. Items inthis protocol. One oftheother methods (includingreqSequence are not referenced by a control. These items, which are certification requests, also need to be processed. As with controls, thedirect method described in this document) MUSTappropriate processing can beused instead if POPeither immediate processing or addition to a to-do list for later processing. 3. Finally the to-do list isdesired. The value of encrCert in SubsequentMessage MUST NOT be used. o Sinceprocessed. In many cases thesubjectto-do list will be ordered by grouping specific tasks together. No processing is required for cmsSequence or otherMsgSequence members of PKIData if they are present andpublicKeyValuesarealways present, the POPOSigningKeyInput MUST NOT be used when computingnot referenced by a control. In this case, thevalue forcmsSequence and otherMsgSequence members are ignored. Schaad & Myers ExpiresSeptember 3, 2006May 22, 2008 [Page13]15] Internet-DraftCMS:CMC: StructuresMarch 2006 POPSigningKey. A server is not requiredNovember 2007 3.2.1.1. Control Syntax The actions touse allbe performed for a PKI Request/Response are based on the included controls. Each control consists of an object identifier and a value based on the object identifier. The syntax of a control is: TaggedAttribute ::= SEQUENCE { bodyPartID BodyPartID, attrType OBJECT IDENTIFIER, attrValues SET OF AttributeValue } AttributeValue ::= ANY The fields in TaggedAttribute have the following meaning: bodyPartID is a unique integer that identifies this control. attrType is the OID that identifies the control. attrValues is the data valuessuggestedused in processing the control. The structure of the data is dependent on the specific control. The final server MUST fail the processing of an entire PKIData if any included control is not recognized, that control is not already marked as processed by a Control Processed control (see Section 6.19) and no other error is generated. The PKI Response MUST include a CMCFailInfo value with theclientvalue badRequest and the bodyList MUST contain the bodyPartID of the invalid or unrecognized control(s). A server is the final server if and only if it is not passing the PKI Request on to another server. A server is not considered to be the final server if the server would have passed the PKI Request on, but instead it returned a processing error. The controls defined by this document are found in Section 6. 3.2.1.2. Certification Request Formats Certification Requests are based on PKCS #10, CRMF or Other Request formats. Section 3.2.1.2.1 specifies the requirements for clients and servers dealing with PKCS #10. Section 3.2.1.2.2 specifies the requirements for clients and servers dealing with CRMF. Section 3.2.1.2.3 specifies the requirements for clients and servers dealing with Other Request. Schaad & Myers Expires May 22, 2008 [Page 16] Internet-Draft CMC: Structures November 2007 TaggedRequest ::= CHOICE { tcr [0] TaggedCertificationRequest, crm [1] CertReqMsg, orm [2] SEQUENCE { bodyPartID BodyPartID, requestMessageType OBJECT IDENTIFIER, requestMessageValue ANY DEFINED BY requestMessageType } } The fields in TaggedRequest have the following meaning: tcr is a certification request that uses the PKCS #10 syntax. Details on PKCS #10 are found in Section 3.2.1.2.1. crm is a certification request that uses the CRMF syntax. Details on CRMF are found in Section 3.2.1.2.2. orm is an externally defined certification request. One example is an attribute certification request. The fields of this structure are: bodyPartID is the identifier number for this certification request. Details on body part identifiers are found in Section 3.2.2. requestMessageType identifies thecertificate template. Servers MUST be able to process all extensions defined, but not prohibited in [PKIXCERT]. Serversother request type. These values arenot required to be able to processdefined outside of this document. requestMessageValue is the data associated with the otherV3 X.509 extension transmitted usingrequest type. 3.2.1.2.1. PKCS #10 Certification Syntax A certification request based on PKCS #10 uses the following ASN.1 structure: TaggedCertificationRequest ::= SEQUENCE { bodyPartID BodyPartID, certificationRequest CertificationRequest } The fields in TaggedCertificationRequest have the following meaning: bodyPartID is the identifier number for thisprotocol, norcertification request. Details on body part identifiers arethey required to be able to process other, private extensions. Serversfound in Section 3.2.2. Schaad & Myers Expires May 22, 2008 [Page 17] Internet-Draft CMC: Structures November 2007 certificationRequest contains the PKCS #10 based certification request. Its fields arepermitted to modify client-requested extensions. Serversdescribed in [PKCS10]. When producing a certification request based on PKCS #10, clients MUSTNOT alter an extension so as to invalidateproduce theoriginal intent ofcertification request with aclient-requested extension. (For example change key usage from key exchange to signing.) Ifsubject name and public key. Some PKI products are operated using acertificate request is denied due to the inabilitycentral repository of information tohandleassign subject names upon receipt of arequested extension,certification request. To accommodate this mode of operation, theserversubject field in a CertificationRequest MAY be NULL, but MUSTrespondbe present. CAs that receive a CertificationRequest with afailInfo attribute of unsupportedExt. 3.3.3. Production of Diffie-Hellman Public Key Certification Requests Part ofNULL subject field MAY reject such certification requests. If rejected and acertification requestPKI Response isa signature overreturned, therequest; Diffie-Hellman isCA MUST return akey agreement algorithm and cannot be used to directly produce the required signature object. [DH-POP] provides two ways to producePKI Response with thenecessary signature value. This document also defines a signature algorithm that does not provide a POP value, but can be used to produceCMCFailInfo value with thenecessary signature value. 3.3.3.1. No-Signature Signature Mechanism Key management (encryption/decryption) private keys cannot always be used to produce some type of signaturevalueas they can be in a decrypt only device.badRequest. 3.2.1.2.2. CRMF Certificationrequests require thatSyntax A CRMF message uses thesignature field be populated. This section provides a signature algorithm specifically for that purposes. Thefollowingobject identifierASN.1 structure (defined in [CRMF] andsignature value are used to identify this signature type: id-alg-noSignature OBJECT IDENTIFIERincluded here for convenience): CertReqMsg ::={id-pkix id-alg(6) 2} NoSignatureValueSEQUENCE { certReq CertRequest, popo ProofOfPossession OPTIONAL, -- content depends upon key type regInfo SEQUENCE SIZE(1..MAX) OF AttributeTypeAndValue OPTIONAL } CertRequest ::=OCTET STRING The parametersSEQUENCE { certReqId INTEGER, -- ID forid-alg-noSignature MUST be presentmatching request andMUST be encoded as NULL. NoSignatureValue contains the hashreply certTemplate CertTemplate, --Selected fields ofthe certification request. It is importantcert torealize that there is no security associated with this signature type. If this signature type isbe issued controls Controls OPTIONAL } -- Attributes affecting issuance CertTemplate ::= SEQUENCE { version [0] Version OPTIONAL, serialNumber [1] INTEGER OPTIONAL, signingAlg [2] AlgorithmIdentifier OPTIONAL, issuer [3] Name OPTIONAL, validity [4] OptionalValidity OPTIONAL, subject [5] Name OPTIONAL, publicKey [6] SubjectPublicKeyInfo OPTIONAL, issuerUID [7] UniqueIdentifier OPTIONAL, subjectUID [8] UniqueIdentifier OPTIONAL, extensions [9] Extensions OPTIONAL } The fields in CertReqMsg are explained in [CRMF]. This document imposes the following additional restrictions ona certification request andtheCertification Authority policy requires proof-of-possessionconstruction and processing ofthe private key, the POP mechanism defined in section 5.7 MUST be used.CRMF certification requests: Schaad & Myers ExpiresSeptember 3, 2006May 22, 2008 [Page14]18] Internet-DraftCMS:CMC: StructuresMarch 2006 3.3.3.2. Diffie-Hellman POP Discrete Logarithm Signature CMC compliant implementations MUST support section 4 of [DH-POP]. 3.3.3.3. Diffie-Hellman MAC signature CMC compliant implementations MAY support section 3 of [DH-POP]. 3.4. Body Part Identifiers Each element ofNovember 2007 When aPKIData or PKIResponse message has an associated body part identifier. The body part identifier isFull PKI Request includes a4-octet integer encoded inCRMF certification request, both thecertReqIds field for CertReqMsg objects (in a TaggedRequest) orsubject and publicKey fields in thebodyPartIDCertTemplate MUST be defined. The subject fieldofcan be encoded as NULL, but MUST be present. When both CRMF and CMC controls exist with equivalent functionality, theother objects.CMC control SHOULD be used. Thebody part identifierCMC control MUST override the CRMF control. The regInfo field MUST NOT beunique withinused on asingle PKIData or PKIResponse object. Body part identifiers can be duplicatedCRMF certification request. Equivalent functionality is provided indifferent layers (for example athe CMCmessage embedded within another).regInfo control (Section 6.12). Thebody part Identifierindirect method ofzeroproving POP isreservednot supported in this protocol. One of the other methods (including the direct method described in this document) MUST be used instead if POP is desired. The value of encrCert in SubsequentMessage MUST NOT be used. Since the subject and publicKeyValues are always present, the POPOSigningKeyInput MUST NOT be used when computing the value for POPSigningKey. A server is not required todesignateuse all of thecurrent PKIData object. This value is used in control attributes such asvalues suggested by theAdd Extensions Controlclient in thepkiDataReference field to referCRMF certification request. Servers MUST be able toa requestprocess all extensions defined, but not prohibited inthe current PKIData object. Some control attribute, such as the CMC Status Info attribute, will also use body part identifiers[PKIXCERT]. Servers are not required toreferbe able toelements in the previous message. This allows an errorprocess other X.509v3 extension transmitted using this protocol, nor are they required to beexplicit about the attribute or requestable towhichprocess private extensions. Servers are permitted to modify client-requested extensions. Servers MUST NOT alter an extension so as to invalidate theerror applies. 3.5. Control Attributes The overall control floworiginal intent ofhowamessage is processed in this documentclient- requested extension. (For example change key usage from keyAgreement to digitalSignature.) If a certification request isbased ondenied due to thecontrol attributes. Each control attribute consists of an object identifier andinability to handle avalue based onrequested extension, theobject identifier. The finalserver MUSTfailrespond with a Full PKI Response with a CMCFailInfo value with theprocessingvalue ofan entire PKIData message if any included control attribute is not recognized and that control is not already marked as processed by id-cmc- controlProcessed. The response MUSTunsupportedExt. 3.2.1.2.3. Other Certification Request This document allows for other certification request formats to bethe error badRequest and bodyList MUST contain the bodyPartID of the invalid or unrecognized control attribute(s). A server is the final server ifdefined andonly if (1) itused as well. An example of an other certification request format isnot generating a error responseone foranother reasonAttribute Certificates. These other certification request formats are defined by specifying an OID for identification and(2) it is not goingthe structure toprocess and passcontain therequest ondata toanother server for processing. The syntax of a control attribute isbe passed. Schaad & Myers ExpiresSeptember 3, 2006May 22, 2008 [Page15]19] Internet-DraftCMS:CMC: StructuresMarch 2006 TaggedAttributeNovember 2007 3.2.1.3. Content Info Objects The cmsSequence field of the PKIData and PKIResponse messages contains zero or more tagged content info objects. The syntax for this structure is: TaggedContentInfo ::= SEQUENCE { bodyPartID BodyPartID,attrType OBJECT IDENTIFIER, attrValues SET OF AttributeValuecontentInfo ContentInfo } The fields in TaggedContentInfo have the following meaning: bodyPartID is a unique integer thatis used to referenceidentifies thiscontrol attribute. The id of 0 is reserved for use as the reference to the current PKIDatacontent info object.attrTypecontentInfo isthe OID defining the associated dataa ContentInfo object (defined inattrValues attrValues contains the set of data values[CMS]). The four content types used inprocessing the control attribute. The setcmsSequence are AuthenticatedData, Data, EnvelopedData and SignedData. All ofcontrol attributes thatthese content types are definedby this memo are foundinsection 5. 3.6. Content Info objects[CMS]. 3.2.1.3.1. Authenticated Data ThecmsSequence fieldAuthenticatedData content type provides a method of doing pre- shared secret based validation of data being sent between two parties. Unlike SignedData it does not specify which party actually generated thePKIRequest and PKIResponse messages contains zero or more tagged content info objects. The syntaxinformation. AuthenticatedData provides origination authentication in those circumstances where a shared-secret exists, but a PKI based trust has not yet been established. No PKI based trust may have been established because a trust anchors has not been installed on the client or no certificate exists forthis structure is TaggedContentInfo ::= SEQUENCE { bodyPartID BodyPartID, contentInfo ContentInfo } bodyPartID isaunique integer thatsigning key. AuthenticatedData content type is usedto referenceby thiscontent info object.document for: Theid of 0id-cmc-authData control (Section 6.16), and As the top-level wrapper in environments where an encryption only key isreserved for usebeing certified. This content type can include both PKIData and PKIResponse as thereferenceencapsulated content types. These embedded content types can contain additional controls that need tothe current PKIData object. contentInfo contains a ContentInfo object (defined in [CMS]).be processed. Schaad & Myers Expires May 22, 2008 [Page 20] Internet-Draft CMC: Structures November 2007 3.2.1.3.2. Data Thefour contents used in this location are SignedData, EnvelopedData, AuthenticatedData and Data. EnvelopedData provides for shrouding of data.Data content type allows for general transport of unstructured data.SignedData object from [CMS]The Data content type isalsoused by this document for: Holding the encrypted random value y for POP proof in the encrypted POP control (see Section 6.7). 3.2.1.3.3. Enveloped Data The EnvelopedData content type provides for shrouding of data. The EnvelopedData content type is the primary confidentiality method for sensitive information in thisspecification toprotocol. EnvelopedData can provide encryption of an entire PKI Request (see Section 5). EnvelopedData can also be used to wrap private key material forauthentication as well as serving askey archival. If thegeneral transport wrapperdecryption on an EnvelopedData fails, the Full PKI Response with a CMCFailInfo value with a value ofrequestsbadMessageCheck andresponses. Schaad & Myers Expires September 3, 2006 [Page 16] Internet-Draft CMS: Structures March 2006 AuthenticatedData providesamethod of doing pass phrase based validationbodyPartId ofdata being sent between two parties. Unlike SignedData it does not specify which party actually generated the information. 3.6.1.0. 3.2.1.3.4. Signed Data ThesignedData object is used in two different locations when constructing enrollment messages.SignedData content type provides for authentication and integrity. ThesignedData objectSignedData content type is usedas aby this document for: The outer wrapper for aPKIData as part of the enrollment request message.PKI Request. ThesignedData object is also used as theouterpart of an enrollment response message.wrapper for a PKI Response. As part of processing amessagePKI Request/Response, the signature(s) MUST be verified. If the signature does notverify,verify and thebodyPKI Request/ Response contains anything other than astatus response,CMC Status Info control, anew messageFull PKI Response containing astatus responseCMC Status Info control MUST be returned using a CMCFailInfo with a value of badMessageCheck and abodyPartbodyPartId of 0. For theenrollment response the signedData wrapperPKI Response, SignedData allows the server to sign the returning data, if any exists, and to carry the certificates and CRLsforcorresponding to theenrollment request.PKI Request. If no data is being returned beyond thecertificates, no signerInfo objects are placed in the signedData object. 3.6.2. Enveloped Data EnvelopedData is the primary method of providing confidentiality for sensitive information in this protocol. The protocol currently uses EnvelopedData to provide encryption of an entire request (see section 4.5). The envelopedData object would also be used to wrap private key material for key archival. If the decryption on an envelopedData failes, the response is a CMCFailInfo with a value of badMessageCheckcertificates anda bodyPart of 0. Servers MUST implement envelopedData according to [CMS]. There is an ambiguity (about encrypting content types other than id-data) inCRLs, thePKCS7 specification that has lead to non-interoperability. 3.6.3. Authenticated Data AuthenticatedData is used for providing origination authentication in those circumstances where a shared-secret exists, but a PKI trust anchor hasEncapsulatedInfo and SignerInfo fields are notyet been established. This is currently only used for the id-cmc-authData control (section 5.2.16). This control is uses the PKIData body so that new controls with additional policy type information could be included as well.populated. Schaad & Myers ExpiresSeptember 3, 2006May 22, 2008 [Page17]21] Internet-DraftCMS:CMC: StructuresMarch 2006 3.7.November 2007 3.2.1.4. Other Message Bodies Theother message body portionotherMsgSequence field of themessagePKI Request/Response allows for arbitrary data objects to be carried as part of amessage.PKI Request/ Response. This is intended to contain a data object that is not already wrapped in aCMS contentInfo object.cmsSequence field Section 3.2.1.3. The data object is ignored unless a controlattributereferences the data object by bodyPartID. OtherMsg ::= SEQUENCE { bodyPartID BodyPartID, otherMsgType OBJECT IDENTIFIER, otherMsgValue ANY DEFINED BY otherMsgType } The fields in OtherMsg have the following meaning: bodyPartIDcontainsis the unique idofidentifying thisobjectdata object. otherMsgTypecontainsis the OIDdefining boththat defines theusagetype ofthismessage body otherMsgValue is the data. 3.2.2. Body Part Identification Each element of a PKIData or PKIResponse has an associated body partandidentifier. The body part identifier is a 4-octet integer using thesyntaxASN.1 of: bodyIdMax INTEGER ::= 4294967295 BodyPartID ::= INTEGER(0..bodyIdMax) Body part identifiers are encoded in the certReqIds field for CertReqMsg objects (in a TaggedRequest) or in the bodyPartID field of the other objects. The body part identifier MUST be unique within a single PKIData or PKIResponse. Body part identifiers can be duplicated in different layers (for example a PKIData embedded within another). The bodyPartId valueassociated with thisof 0 is reserved for use as the reference to the current PKIData object. Some controls, such as the Add Extensions control (Section 6.5.2) use the body partotherMsgValueidentifier in the pkiDataReference field to refer to a PKI Request in the current PKIData. Some controls, such as the Extended CMC Status Info control (Section 6.1.1), will also use body part identifiers to refer to elements in the previous PKI Request/ Response. This allows an error to be explicit about the control or Schaad & Myers Expires May 22, 2008 [Page 22] Internet-Draft CMC: Structures November 2007 PKI Request to which the error applies. A BodyPartList contains a list of body parts in a PKI Request/ Response (i.e. thedata associated withBatch Request control in Section 6.17). The ASN.1 type BodyPartList is defined as: BodyPartList ::= SEQUENCE SIZE (1..MAX) OF BodyPartID A BodyPartPath contains a path of body part identifiers moving through nesting (i.e. themessage body part. 3.8.Modify Certificate Request control in Section 6.5.1). The ASN.1 type BodyPartPath is defined as: BodyPartPath ::= SEQUENCE SIZE (1..MAX) OF BodyPartID 3.2.3. CMC UnsignedAttributesData Attribute There is sometimes a need to include data inan enrollment messagea PKI Request designed to be removed by an RA during processing. An example of this is the inclusion of an encrypted private key, where a key archive agent removes the encrypted private key before sending it on to the CA. One side effect of this desire isthe factthat every RA which encapsulates this information needs to move the data so that it is not covered bythe RAthat RA's signature. (A clientrequest,PKI Request, encapsulated by an RA cannot havethe unsigned attributea signed control removed by the key archive agent withoutbreaking the RA's signature.) This attribute addresses that problem. This attribute is used to contain the information that is not directly signed by a user. When an RA finds a message that has this attribute in the unsigned or unauthenticated attribute fields of the CMS objects it is aggregating, they are removed from the embedded CMS objects and propagated up to the RA CMS object. id-aa-cmc-unsignedData OBJECT IDENTIFIER ::= {id-aa 34} CMCUnsignedData ::= SEQUENCE { bodyPartPath SEQUENCE SIZE (1..MAX) OF BodyPartID, identifier OBJECT IDENTIFIER, content ANY DEFINED BY identifier } Schaad & Myers Expires September 3, 2006 [Page 18] Internet-Draft CMS: Structures March 2006 There MUST be at most one CMCUnsignedData attribute in the UnsignedAttribute sequence of a SignerInfo structure. The attribute can have any number of attribute values greater than zero. If the attribute appears in one SignerInfo in a sequence, it MUST appear the same in all SignerInfo items and MUST have the same value(s). Schaad & Myers Expires September 3, 2006 [Page 19] Internet-Draft CMS: Structures March 2006 4. PKI Messages This section discusses the details of putting together the different enrollment request and response messages. 4.1. Simple Enrollment Request The simplest form of an enrollment request is a plain PKCS10 message. If this form of enrollment request is used for a private key that is capable of generating a signature,breaking thePKCS10 MUST be signed with that private key. IfRA's signature.) The CMC Unsigned Data attribute addresses thisform of the enrollment requestproblem. The CMC Unsigned Data attribute contains information that isused fornot directly signed by aD-H key, then the D-H POP mechanism describedclient. When an RA encounters this attribute in[DH-POP] MUST be used. Servers MUST supporttheSimple Enrollment Request message. If the Simple Enrollment Request messageunsigned or unauthenticated attribute field of a request it isused, servers MUST return the Simple Enrollment Response message (see Section 4.3) ifaggregating, theenrollment requestCMC Unsigned Data attribute isgranted. Ifremoved from theenrollmentrequestfails, the Full Enrollment Response MAY be returned or no response MAY be returned. The Simple Enrollment Request message MUST NOT be used if a proof-of- identity needsprior tobe included. Many advanced services specifiedplacing it inthis memo are not supported by the Simple Enrollment Request message. 4.2. Full PKI Request The Full Enrollment Request provides the most functionalitya cmsSequence andflexibility. Clients SHOULD useplaced in theFull Enrollment Request message when enrolling. Servers MUST supportunsigned or unauthenticated attributes of theFull Enrollment Request message. An enrollment response (fullRA's signed orsimple as appropriate) MUST be returned to all Full Enrollment Requests.authenticated data wrapper. TheFull Enrollment Request message consists of a PKIData object wrapped in a signedData CMS object.CMC Unsigned Data attribute is identified by: id-aa-cmc-unsignedData OBJECT IDENTIFIER ::= {id-aa 34} Theobjects inCMC Unsigned Data attribute has thePKIData are ordered as follows: 1. All Control Attributes, 2. All certification requests, 3. All CMS objects, 4. All other messages. Each objectASN.1 definition: CMCUnsignedData ::= SEQUENCE { bodyPartPath BodyPartPath, identifier OBJECT IDENTIFIER, content ANY DEFINED BY identifier } The fields in CMCUnsignedData have thePKIData sequence is identified by a Body Partfollowing meaning: Schaad & Myers ExpiresSeptember 3, 2006May 22, 2008 [Page20]23] Internet-DraftCMS:CMC: StructuresMarch 2006 Identifier. If duplicate ids are found,November 2007 bodyPartPath is theserver MUST returnpath pointing to theerror badRequestcontrol associated witha bodyPartIDthis data. When an RA moves the control in an unsigned or unauthenticated attribute up one level as part of0. The signedData objectwrapping thePKIData may be signed either bydata in a new SignedData or AuthenticatedData, theprivate key materialbody part identifier of thesignature certification request, or by a previously certified signature key. Ifembedded item in theprivate key of a signature certification requestPKIData isbeing used, then:pre-pended to thecertification request containingbodyPartPath sequence. identifier is thecorresponding public key MUST include a Subject Key Identifier extension,OID that defines thesubjectKeyIdentifier form of signerInfoassociated data. content is the data. There MUST beused, andat most one CMC Unsigned Data attribute in thevalueUnsignedAttribute sequence of a SignerInfo or in thesubjectKeyIdentifier formUnauthenticatedAttribute sequence of an AuthenticatedData. UnsignedAttribute consists of a set of values, the attribute can have any number ofsignerInfovalues greater than zero in that set. If the CMC Unsigned Data attribute is in one SignerInfo or AuthenticatedData, it MUSTbeappear with theSubject Key Identifier specifiedsame values(s) in all SignerInfo and AuthenticatedData items. Schaad & Myers Expires May 22, 2008 [Page 24] Internet-Draft CMC: Structures November 2007 4. PKI Responses Two types of PKI Responses exist. This section gives thecorresponding certification request. (The subjectKeyIdentifier formdetails on both types. 4.1. Simple PKI Response Clients MUST be able to process the Simple PKI Response. The Simple PKI Response consists ofsignerInfo is used here becausea SignedData with no EncapsulatedContentInfo and no SignerInfo. The certificateshave yet been issued forrequested in thesigning key.) IfPKI Response are returned in therequest key is used for signing, therecertificate field of the SignedData. Clients MUSTbe onlyNOT assume the certificates are in any order. Servers SHOULD include all intermediate certificates needed to form complete certification paths to onesignerInfo objector more trust anchors, not just the newly issued certificate(s). The server MAY additionally return CRLs in thesignedData object. When creating a messageCRL bag. Servers MAY include the self-signed certificates. Clients MUST NOT implicitly trust included self-signed certificate(s) merely due torenew a certificate,its presence in thefollowing should be taken into consideration: 1. The identification and identityProof control statements are not required. The same information is provided bycertificate bag. In theuse of an existingevent clients receive a new self-signed certificate from theCA when signingserver, clients SHOULD provide a mechanism to enable theenrollment message. 2. CAs and LRAs may impose additional restrictions onuser to use thesigningcertificateused. They may requireas a trust anchor. (The Publish Trust Anchors control Section 6.15 should be used in the event that themost recently issued signing certificate for an entity be used. 3. A renewal message may occur either by creating a new set of keys, or by re-using an existing set of keys. Some CAs may prevent re- use of keys by policy. In this caseserver intends theCA MUST return NOKEYREUSEclient to accept one or more certificates as trust anchors. This requires thefailure code. 4.3. Simple Enrollment Response Servers SHOULDuse of thesimple enrollment response message whenever possible.Full PKI Response message.) 4.2. Full PKI Response Clients MUST be able to processthe simple enrollment response message.a Full PKI Response. Thesimple enrollment response messageFull PKI Response consists of asignedData object with no signerInfo objects on it.SignedData encapsulating a PKIResponse content type. The certificatesrequestedissued in a PKI Response are returned in thecertificate bagcertificates field of thesignedData object. Schaad & Myers Expires September 3, 2006 [Page 21] Internet-Draft CMS: Structures March 2006immediately encapsulating SignedData. Clients MUST NOT assume the certificates are in any order. Servers SHOULD include all intermediate certificates needed to form complete chainstoone or more trust anchors, not just the newly issued certificate(s). The server MAY additionally return CRLs in the CRL bag. Servers MAY includetheself-signed certificates. Clients MUST NOT implicitly trust included self-signed certificate(s) merely due to its presence in the certificate bag. In the event clients receive a new self-signed certificate from the server, clientsSHOULDMAY provide a mechanism to enable the user to explicitlytrustuse thecertificate. 4.4. Full PKI Response Servers MUST return full PKI response messages if a)certificate as afull PKI request message failed or b) additional services other than returning certificates are required. Servers MAY return full PKI responses with failure informationtrust anchor. (The Publish Trust Anchors control Section 6.15 exists forsimple PKI requests. Following section 4.3 above, servers returning only certificates and a success status totheclient SHOULD usepurpose of allowing for distribution of trust anchor certificates. If a trusted anchor publishes a new trusted anchor, this is one case where automated trust of thesimple PKI response message. Clients MUSTnew trust anchor could Schaad & Myers Expires May 22, 2008 [Page 25] Internet-Draft CMC: Structures November 2007 beable to process a fullallowed.) 4.2.1. PKIResponse Content Type The PKIResponse content type is used for the Full PKIresponse message.Response. Thefull enrollment response message consists of a signedData object encapsulating a responseBody object.PKIResponse content type is identified by: id-cct-PKIResponse ::= {id-pkix id-cct(12) 3 } The ASN.1 structure corresponding to the PKIResponse content type is: PKIResponse ::= SEQUENCE { controlSequence SEQUENCE SIZE(0..MAX) OF TaggedAttribute, cmsSequence SEQUENCE SIZE(0..MAX) OF TaggedContentInfo, otherMsgSequence SEQUENCE SIZE(0..MAX) OF OtherMsg } ReponseBody ::= PKIResponse Note: In [RFC2797], this ASN.1 type was named ResponseBody. It has been renamed to PKIResponse for clarity and the old name kept as aresponseBody object all Control Attributes MUST precede all CMS objects.synonym. The fields in PKIResponse have the following meaning: controlSequence is a sequence of controls. Thecertificates grantedcontrols defined inan enrollment responsethis document arereturnedfound in Section 6. Controls can be defined by other parties. Details on thecertificates field of the immediately encapsulating signedData object. Clients MUST NOT assume the certificatesTaggedAttribute structure are found inany order. Servers SHOULD include all intermediate certificates neededSection 3.2.1.1. cmsSequence is a sequence of [CMS] message objects. See Section 3.2.1.3 for more details. otherMsgSequence is a sequence of arbitrary data objects. Data objects placed here are referred toform complete chainsby one or moretrust anchors, not just the newly issued certificate(s). The server MAY additionally return CRLs in the CRL bag. Servers MAY include the self-signed certificates. Clients MUST NOT implicitly trust included self-signed certificate(s) merely duecontrols. This allows for controls toits presence in the certificate bag. Inuse large amounts of data without theevent clients receive a new self-signed certificate fromdata being embedded in theserver, clients SHOULD providecontrol. See Section 3.2.1.4 for more details. Processing of PKIResponse by amechanismrecipient is as follows: 1. All controls should be examined and processed in an appropriate manner. The appropriate processing is toenablecomplete processing at this time, to ignore theusercontrol or toexplicitly trustplace thecertificate. (The publish trust rootcontrolexistson a to-do list for later processing. 2. Additional processing of non-element items includes thepurposesaving ofallowingcertificates and CRLs present in wrapping layers. This type of Schaad & Myers Expires May 22, 2008 [Page 26] Internet-Draft CMC: Structures November 2007 processing is based on the consumer of the element and should not be relied on by generators. No processing is required fordistributioncmsSequence or otherMsgSequence members ofroot certificates. If a trusted root publishesthe PKIResponse, if items are present and are not referenced by anew trusted root,control. In thisis one case where automated trust ofcase, thenew root couldcmsSequence and otherMsgSequence members are to beallowed.) 4.5.ignored. Schaad & Myers Expires May 22, 2008 [Page 27] Internet-Draft CMC: Structures November 2007 5. Application of Encryption to a PKIMessageRequest/Response There are occasionswherewhen a PKIrequestRequest orresponse messageResponse must be encrypted in order to preventanydisclosure of informationaboutin theenrollmentPKI Request/ Response from being accessible to unauthorized entities. This section describes the meansusedto encryptaFull PKImessage. This section is not applicable to a simple enrollment message. Schaad & Myers Expires September 3, 2006 [Page 22] Internet-Draft CMS: Structures March 2006Requests and Responses (Simple PKI Requests cannot be encrypted). Data portions of PKI Requests and Responses that are placed in the cmsSequence field can be encrypted separately. Confidentiality is provided by wrapping the PKImessageRequest/Response (asignedData object)SignedData) ina CMS EnvelopedData object.an EnvelopedData. The nested content type in the EnvelopedData isid-signedData.id-SignedData. Note that this is different from S/MIME where there is a MIME layer placed between the encrypted and signeddata objects.data. It is recommended that if anenveloped dataEnvelopedData layer is applied to a PKImessage,Request/Response, a secondsigningsignature layer be placed outside of theenveloped dataEnvelopedData layer. The following figure shows how this nesting would be done: Normal Option 1 Option 2 ------ -------- -------- SignedData EnvelopedData SignedData PKIData SignedData EnvelopedData PKIData SignedData PKIData Note: PKIResponse can be substituted for PKIData in the above figure. Options 1 and 2provide the benefit of preventingprevent leakage of sensitive data by encrypting theinformation. LRAsFull PKI Request/Response. An RA that receives a PKI Request that it cannot decrypt MAY reject the PKI Request unless it canremoveprocess theenveloped data wrapping, and replace or forwardPKI Request withoutfurther processing.knowledge of the contents (i.e., all it does is amalgamate multiple PKI Requests and forwards them to a server). After the RA removes the envelope and completes processing, it may then apply a new EnvelopedData layer to protect PKI Requests for transmission to the next processing agent. Section67 contains more information aboutLRARA processing. Full PKIMessages MAYRequests/Responses can be encrypted or transmitted in the clear. Servers MUST provided support for all threeversions.options. Alternatively, an authenticated, secure channel could exist between the partiesrequiring encryption.that require confidentiality. Clients and servers MAY use such channels instead of the technique described above to provide secure, private communication ofPKI requestSimple andresponse messages.Full PKI Requests/ Responses. Schaad & Myers ExpiresSeptember 3, 2006May 22, 2008 [Page23]28] Internet-DraftCMS:CMC: StructuresMarch 2006 5. Control Attributes Control attributesNovember 2007 6. Controls Controls are carried as part of both Full PKIrequestsRequests andresponses.Responses. Each controlattributeis encoded as a uniqueObject IdentifierOID followed bythatthe data for the controlattribute.(see syntax in Section 3.2.1.1. The encoding of the data is based on thecontrol attribute object identifier.control. Processing systems would first detect the OID (TaggedAttribute attrType) and process the correspondingattributecontrol value (TaggedAttribute attrValues) prior to processing the message body. The OIDs are all defined under the following arc: id-pkix OBJECT IDENTIFIER ::= { iso(1) identified-organization(3) dod(6) internet(1) security(5) mechanisms(5) pkix(7) } id-cmc OBJECT IDENTIFIER ::= { id-pkix 7 } The following table lists the names, OID and syntactic structure for each of thecontrol attributes documentedcontrols described in thismemo.document. +------------------------+-------+------------------+---------------+ | ControlAttributeIdentifier | OID | Syntax----------------- ---------- --------------| Section | +------------------------+-------+------------------+---------------+ | id-cmc-statusInfoid-cmc 1| id-cm | CMCStatusInfo | Section 6.1.2 | | | c1 | | | | | | | | | id-cmc-identificationid-cmc 2| id-cm | UTF8String | Section 6.2.3 | | | c2 | | | | | | | | | id-cmc-identityProofid-cmc 3| id-cm | OCTET STRING | Section 6.2.2 | | | c3 | | | | | | | | | id-cmc-dataReturnid-cmc 4| id-cm | OCTET STRING | Section 6.4 | | | c4 | | | | | | | | | id-cmc-transactionIdid-cmc 5| id-cm | INTEGER | Section 6.6 | | | c5 | | | | | | | | | id-cmc-senderNonceid-cmc 6| id-cm | OCTET STRING | Section 6.6 | | | c6 | | | | | | | | | id-cmc-recipientNonceid-cmc 7| id-cm | OCTET STRING | Section 6.6 | | | c7 | | | | | | | | | id-cmc-addExtensionsid-cmc 8| id-cm | AddExtensions | Section 6.5.2 | | | c8 | | | | | | | | Schaad & Myers Expires May 22, 2008 [Page 29] Internet-Draft CMC: Structures November 2007 | id-cmc-encryptedPOPid-cmc 9| id-cm | EncryptedPOP | Section 6.7 | | | c9 | | | | | | | | | id-cmc-decryptedPOPid-cmc 10| id-cm | DecryptedPOP | Section 6.7 | | | c10 | | | | | | | | | id-cmc-lraPOPWitnessid-cmc 11| id-cm | LraPOPWitness | Section 6.8 | | | c11 | | | | | | | | | id-cmc-getCertid-cmc 15| id-cm | GetCert | Section 6.9 | | | c15 | | | | | | | | | id-cmc-getCRLid-cmc 16| id-cm | GetCRL | Section 6.10 | | | c16 | | | | | | | | | id-cmc-revokeRequestid-cmc 17| id-cm | RevokeRequest | Section 6.11 | | | c17 | | | | | | | | | id-cmc-regInfoid-cmc 18| id-cm | OCTET STRING | Section 6.12 | | | c18 | | | | | | | | | id-cmc-responseInfoid-cmc 19| id-cm | OCTET STRING | Section 6.12 | | | c19 | | | | | | | | | id-cmc-queryPendingid-cmc 21| id-cm | OCTET STRING | Section 6.13 | | | c21 | | | | | | | | | id-cmc-popLinkRandomid-cmc 22| id-cm | OCTET STRING | Section 6.3.1 | | | c22 | | .3 | | | | | | | id-cmc-popLinkWitnessid-cmc 23| id-cm | OCTET STRINGid-cmc-confirmCertAcceptance id-cmc 24| Section 6.3.1 | | | c23 | | .2 | | | | | | | id-cmc-popLinkWitnessV | id-cm | OCTET STRING | Section 6.3.1 | | 2 | cXX | | .1 | | | | | | | id-cmc-confirmCertAcce | id-cm | CMCCertIdid-cmc-statusInfoEx id-cmc 25 CMCStatusInfoEx id-cmc-trustedRoots id-cmc 26 PublishTrustRoots| Section 6.14 | | ptance | c24 | | | | | | | | | id-cmc-statusInfoV2 | id-cm | CMCStatusInfoV2 | Section 6.1.1 | | | c25 | | | | | | | | | id-cmc-trustedAnchors | id-cm | PublishTrustAnch | Section 6.15 | | | c26 | ors | | | | | | | | id-cmc-authDataid-cmc 27| id-cm | AuthPublish | Section 6.16 | | | c27 | | | | | | | | Schaad & Myers Expires May 22, 2008 [Page 30] Internet-Draft CMC: Structures November 2007 | id-cmc-batchRequestsid-cmc 28| id-cm | BodyPartList | Section 6.17 | | | c28 | | | | | | | | | id-cmc-batchResponsesid-cmc 29| id-cm | BodyPartList | Section 6.17 | | | c29 | | | | | | | | | id-cmc-publishCertid-cmc 30 CMCPublicationInfo| id-cm | CMCPublicationIn | Section 6.18 | | | c30 | fo | | | | | | | | id-cmc-modCertTemplateid-cmc 31| id-cm | ModCertTemplateid-cmc-controlProcessed id-cmc 32 ControlsProcessed 5.1.| Section 6.5.1 | | | c31 | | | | | | | | | id-cmc-controlProcesse | id-cm | ControlsProcesse | Section 6.19 | | d | c32 | d | | | | | | | | id-cmc-identityProof | id-cm | IdentityProofV2 | Section 6.2.2 | | | c33 | | | +------------------------+-------+------------------+---------------+ Table 1: CMCStatus InfoControl Attributes 6.1. CMC Status Info Controls The CMCstatus info control is used in full PKI Response messages toStatus Info controls return information about theprocessingstatus of aclient request.client/server request/response. TwoSchaad & Myers Expires September 3, 2006 [Page 24] Internet-Draft CMS: Structures March 2006controls are described in this section. ThefirstExtended CMC Status Info control is the preferred control; thesecondCMC Status Info control is included for backwards compatibility with RFC 2797. Servers MAY emit multiple CMC status info controls referring to a single body part. Clients MUST be able to deal with multiple CMC status info controls in aresponse message.PKI Response. Servers MUST use theCMCStatusInfoExExtended CMC Status Info control, but MAY additionally use theCMCStatusInfoCMC Status Info control. Clients MUST be able to process theCMCStatusInfoExExtended CMC Status Info control.5.1.1.6.1.1. Extended CMC Status Info ControlAttribute ThisThe Extended CMC Status Info controlusesis identified by the OID: id-cmc-statusInfoV2 ::= { id-cmc 25 } The Extended CMC Status Info control has thefollowingASN.1 definition:CMCStatusInfoExSchaad & Myers Expires May 22, 2008 [Page 31] Internet-Draft CMC: Structures November 2007 CMCStatusInfoV2 ::= SEQUENCE { cMCStatus CMCStatus, bodyList SEQUENCE SIZE (1..MAX) OF BodyPartReference, statusString UTF8String OPTIONAL, otherInfo OtherStatusInfo OPTIONAL } OtherStatusInfo ::= CHOICE { failInfo CMCFailInfo, pendInfo PendInfo, extendedFailInfo ExtendedFailInfo } PendInfo ::= SEQUENCE { pendToken OCTET STRING, pendTime GeneralizedTime } ExtendedFailInfo ::= SEQUENCE { failInfoOID OBJECT IDENTIFIER, failInfoValueAttributeValue } } OPTIONALANY DEFINED BY failInfoOID } BodyPartReference ::= CHOICE { bodyPartID BodyPartID, bodyPartPathSEQUENCE SIZE (1..MAX) OF BodyPartID } PendInfo ::= SEQUENCE { pendToken OCTET STRING, pendTime GeneralizedTimeBodyPartPath }cMCStatus is describedThe fields insection 5.1.3 bodyListCMCStatusInfoV2 have the following meaning: cMCStatus contains thelist of references to body partsreturned status value. Details are in Section 6.1.3. bodyList identifies therequest messagecontrols or other elements to whichthisthe statusinformationvalue applies. If an error isbeingreturned for asimple enrollment message, body list will contain aSimple PKI Request, this field is the bodyPartID choice of BodyPartReference with the single integer of value'1'. Schaad & Myers Expires September 3, 2006 [Page 25] Internet-Draft CMS: Structures March 20061. statusString containsa string withadditional description information. This string is human readable. otherInfo contains additional information that expands on the CMC status code returned in the cMCStatus field. The fields in OtherStatusInfo have the following meaning: Schaad & Myers Expires May 22, 2008 [Page 32] Internet-Draft CMC: Structures November 2007 failInfo is described insection 5.1.4.Section 6.1.4. It providesa detailedan erroroncode that details whatthefailurewas.occurred. This choice is present only if cMCStatusiscontains the value failed.extendedFailInfo is providedpendInfo contains information about when and how the client should request forother usersthe result of this request. It is present when theenrollment protocolcMCStatus is either pending or partial. pendInfo uses the structure PendInfo, which has the fields: pendToken is the token used in the Query Pending control Section 6.13. pendTime contains the suggested time the server wants toprovided their ownbe queried about the status of the certification request. extendedFailInfo includes application dependent detail errorcodes.information. This choice is present only if cMCStatusiscontains the value failed. Caution should be usedinwhen defining new values as they may not be correctly recognized by all clients and servers. ThefailInfoCMCFailInfo value ofinternalCA errorinternalCAError may be assumed if the extended error is not recognized.pendToken isThis field uses thetoken to be used intype ExtendedFailInfo. ExtendedFailInfo has thequeryPending control attribute. pendTimefields: failInfoOID containsthe suggested time the server wants to be queried about the statusan OID that is associated with a set of extended error values. failInfoValue contains an extended error code from therequest.defined set of extended error codes. If the cMCStatus field is success, the Extended CMC Status InfoControlcontrol MAY be omitted unless it is the only item in theresponse message. If no status exists for a certificate request or other item requiring processing, then the value of successresponse. 6.1.2. CMC Status Info Control The CMC Status Info control isto be assumed. 5.1.2.identified by the OID: id-cmc-statusInfo ::= { id-cmc 1 } The CMC Status InfoControl Attribute The CMC status infocontrolis used in full PKI Response messages to return information on a client request. Servers MAY emit multiple CMC status info controls referring to a single body part. Clients MUST be able to deal with multiple CMC status info controls in a response message. This statement useshas thefollowingASN.1 definition: CMCStatusInfo ::= SEQUENCE { cMCStatus CMCStatus, bodyListSEQUENCE SIZE (1..MAX) OF BodyPartID,BodyPartList, statusString UTF8String OPTIONAL, otherInfo CHOICE { failInfo CMCFailInfo, pendInfo PendInfo } OPTIONAL }cMCStatus is described in section 5.1.3Schaad & Myers ExpiresSeptember 3, 2006May 22, 2008 [Page26]33] Internet-DraftCMS:CMC: StructuresMarch 2006November 2007 The fields in CMCStatusInfo have the following meaning: cMCStatus contains the returned status value. Details are in Section 6.1.3. bodyList contains the list ofbody parts in the request messagecontrols or other element to whichthisthe statusinformationvalue applies. If an error is being returned for asimple enrollment message, body list will containSimple PKI Request, this field contains a single integer of value'1'.1. statusString containsa string withadditional description information. This string is human readable. otherInfo provides additional information that expands on the CMC status code returned in the cMCStatus field. failInfo is described insection 5.1.4.Section 6.1.4. It providesa detailedan erroroncode that details whatthefailurewas.occurred. This choice is present only if cMCStatus is failed. pendInfo uses the PendInfo ASN.1 structure in Section 6.1.1. It contains information about when and how the client should request for results on this request. The pendInfo field MUST be populated for a cMCStatus value of pending or partial. Further details can be found in Section 6.1.1 (Extended CMC Status Info Control) and Section 6.13 (Query Pending Control). If the cMCStatus field is success, the CMC Status InfoControlcontrol MAY be omittedunlessif it is the only item in theresponse message.response. If no status exists for acertificate requestSimple orother item requiring processing,Full PKI Request, then the value of success isto beassumed.5.1.3.6.1.3. CMCStatus values CMCStatus is a field in theCMCStatusInfo structure.Extended CMC Status Info and CMC Status Info controls. This field contains a code representing the success or failure ofa specific operation.a specific operation. CMCStatus has the ASN.1 structure: CMCStatus ::= INTEGER { success (0), -- reserved (1), failed (2), pending (3), noSupport (4), confirmRequired (5), popRequired (6), partial (7) } Schaad & Myers Expires May 22, 2008 [Page 34] Internet-Draft CMC: Structures November 2007 The values of CMCStatushashave theASN.1 structure of: CMCStatus ::= INTEGER {following meaning: success(0), --indicates the request was granted-- reserved (1), -- not used, defined whereor theoriginal structureaction wasdefinedcompleted. failed(2), -- you don't get what you want, moreindicates the request was not granted or the action was not completed. More information is included elsewhere in themessageresponse. pending(3), --indicates therequest body partPKI Request hasnotyetbeen processed, -- requesterto be processed. The requestor is responsible to poll back on this--Full PKI request. pending may only bereturnreturned forcertificatea certification request operations. noSupport(4), --indicates the requested operation is notsupportedsupported. confirmRequired(5), -- conformation using the confirmCertAcceptanceindicates a Confirm Certificate Acceptance controlis required --Section 6.14 must be returned beforeuse ofthe certificate can be used. popRequired(6) -- A certificate requiresindicates an indirect POPoperation. -- Infooperation is required Section 6.3.1.3. partial indicates a partial PKI Response is returned. The requestor is responsible to poll back for theindirect POP in this message. } 5.1.4.unfulfilled portions of the Full PKI Request. 6.1.4. CMCFailInfo CMCFailInfo is a field in the Extended CMC Status Info and CMC Status Info controls. CMCFailInfo conveys more detailed information relevant to the interpretation of a failure condition. The CMCFailInfo has the following ASN.1 structure: CMCFailInfo ::= INTEGER { badAlg (0), badMessageCheck (1), badRequest (2), badTime (3), badCertId (4), unsuportedExt (5), mustArchiveKeys (6), badIdentity (7), popRequired (8), popFailed (9), noKeyReuse (10), internalCAError (11), tryLater (12), authDataFail (13) Schaad & Myers ExpiresSeptember 3, 2006May 22, 2008 [Page27]35] Internet-DraftCMS:CMC: StructuresMarch 2006 structure:November 2007 } The values of CMCFailInfo::= INTEGER {have the following meanings: badAlg(0), -- Unrecognizedindicates unrecognized or unsupportedalgorithmalgorithm. badMessageCheck(1), --indicates integrity checkfailedfailed. badRequest(2), --indicates transaction not permitted orsupportedsupported. badTime(3), -- Messageindicates message time field was not sufficiently close to the systemtimetime. badCertId(4), -- Noindicates no certificate could be identified matching the providedcriteriacriteria. unsuportedExt(5), -- Aindicates a requested X.509 extension is not supported by the recipient CA. mustArchiveKeys(6), -- Privateindicates private key material must besuppliedsupplied. badIdentity(7), -- Identification Attributeindicates identification control failed toverifyverify. popRequired(8), -- Serverindicates server requires a POP proof before issuingcertificatecertificate. popFailed(9), --indicates POP processingfailedfailed. noKeyReuse(10), -- Serverindicates server policy does not allow keyre-usereuse. internalCAError(11),indicates that the CA had an unknown internal failure. tryLater(12),indicates that the server is not accepting requests at this time and the client should try at a later time. authDataFail(13) -- Failureindicates failure occurred during processing of authenticated data} Additional failure reasons MAY be defined for closed environments with a need.If additional failure reasons are needed,thisthey SHOULDbe done by using anuse the ExtendedFailureInfo item in the ExtendedFailCMC Status Infoitemcontrol. However for closed environments they can be defined using this type. Such codes MUST be in theCMCStatusInfoEx structure. 5.2.range from 1000 to 1999. 6.2. Identification andIdentityProof Control AttributesIdentity Proof Controls Some CAs andLRAsRAs require that aproof of identityproof-of-identity be included in a certification request. Many different ways of doing this exist with Schaad & Myers Expires May 22, 2008 [Page 36] Internet-Draft CMC: Structures November 2007 different degrees of security and reliability. Mostpeopleare familiar withthe request ofabankbank's request to provide your mother's maiden name as a form of identity proof. The reasoning behind requiring a proof-of- identity can be found in Appendix C of [CRMF]. CMC providesonea methodof provingto prove the client's identity based on a client/server shared-secret. If clients support the Full PKI Request, clients MUST implement this method of identity proof (Section 6.2.2). Servers MUST provide this method, but MAY additionally support bilateral methods of similar strength. This document also provides an Identification control (Section 6.2.3). This control is a simple method to allow a client to state who they are to the server. Generally, a shared secretbetweenAND an identifier of that shared-secret is passed from the server to the client. The identifier is placed in the Identification control and the shared-secret is to compute the Identity Proof control. 6.2.1. Identity Proof Version 2 Control The Identity Proof Version 2 control is identified by the OID: id-cmc-identityProofV2 ::= { id-cmc 33 } The Identity Proof Version 2 control has the ASN.1 definition: IdentifyProofV2 ::= SEQUENCE { hashAlgID AlgorithmIdentifier, macAlgID AlgorithmIdentifier, witness OCTET STRING } The fields of IdentityProofV2 have the following meaning: hashAlgID is the identifier and parameters for the hash algorithm used to convert the shared-secret into a key for thecertificate requestorMAC algorithm. macAlgID is the identifier and theverifying authority. If clients support full request messages, clients MUST implement this methodparameters for the message authentication code algorithm used to compute the value of the witness field. witness is the identity proof.Servers MUST provide this Schaad & Myers Expires September 3, 2006 [Page 28] Internet-Draft CMS: Structures March 2006 method and MAY also have bilateral methods of similar strength available.TheCMCrequired method starts with an out-of-band transfer of a token (theshared secret).shared-secret). The shared-secret should be generated in a random manner. The distribution of this token is beyond the scope of this document. The client then uses this token for an identity proof Schaad & Myers Expires May 22, 2008 [Page 37] Internet-Draft CMC: Structures November 2007 as follows: 1. The PKIData reqSequence fieldof the PKIData object(encoded exactly as it appears in therequest messageFull PKI Request including the sequence type and length) is the value to be validated. 2. ASHA1hash of thetokenshared-secret as a UTF8 string iscomputed.computed using hashAlgID. 3.An HMAC-SHA1 valueA MAC is then computedoverusing the value produced in Step1,1 asdescribed in [HMAC], usingthehash ofmessage and thetokenvalue from Step 2 as theshared secret value.key. 4. The160-bit HMAC-SHA1result from Step 3 is then encoded as the witness valueofin theidentityProof attribute.Identity Proof Version 2 control. When the server verifies theidentityProof attribute,Identity Proof Version 2 control, it computes theHMAC-SHA1MAC value in the same way and compares it to theidentityProof attributewitness value contained in theenrollment request.PKI Request. If a server fails the verification of anidentityProof attribute and the server returns a response message,Identity Proof Version 2 control, thefailInfo attributeCMCFailInfo value MUST be present in theresponseFull PKI Response and MUST have a value of badIdentity. Reuse of the shared-secret onenrollmentcertification request retriesmakes it easier forallows the client and server toprevent getting outmaintain the same view ofsync.acceptable identity proof values. However, reuse of the shared-secret can potentially open the door for some types of attacks. Implementations MUST be able to support tokens at least 16 characters long. Guidance on the amount of entropy actually obtained from a given length token based on character sets can be found in Appendix A of [PASSWORD]. 6.2.2. Identity Proof Control The Identity Proof control is identified by the OID: id-cmc-identityProof ::= { id-cmc 3 } The Identity Proof control has the ASN.1 definition: IdentifyProof ::= OCTET STRING This control is process in the same way as the Identity Proof Version 2 control. In this case the hash algorithm is fixed to SHA-1 and the MAC algorithm is fixed to HMAC-SHA1. Schaad & Myers Expires May 22, 2008 [Page 38] Internet-Draft CMC: Structures November 2007 6.2.3. Identification Control Optionally, servers MAY require the inclusion of the unprotectedidentification attributeIdentification control with anidentification attribute.Identification Proof control. Theidentification attributeIdentification control is intended to containeithera text stringor a numeric quantity, such as a random number,which assists the server in locating theshared secretshared-secret needed to validate the contents of theidentityProof attribute. Numeric values MUST be converted to text string representations prior to encoding as UTF8-STRINGs in this attribute.Identity Proof control. If theidentificationIdentification controlattributeis included in themessage,Full PKI Request, the derivation of theshared secretkey in step 2 (from Section 6.2.1 is altered so that the hash of the concatenation of thetokenshared-secret and the UTF8encodedidentity value (without the type and length bytes)identity valueare hashed rather than just thetoken. Schaad & Myers Expires September 3, 2006 [Page 29] Internet-Draft CMS: Structures March 2006 5.2.1.shared-secret. The Identification control is identified by the OID: id-cmc-identification ::= { id-cmc 2 } The Identification control has the ASN.1 definition: Identification ::= UTF8String 6.2.4. HardwareShared SecretShared-Secret Token Generation Theshared secretshared-secret between theend-entityEE and theidentity verifyserver is sometimestransferredcomputed using a hardware device that generates a series oftokens based on some shared secret value.tokens. TheuserEE can therefore prove their identity by transferring this token in plain text along with a name string. The above protocol can be used with a hardware shared-secret token generation device by the following modifications: 1. Theidentification attributeIdentification control MUST be included and MUST contain the hardware-generated token. 2. Theshared secretshared-secret value used above is the same hardware-generated token. 3. All certification requests MUST have a subject name and the subject name MUST contain the fields required to identify the holder of the hardware token device.5.3.4. The entire certification request MUST be shrouded in some fashion to prevent eavesdropping. Although the token is time critical, an active eavesdropper cannot be permitted to extract the token and submit a different certification request with the same token value. Schaad & Myers Expires May 22, 2008 [Page 39] Internet-Draft CMC: Structures November 2007 6.3. Linking Identity and POP Information In aPKIFullRequest messagePKI Request, identity information about thecreator/ author of the messageclient is carried in the signature of theCMSSignedDataobjectcontaining all of thecertificatecertification requests.Proof- of-possessionProof-of-possession information for keypairs requesting certification,pairs, however, is carried separately for eachPKCS#10PKCS #10 or CRMFmessage.certification request. (For keys capable of generating a digital signature, the POP is provided by the signature on thePKCS#10PKCS #10 or CRMF request. For encryption-only keys the controls described in Section5.7 below6.7 are used.) In order to prevent substitution-styleattacks weattacks, the protocol must guarantee that the same entity generated both the POP andproof-of- identityproof-of-identity information. This section describes two mechanisms for linking identity and POP information: witness values cryptographically derived from the shared-secret (Section5.3.1)6.3.1.3) and shared-secret/subject DN matching (Section5.3.2).6.3.2). Clients and servers MUST support the witness value technique. Clients and servers MAY support shared-secret/subject DN matching or other bilateral techniques of similar strength. The idea behind both mechanisms is to force the client to sign some data into eachcertificatecertification request that can be directly associated with the shared-secret; this will defeat attempts to includecertificatecertification requests from different entities in a single Full PKIRequest message. 5.3.1. Witness valuesRequest. 6.3.1. Cryptographic Linkage The first technique that links identity and POP information forces the client to include a piece of information cryptographically- derived from the shared-secret as a signed extension within each certification request (PKCS #10 or CRMF). 6.3.1.1. POP Link Witness Version 2 Controls The POP Link Witness Version 2 control is identified by the OIDs: id-cmc-popLinkWitnessV2 ::= { id-cmc XX } The POP Link Witness Version 2 control has the ASN.1 definition: PopLinkWitnessV2 ::= SEQUENCE { keyGenAlgorithm AlgorithmIdentifier, macAlgorithm AlgorithmIdentifier, witness OCTET STRING } Thefirst technique for doing identity-POP linking works by forcingfields of PopLinkWitnessV2 have the meaning: Schaad & Myers ExpiresSeptember 3, 2006May 22, 2008 [Page30]40] Internet-DraftCMS:CMC: StructuresMarch 2006November 2007 keyGenAlgorithm contains theclientalgorithm used toinclude a piece of information cryptographically- derived fromgenerate theshared-secret token askey for the MAC algorithm. This will generally be asigned extension within each certificate request (PKCS#10 or CRMF) message.hash algorithm, but could be a more complex algorithm. macAlgorithm contains the algorithm used to create the witness value. witness contains the computed witness value. This technique is useful if null subject DNs are used (because, for example, the server can generate the subject DN for the certificate based only on theshared secret).shared-secret). Processing begins when the client receives the shared-secrettokenout-of-band from the server. The client then computes the following values: 1. The client generates a random byte-string, R, which SHOULD be at least 512 bits in length. 2.A SHA1 hash of the tokenThe key iscomputed.computed from the shared-secret using the algorithm in keyGenAlgorithm. 3.An HMAC-SHA1 valueA MAC is then computed over the random value produced in Step 1,as described in [HMAC],using thehash of the token fromkey computed in Step2 as the shared secret.2. 4. The random value produced in Step 1 is encoded as the value of apopLinkRandom control attribute.POP Link Random control. This controlattributeMUST be included in the Full PKIRequest message.Request. 5. The160-bit HMAC-SHA1 result fromMAC value produced in Step 3 isencoded asplaced in either thevaluePOP Link Witness control or the witness field ofa popLinkWitness extension tothecertificate request. 1.POP Link Witness V2 control. * For CRMF,popLinkWitnessthe POP Link Witness/POP Link Witness V2 control is included in the controlssectionfield of the CertRequest structure.2.* ForPKCS#10, popLinkWitnessPKCS #10, the POP Link Witness/POP Link Witness V2 control is included in the attributessectionfield of theCertificationRequestCertificationRequestInfo structure. Upon receipt, servers MUST verify that eachcertificatecertification request contains a copy of thepopLinkWitnessPOP Link Witness/POP Link Witness V2 control and that its value was derived using the above method from the shared-secret and the random string included in thespecified manner fromPOP Link Random control. The Identification control (see Section 6.2.3) or the subject DN of a certification request can be used to help identify which shared- secret was used. Schaad & Myers Expires May 22, 2008 [Page 41] Internet-Draft CMC: Structures November 2007 6.3.1.2. POP Link Witness Control The POP Link Witness control is identified by the OIDs: id-cmc-popLinkWitness ::= { id-cmc 23 } The POP Link Witness control has the ASN.1 definition: PopLinkWitness ::= OCTET STRING For this control, SHA-1 is used as the key generation algorithm. HMAC-SHA1 is used as the mac algorithm. 6.3.1.3. POP Link Random Control The POP Link Random control is identified by theshared secretOIDs: The POP Link Random and POP Link Witness controls are identified by therandom string included in the popLinkRandomOIDs: id-cmc-popLinkRandom ::= { id-cmc 22 } The POP Link Random controlattribute. 5.3.2.has the ASN.1 definition: PopLinkRandom ::= OCTET STRING 6.3.2. Shared-secret/subject DNmatchinglinking The second techniquefor doing identity-POP linkingto link identity and POP information is to link a particular subject distinguished name (subject DN) to the shared- secrets that are distributed out-of-band and to require that clients using the shared-secret to prove identity include that exact subject DN in everycertificatecertification request. It is expected that many client- server connectionsusingthat use shared-secret based proof-of-identity will use this mechanism. (It is common not to omit the subject DN information from thecertificate request messages.)certification request.) When theshared secretshared-secret is generated and transferred out-of-band toSchaad & Myers Expires September 3, 2006 [Page 31] Internet-Draft CMS: Structures March 2006initiate the registration process (Section5.2),6.2), a particular subject DN is also associated with theshared secretshared-secret and communicated to the client. (The subject DN generated MUST be unique per entity in accordance with the CA policy; a null subject DN cannot be used. A common practice could be to place the identification value as part of the subject DN.) When the client generates the Full PKIRequest message,Request, it MUST use these two pieces of information as follows: 1. The client MUST include the specific subject DN that it received along with theshared secretshared-secret as the subject name in everycertificateSchaad & Myers Expires May 22, 2008 [Page 42] Internet-Draft CMC: Structures November 2007 certification request(PKCS#10(PKCS #10 and/or CRMF) in the Full PKI Request. The subject names in the certification requests MUST NOT be null. 2. The client MUST includethe identityProofan Identity Proof controlattribute (Section 5.2),or Identity Proof Version 2(Section 6.2.2), derived from theshared secret,shared-secret, in the Full PKI Request. The server receiving this message MUST (a) validate theidentityProofIdentity Proof controlattributeand then, (b) check that the subject DN included in eachcertificatecertification request matches that associated with thesharedshared- secret. If either of these checks fails thecertificatecertification request MUST be rejected.5.3.3.6.3.3. Renewal and Re-Key MessagesInWhen doing a renewal or re-keymessage,certification request, linking identity and POP information is simple. The client copies the subject DNin (a) thefor a current signing certificatereferenced byinto theCMS SignerInfo object, and (b) all certificate requests withinsubject name field of each certification request that is made. The POP for the each certification requestmessage MUST match accordingwill now cover that information. The outmost signature layer is created using the current signing certificate, which allows the original identity to be associated with the certification request. Since thestandardnamematch rules describedin[PKIXCERT]. 5.4.the current signing certificate and the names in the certification requests match, the necessary linking has been achieved. 6.4. Data Return ControlAttributeThedata returnData Return controlattributeallows clients to send arbitrary data (usually some type of internal state information) to the server and to have the data returned as part of theenrollment response message.Full PKI Response. Data placed in adata return statementData Return control is considered to be opaque to the server. The same control is used for bothrequestsFull PKI Requests andresponses.Responses. If thedata return statementData Return control appears inan enrollment message,a Full PKI Request, the server MUST return it as part of theenrollment response message.PKI Response. In the event that the information in thedata return statementData Return control needs to be confidential, it is expected that the client would apply some type of encryption to the contained data, but the details of this are outside the scope of this specification.An example of using this featureThe Data Return control isfor aidentified by the OID: id-cmc-dataReturn ::= { id-cmc 4 } The Data Return control has the ASN.1 definition: Schaad & Myers Expires May 22, 2008 [Page 43] Internet-Draft CMC: Structures November 2007 DataReturn ::= OCTET STRING A client could use this control to place an identifier marking the exact source of the private key material.Schaad & Myers Expires September 3, 2006 [Page 32] Internet-Draft CMS: Structures March 2006This might be the identifier of a hardware device containing the private key.5.5.6.5. RA Certificate Modification Controls Theseextensionscontrols exist forRAs/LRAsRAs to be able to modify the contents of arequestors certificate. Thiscertification request. Modifications might be necessary for variousreasons. Thereasons include: addition of certificate extensionsdealing with policies and correcting naming information foror modification of subjectand alternativeand/or subjectnames are two such reasons.alternative names. Two controls exist for this purpose. The first control, Modify CertificateTemplate hasRequest (Section 6.5.1), allows thefull control for allowing modificationRA to replace or remove of any field in the certificate. The second control, Add Extensionscontrol(Section 6.5.2), only allows for the addition of extensions.5.5.1.6.5.1. Modify Certificate Request Control The Modify Certificate Request control is used byLRAs/RAs in orderRAs to changevariousfields inan EEa requested certificate.ThisThe Modify Certificate Request controlallows for the specification of fields inis identified by thecertificate other than extensions. This attribute usesOID: id-cmc-modCertTemplate ::= { id-cmc 31 } The Modify Certificate Request has thefollowingASN.1 definition: ModCertTemplate ::= SEQUENCE { pkiDataReferenceBodyPartList,BodyPartPath, certReferencesSEQUENCE OF BodyPartID,BodyPartList, replace BOOLEAN DEFAULT TRUE, certTemplate CertTemplate }pkiDataReference field containsThe fields in ModCertTemplate have thelist of body part ids that definefollowing meaning: pkiDataReference is the pathofto theembedded request message.PKI Request containing certification request(s) to be modified. certReferencesfield is a list of referencesrefers to one or moreofcertification requests in thepayloads contained within a PKIData element.PKI Request referenced by pkiDataReference to be modified. EachelementBodyPartID of the certReferences sequence MUST be equal to either the bodyPartID of a TaggedCertificationRequest (PKCS #10) or the certReqId of the CertRequest within aCertReqMsg.CertReqMsg (CRMF). By definition, thelistedcertificate extensions included in the Schaad & Myers Expires May 22, 2008 [Page 44] Internet-Draft CMC: Structures November 2007 certTemplate field areto beapplied to everyelementcertification request referenced in the certReferences sequence. If a request corresponding to bodyPartID cannot be found, theerrorCMCFailInfo with a value of badRequest is returnedreferencingthat references thiscontrol attribute.control. replace specifies if thedatatarget certification request is to bereplace with what is here,modified by replacing orif the fields in the original certificate request are to be removed.deleting fields. Ifreplacethe value isFALSE, any field definedTRUE, the data in this control replaces thecertTemplate fielddata in the target certification request. If the value isremoved from proposed certificate. ForFALSE, theSchaad & Myers Expires September 3, 2006 [Page 33] Internet-Draft CMS: Structures March 2006 extensions field, only those extensions which are defineddata in thetemplate certificate are removed.target certification request is deleted. Theuse ofaction is slightly different for thereplaceextensions fieldset to FALSEof certTemplate, each extension isbe considered to be a rare eventtreated individually rather than asgenerally the field would just be replaced withacorrect value.single unit. certTemplatecontainsis a certificate templateobject. Items are to be omitted from the certificate template unless the value presentobject [CRMF]. If a field istopresent and replacethe value found theis TRUE, it replaces that field in therequested certificate template.certification request. Ifathe field is presentinand replace is FALSE, theextensionsfieldofin thetemplate, that extension would either replacecertification request is removed. If thesame existingfield is absent, no action is performed. Each extensionor be added to the set of extensions in the requested certificate.is treated as a single field. Servers MUST be able to process all extensions defined, but not prohibited, in [PKIXCERT]. Servers are not required to be able to process everyV3 X.509X.509v3 extension transmitted using this protocol, nor are they required to be able to process other, private extensions. Servers are not required to put allLRA-requestedRA-requested extensions into a certificate. Servers are permitted to modifyLRA-requestedRA-requested extensions. Servers MUST NOT alter an extension so as to reverse the meaning of a client-requested extension. If a certification request is denied due to the inability to handle a requested extension and aresponseFull PKI Response is returned, the server MUST return afailInfo attributeCMCFailInfo value with the value of unsupportedExt. If a certification request is the target of multiple Modify CertificateTemplate controls exist in an enrollment message,Request controls, theexactbehavioris left up to the certificate issuer policy. However it is recommendedis: o If control A exists in a layer that contains thefollowing policy be used. These rules wouldlayer of control B, control A MUST override control B. In other words, controls should be applied from the innermost layer toindividual extensions within an Add Extensions control attribute (as opposed to an "all or nothing" approach). 1.the outermost layer. o If control A and control B are in theconflict is within a singlesame PKIDataobject,(i.e. thecertificate request would be rejected with an error of badRequest. 2. Ifsame wrapping layer), theconflictorder of application isbetween different PKIData objects, the outermost versionnon-determinate. The same order ofthe extension would beapplication is used(allowing an LRA to override the extension requested byif a certification request is theend-entity). 5.5.2.target of both a Modify Certificate Request control and an Add Extensions control. Schaad & Myers Expires May 22, 2008 [Page 45] Internet-Draft CMC: Structures November 2007 6.5.2. Add Extensions Control The Add Extensions control has beendepreciateddeprecated in favor of the Modify CertificateTemplateRequest control. It was replaced so that fields in thecertificate templatecertification request other than extensions could be modified. The Add Extensions controlattributeis used byLRAs in orderRAs to specify additional extensions that are to beplaced onincluded in certificates.Schaad & Myers Expires September 3, 2006 [Page 34] Internet-Draft CMS: Structures March 2006 This attribute usesThe Add Extensions control is identified by the OID: id-cmc-addExtensions ::= { id-cmc 8 } The Add Extensions control has thefollowingASN.1 definition: AddExtensions ::= SEQUENCE { pkiDataReferenceBodyPartIDBodyPartID, certReferences SEQUENCE OF BodyPartID, extensions SEQUENCE OF Extension } The fields in AddExtensions have the following meaning: pkiDataReferencefieldcontains the body partididentity of the embeddedrequest message.certification request. certReferencesfieldis a list of references to one or more of thepayloadscertification requests contained within a PKIData. Eachelementbody part identifier of the certReferences sequence MUST be equal to either the bodyPartID of a TaggedCertificationRequest (PKCS #10) or the certReqId of the CertRequest within aCertReqMsg.CertReqMsg (CRMF). By definition, the listed extensions are to be applied to everyelementcertification request referenced in the certReferences sequence. If a certification request corresponding to bodyPartID cannot be found, theerrorCMCFailInfo with a value of badRequest is returned referencing thiscontrol attribute.control. extensionsfield contains theis a sequence of extensions to be applied to the referencedcertificatecertification requests. Servers MUST be able to process all extensions defined, but not prohibited, in [PKIXCERT]. Servers are not required to be able to process everyV3 X.509X.509v3 extension transmitted using this protocol, nor are they required to be able to process other, private extensions. Servers are not required to put allLRA-requestedRA-requested extensions into a certificate. Servers are permitted to modifyLRA-requestedRA-requested extensions. Servers MUST NOT alter an extension so as to reverse the meaning of a client-requested extension If a certification request is Schaad & Myers Expires May 22, 2008 [Page 46] Internet-Draft CMC: Structures November 2007 denied due to the inability to handle a requested extension and a response is returned, the server MUST return afailInfo attributeCMCFailInfo with the value of unsupportedExt. If multiple Add Extensionsstatementscontrols exist inan enrollment message,a Full PKI Request, the exact behavior is left up to thecertificate issuerCA policy. However it is recommended that the following policy be used. These rules would be applied to individual extensions within an Add Extensions controlattribute(as opposed to an "all or nothing" approach). 1. If the conflict is within a singlePKIData object,PKIData, thecertificatecertification request would be rejected withan errora CMCFailInfo value of badRequest.Schaad & Myers Expires September 3, 2006 [Page 35] Internet-Draft CMS: Structures March 20062. If the conflict is between differentPKIData objects,PKIData, the outermost version of the extension would be used (allowing anLRARA to override theextensionrequestedby the end-entity). 5.6.extension). 6.6. TransactionManagement Control AttributesIdentifier, Sender and Recipient Nonce Controls Transactions are identified and trackedusingwith a transaction identifier. If used, clients generate transaction identifiers and retain their value until the server responds with amessageFull PKI Response that completes the transaction. Servers correspondingly include received transaction identifiers in theresponse.Full PKI Response. ThetransactionId attributeTransaction Identifier control is identified by the OID: id-cmc-transactionId ::= { id-cmc 5 } The Transaction Identifier control has the ASN.1 definition: TransactionId ::= INTEGER The Transaction Identifier control identifies a given transaction. It is usedbetweenby client and server to manage the state of an operation. Clients MAY include atransactionID attributeTransaction Identifier control inrequest messages.request. If the original request contains atransactionID attribute,Transaction Identifier control, all subsequentrequestrequests andresponse messagesresponses MUST include the sametransactionID attribute. A server MUST use only transactionIds in the outermost PKIdata object. TransactionIds on inner PKIdata objects are for intermediate entities.Transaction Identifier control. Replay protectioncan beis supported through the use ofsenderthe Sender andrecipient nonces.Recipient Nonces controls. If nonces are used, in the first message of a transaction,no recipientNoncea Recipient Nonce control is not transmitted; asenderNonceSender Nonce control isinstantiatedincluded by themessagetransaction originator and retained for later reference. The recipient of asender nonceSender Nonce control reflects this value back to the originator as arecipientNonceRecipient Nonce control and includesit'sits ownsenderNonce.Sender Nonce control. Upon receipt by the transaction originator of thismessage,response, the Schaad & Myers Expires May 22, 2008 [Page 47] Internet-Draft CMC: Structures November 2007 transaction originator compares the value ofrecipientNonceRecipient Nonce control to its retained value. If the values match, the message can be accepted for further security processing. The received value forsenderNoncea Sender Nonce control is also retained for inclusion in the next message associated with the same transaction. ThesenderNonceSender Nonce andrecipientNonce attribute can be used to provide application-level replay prevention.Recipient controls are identified by the OIDs: id-cmc-senderNonce ::= { id-cmc 6 } id-cmc-recipientNonce ::= { id-cmc 7 } The Sender Nonce control has the ASN.1 definition: SenderNonce ::= OCTET STRING The Recipient Nonce control has the ASN.1 definition: RecepientNonce ::= OCTET STRING Clients MAY include asenderNonceSender Nonce control in the initialrequest message. Originating messages include only a value for senderNonce.PKI Request. If a message includes asenderNonce,Sender Nonce control, the response MUST include the transmitted value of the previously receivedsenderNonceSender Nonce control asrecipientNoncea Recipient Nonce control and include a new valuefor senderNonce. A server MUST use only nonces in the outermost PKIdata object. Nonces on inner PKIdata objects are for intermediate entities. 5.7. Proof-of-possession (POP) for encryption-only keys Everything described in this section is optional to implement, for both serversas its Sender Nonce control. 6.7. Encrypted andclients.Decrypted POP Controls Servers MAY require this POP method beSchaad & Myers Expires September 3, 2006 [Page 36] Internet-Draft CMS: Structures March 2006used only if another POP method is unavailable. Servers SHOULD reject all certification requests contained within a PKIData if any required POP is missing for any element within the PKIData. Many servers require proof thatanthe entityrequesting a certificate for a public keythat generated the certification request actually possesses the corresponding private component of the key pair. For keys that can be used as signature keys, signing the certification request with the private key serves as a POP on that key pair. With keys that can only be used for encryption operations, POP MUST be performed by forcing the client to decrypt a value. See Section 5 of [CRMF] for a detailed discussion of POP. By necessity, POP for encryption-only keys cannot be done in one round-trip, since there are four distinctphases:steps: 1. Client tells the server about the public component of a new encryption key pair. Schaad & Myers Expires May 22, 2008 [Page 48] Internet-Draft CMC: Structures November 2007 2. Server sends the client a POP challenge, encrypted with the presented public encryptionkey, which the client must decrypt.key. 3. Client decrypts the POP challenge using the private key that corresponds to the presented public key and sendsitthe plaintext back to the server. 4. Server validates the decrypted POP challenge and continues processing thecertificatecertification request. CMC defines two differentattributes.controls. The first deals with the encrypted challenge sent from the server to the user in step 2. The second deals with the decrypted challenge sent from the client to the server in step 3. TheencryptedPOP attributeEncrypted POP control is used to send the encrypted challenge from the server to theclient. As such, it is encodedclient asa tagged attribute within the controlSequencepart ofa ResponseBody.the PKIResponse. (Note thatwe assumeit is assumed that the message sent in Step 1 aboveis an enrollment requestis a Full PKI Request and that the response in step 2 is a FullEnrollmentPKI Response including afailureInfoCMCFailInfo specifying that a POP is explicitly required, and providing the POP challenge in the encryptedPOPattribute.) Schaad & Myers Expires September 3, 2006 [Page 37] Internet-Draft CMS: Structures March 2006control.) The Encrypted POP control is identified by the OID: id-cmc-encryptedPOP ::= { id-cmc 9 } The Encrypted POP control has the ASN.1 definition: EncryptedPOP ::= SEQUENCE { request TaggedRequest, cmscontentInfo,ContentInfo, thePOPAlgID AlgorithmIdentifier, witnessAlgID AlgorithmIdentifier, witness OCTET STRING } The Decrypted POP control is identified by the OID: id-cmc-decryptedPOP ::= { id-cmc 10 } The Decrypted POP control has the ASN.1 definition: DecryptedPOP ::= SEQUENCE { bodyPartID BodyPartID, thePOPAlgID AlgorithmIdentifier, thePOP OCTET STRING } Schaad & Myers Expires May 22, 2008 [Page 49] Internet-Draft CMC: Structures November 2007 The encrypted POP algorithm works as follows: 1. The server generates a random value y and associates it with the request. 2. The server returns theencrypted popEncrypted POP control with the following fields set:1.request is thecertificate request in theoriginal certification requestmessage(it is included here so the client need not key a copy of the request),2.cms is anEnvelopedData object,EnvelopedData, the encapsulated content type being id- data and the content being the POP Proof Value, this value needs to be long enough that one cannot reverse the valuey.from the witness hash. If thecertificatecertification request contains asubject key identifierSubject Key Identifier (SKI) extension, then the recipient identifier SHOULD be the SKI. If the issuerAndSerialNumber form is used, theIsserNameIssuerName MUST be encoded as NULL and the SerialNumber as the bodyPartID of thecertificatecertification request,3.thePOPAlgIDcontainsidentifies the algorithm to be used in computing the return POP value,4.witnessAlgIDcontainsidentifies the hash algorithm used on y to create the field witness,5.witnesscontainsis the hashed value ofy.POP proof value. 3. The client decrypts the cms field to obtainthe value y.POP proof value. The client computesH(y)H(POP proof value) using the witnessAlgID and compares to the value of witness. If the values do not compare or the decryption is not successful, the client MUST abort the enrollment process. The client aborts the process by sending a requestmessagecontaining aCMCStatusInfoCMC Status Info controlattributewithfailInfoCMCFailInfo valueSchaad & Myers Expires September 3, 2006 [Page 38] Internet-Draft CMS: Structures March 2006of popFailed. 4. The client creates thedecryptedPOPa Decrypted POP control as part of a newPKIData message.PKIData. The fields in thedecryptedPOPDecryptedPOP are:1.bodyPartID refers to thecertificatecertification request in the newenrollment message, 2.PKI Request, thePOPAlgID is copied from the encryptedPOP,3.thePOP contains the possession proof. This value is computed by thePOPAlgID using the value y andrequest referenced in (4a).the request. Schaad & Myers Expires May 22, 2008 [Page 50] Internet-Draft CMC: Structures November 2007 5. The server then re-computes the value of thePOP from its cached value of y and the request and compares to the value of thePOP. If the values do not match, the server MUST NOT issue the certificate. The server MAY re-issue a new challenge or MAY fail the request altogether. When defining the algorithms for thePOPAlgID and witnessAlgID care must be taken to ensure that the result of witnessAlgID is not a useful value to shortcut the computation with thePOPAlgID.Clients MUST implement SHA-1 for witnessAlgID. Clients MUST implement HMAC- SHA1 for thePOPAlgID.The value of y is used as the secret value in the HMAC algorithm and the requestreferenced in (4a)is used as the data. If y is greater than 64 bytes, only the first 64 bytes of y are used as the secret. One potential problem with the algorithm above is the amount of state that a CA needs to keep in order to verify the returned POP value.ThisThe following describes one of many possible ways of addressing the problem by reducing the amount of state kept on the CA to a single (or small set) of values. 1. Server generates random seed x, constant across all requests. (The value of x would normally be altered on a regular basis and kept for a short time afterwards.) 2. Forcertificatecertification request R, server computes y = F(x,R). F can be, for example, HMAC-SHA1(x,R). All that's important for statelessness is that y be consistently computable with only known state constant x and function F, other inputs coming from thecertcertification request structure. y should not be predictable based on knowledge of R, thus the use of aOWFOne-Way-Function like HMAC-SHA1.Schaad & Myers Expires September 3, 2006 [Page 39] Internet-Draft CMS: Structures March 2006 5.8. LRA6.8. RA POPWitnessesWitness ControlAttributeInan enrollmenta certification request scenarioinvolvingthat involves anLRAsRA, the CA may allow (or require) that theLRA toRA perform the POP protocol with the entityrequesting certification.that generated the certification request. In thiscasecase, theLRARA needs a way to inform the CA it has done the POP.ThisThe RA POP Witness controlattribute has been created to addressaddresses this issue. TheASN.1 structure for the LRARA POPwitnessWitness control isas follows:identified by the OID: id-cmc-lraPOPWitness ::= { id-cmc 11 } The RA POP Witness control has the ASN.1 definition: LraPopWitness ::= SEQUENCE { pkiDataBodyid BodyPartID, bodyIds SEQUENCE of BodyPartID Schaad & Myers Expires May 22, 2008 [Page 51] Internet-Draft CMC: Structures November 2007 } The fields in LraPOPWitness have the following meaning: pkiDataBodyidfieldcontains the body partididentifier of the nestedCMS body objectTaggedContentInfo containing the client'sfull request message.Full PKI Request. pkiDataBodyid is set to 0 if the request is in the currentPKIRequest body.PKIData. bodyIdscontainsis a list ofcertificatecertification requests for which theLRARA has performed an out-of-band authentication. The method of authentication could be archival of private key material, challenge-response or other means. If acertificatecertification server does not allowforanLRARA to do the POP verification, it returnsan errora CMCFailInfo with the value ofPOPFAILURE.popFailed. The CA MUST NOT start a challenge-response to re-verify the POP itself.5.9.6.9. Get Certificate ControlAttributeEverything described in this section is optional to implement. Theget certificateGet Certificate controlattributeis used to retrieve a previously issuedcertificatescertificate from arepository of certificates.certificate repository. ACertificate Authority,CA, anLRARA or an independent service may provide this repository. The clients expected to use this facility are thoseoperating in a resource-constrained environment. (An example of a resource-constrained client would bewhere alow-end IP router that does not retain its own certificate in non-volatile memory.)fully deployed directory is either infeasible or undesirable. Theget certificateGet Certificate control is identified by the OID: id-cmc-getCert ::= { id-cmc 15 } The Get Certificate controlattributehas thefollowingASN.1structure:definition: GetCert ::= SEQUENCE { issuerName GeneralName, serialNumber INTEGER } Theservice responding tofields in GetCert have the following meaning: issuerName is the name of the certificate issuer. serialNumber identifies the certificate to be retrieved. The server that responds to this requestwill placeplaces the requestedSchaad & Myers Expires September 3, 2006 [Page 40] Internet-Draft CMS: Structures March 2006certificate in the certificates field of aSignedData object.SignedData. If theget certificate attributeGet Certificate control is the only control in a Full PKIRequest message,Request, the Schaad & Myers Expires May 22, 2008 [Page 52] Internet-Draft CMC: Structures November 2007 responsewouldshould be a SimpleEnrollmentPKI Response.5.10.6.10. Get CRL ControlAttributeEverything described in this section is optional to implement. ThegetGet CRL controlattributeis used to retrieve CRLs from a repository of CRLs. ACertification Authority,CA, anLRARA or an independent service may provide this repository. The clients expected to use this facility are those where a fully deployed directory is either infeasible or undesirable. ThegetGet CRL control is identified by the OID: id-cmc-getCRL ::= { id-cmc 16 } The Get CRL controlattributehas thefollowingASN.1structure:definition: GetCRL ::= SEQUENCE { issuerName Name, cRLName GeneralName OPTIONAL, time GeneralizedTime OPTIONAL, reasons ReasonFlags OPTIONAL } The fields in a GetCRL have the following meanings: issuerName is the name of the CRL issuer. cRLName may be the value of CRLDistributionPoints in the subject certificate or equivalent value in the event the certificate does not contain such a value. time is used by the client to specify from among potentially several issues of CRL that one whose thisUpdate value is less than but nearest to the specified time. In the absence of a time component, the CA always returns with the most recent CRL. reasons is used to specify from among CRLs partitioned by revocation reason. Implementers should bear in mind that while a specific revocation request has a single CRLReasoncode--andcode - and consequently entries in the CRL would have a single CRLReason codevalue--avalue - a single CRL can aggregate information for one or more reasonFlags. Aserviceserver responding tothethis requestwill placeplaces the requested CRL in the crls field of aSignedData object.SignedData. If thegetGet CRLattributecontrol is the only control in afull enrollment message,Full PKI Request, the responsewouldshould be asimple enrollment response.Simple PKI Response. Schaad & Myers ExpiresSeptember 3, 2006May 22, 2008 [Page41]53] Internet-DraftCMS:CMC: StructuresMarch 2006 5.11.November 2007 6.11. Revocation Request ControlAttributeTherevocation requestRevocation Request controlattributeis used to request that a certificate be revoked. Therevocation requestRevocation Request control is identified by the OID: id-cmc-revokeRequest ::= { id-cmc 17 } The Revocation Request controlattributehas thefollowingASN.1syntax:definition: RevokeRequest ::= SEQUENCE { issuerName Name, serialNumber INTEGER, reason CRLReason, invalidityDate GeneralizedTime OPTIONAL, sharedSecret OCTET STRING OPTIONAL, comment UTF8string OPTIONAL } The fields of RevokeRequest have the following meaning: issuerNamecontainsis the issuerName of the certificate to be revoked. serialNumbercontainsis the serial number of the certificate to berevokedrevoked. reasoncontainsis the suggested CRLReason code for why the certificate is being revoked. The CA can use this value at its discretion in building the CRL. invalidityDatecontainsis the suggested value for the Invalidity Date CRL Extension. The CA can use this value at its discretion in building the CRL. sharedSecretcontainsis a secret value registered by the EE when the certificate was obtained to allow for revocation of a certificate in the event of key loss. commentcontainsis a human readable comment. For a revocation request tobecome abe reliableobjectin the event of a dispute, a strongproof of originator authenticityproof-of-origin is required. However, in the instance when anend-entityEE has lost use of its signature private key, it is impossible for theend-entityEE to produce a digital signature (prior to the certification of a new signature key pair). TheRevokeRequest provides for the optional transmission fromRevoke Request control allows theend-entityEE to send the CAofashared secretshared-secret that may be used as an alternative authenticator in the instance of loss ofuse.use of the EE's signature private key. The acceptability of this practice is a matter of local security policy.(Note that in some situations a Registration Authority may be delegated authority to revoke certificates on behalf of some population within its scope control. In these situations the CASchaad & Myers ExpiresSeptember 3, 2006May 22, 2008 [Page42]54] Internet-DraftCMS:CMC: StructuresMarch 2006 would acceptNovember 2007 It is possible to sign theLRA's digital signature onrevocation for therequest to revokelost certificate with acertificate, independent of whetherdifferent certificate in some circumstances. A client can sign a revocation for an encryption key with a signing certificate if theend entity still had accessname information matches. Similarly an administrator or RA can be assigned the ability to revoke theprivate componentcertificate of a third party. Acceptance of thekey pair.)revocation by the server depends on local policy in these cases. Clients MUST provide the capability to produce a digitally signedrevocation request control attribute.Revocation Request control. Clients SHOULD be capable of producing an unsignedrevocation requestRevocation Request control containing theend-entity's sharedEE shared- secret. (The unsigned message consisting of aCMS signedData objectSignedData with no signatures.) If a client providesshared secretshared-secret basedself-revocation,self- revocation, the client MUST be capable of producing arevocation requestRevocation Request control containing theshared secret.shared-secret. Servers MUST be capable of accepting both forms of revocation requests. The structure of an unsigned,shared secretshared-secret based revocation request is a matter of local implementation. Theshared secretshared-secret does not need to be encrypted when sent in arevocation request.Revocation Request control. Theshared secretshared-secret has a one-timeuse, thatuse (i.e., it is used to request revocation ofcausingthecertificate to be revoked,certificate), and public knowledge of thesharedshared- secret after the certificate has been revoked is not a problem. Clients need to inform users that the sameshared secretshared-secret SHOULD NOT be used for multiple certificates. Afull response messageFull PKI Response MUST be returned for a revocation request.5.12.6.12. Registration and Response InformationControl AttributesControls TheregInfoRegistration Information controlattribute isallows for clientsand LRAsto pass additional information as part a Full PKIrequest.Request. TheregInfoRegistration Information control is identified by the OID: id-cmc-regInfo ::= { id-cmc 18 } The Registration Information controlattribute useshas the ASN.1structure:definition: RegInfo ::= OCTET STRING The content of this data is based on bilateral agreement between the client and server.IfThe Response Information control allows a server(or LRA) needsto return additional informationback to a requestor in response to data submitted in a regInfo attribute, then that data is returnedas part of aresponseInfoFull PKI Response. The Response Information controlattribute.is identified by the OID: Schaad & Myers Expires May 22, 2008 [Page 55] Internet-Draft CMC: Structures November 2007 id-cmc-responseInfo ::= { id-cmc 19 } Thecontent ofResponse Information control has the ASN.1 definition: ResponseInfo ::= OCTET STRINGfor response informationThe content of this data is based on bilateral agreement between the client and the server.5.13.6.13. Query Pending ControlAttributeIn some environments, process requirements for manual intervention or other identitycheckingchecks cancause adelayin returningthecertificate related to a certificate request.return of the certificate. Thequery pending attributeQuery Pending control allowsfor a clientclients to query a server about the state of a pendingcertificatecertification request. The server returns atokenpendToken as part of theCMCStatusInfo attributeExtended CMC Status Info and the CMC Status Info controls (in the otherInfo field). The clientSchaad & Myers Expires September 3, 2006 [Page 43] Internet-Draft CMS: Structures March 2006 putscopies thetokenpendToken into thequery pending attributeQuery Pending control to identify the correct certification request to the server. The servercan also returnreturns a suggested time for the client to query for the state of a pendingcertificatecertification request. TheASN.1 structure usedQuery Pending control is identified by thequery pendingOID: id-cmc-queryPending ::= { id-cmc 21 } The Query Pending controlattribute is:has the ASN.1 definition: QueryPending ::= OCTET STRING If a server returns a pendingstateor partial CMCStatusInfo (the transaction is still pending), the otherInfo MAY be omitted. Ifitthe otherInfo is notomitted thenomitted, thesamevalue of 'pendInfo' MUST bereturned (the token MUST NOT change duringtherequest). 5.14.same as the original pendInfo value. 6.14. Confirm Certificate Acceptance Control SomeCertification AuthoritiesCAs require that clients give a positiveconformationconfirmation that the certificates issued toitthe EE are acceptable. The Confirm Certificate Acceptance controlattributeis used for that purpose. If theCMCStatusInfoCMC Status Info on acertificate responsePKI Response is confirmRequired, then the client MUST return a Confirm CertificateattributeAcceptance control contained in afull enrollment response message.Full PKI Request. Clients SHOULD wait for theresponsePKI Response from the server that theconformationconfirmation has been received before using the certificate for any purpose. Schaad & Myers Expires May 22, 2008 [Page 56] Internet-Draft CMC: Structures November 2007 The Confirm Certificate Acceptance control is identified by the OID: id-cmc-confirmCertAcceptance ::= { id-cmc 24 } The Confirm Control Acceptance control hasbeen received before usingthecertificate for any purpose. The confirm certificate acceptance structure is:ASN.1 definition: CMCCertId ::= IssuerAndSerialNumber CMCCertId contains the issuer and serial number of the certificate being accepted. Servers MUST return afull enrollment responseFull PKI Response for aconfirm certificate acceptanceConfirm Certificate Acceptance control. Note that if theCertification AuthorityCA includes thisattribute,control, there will be two full round trips of messages. 1. The client sends the certification request to the CA. 2. The CA returns a Full PKI Response with the certificate and thisattribute.control. 3. The client sends aresponse messageFull PKI Request to the CA witha CMCStatusInfoExan Extended CMC Status Info controleitheraccepting and a Confirm Certificate Acceptance control or an Extended CMC Status Info control rejecting the certificate.Schaad & Myers Expires September 3, 2006 [Page 44] Internet-Draft CMS: Structures March 20064. The CA sends aresponse messageFull PKI Response to the client witha CMCStatusInfoExan Extended CMC Status Info of success.5.15.6.15. Publish TrustRoots ThisAnchors Control The Publish Trust Anchors control allows for the distribution of set trustrootsanchors from a central authority to anend-entity. WhatEE. The same control isincludedalso used to update the set of trust anchors. Trust anchors are distributed in the form of certificates. These are expected, but not required, to be self-signed certificates. Information is extracted from these certificates to set the inputs to the certificates validation algorithm in section 6.1.1 of [PKIXCERT]. The Publish Trust Anchors control is identified by the OID: id-cmc-trustedAnchors ::= { id-cmc 26 } The Publish Trust Anchors controlas datahas the ASN.1 definition: Schaad & Myers Expires May 22, 2008 [Page 57] Internet-Draft CMC: Structures November 2007 PublishTrustAnchors ::= SEQUENCE { seqNumber INTEGER, hashAlgorithm AlgorithmIdentifier, anchorHashes SEQUENCE OF OCTET STRING } The fields in PublishTrustAnchors have the following meaning: seqNumber is an integer indicating thesetlocation within a sequence of updates. hashAlgorithm is the identifier and parameters for the hash algorithm that is used in computing the values of the anchorHashes field. All implementations MUST implement SHA-1 for this field. anchorHashes are the hashes for the certificates that are to be treated as trust anchors by the client. The actual certificates are transported in the certificate bag of the containing SignedData structure. While it is recommended that the sender place the certificates that are to betreated astrustedroots, and a set ofin the PKI Response, it is not required as the certificatesthat are no longer toshould betreated as trusted roots.obtainable using normal discovery techniques. Prior to accepting thechange intrustroots,anchors changes, a client MUSTdo theat least do the following:Validatevalidate the signature on themessagePKI Response to a current trustedroot,anchor, check with policy to ensure that the signer is permitted to use theattribute,control, validate that the authenticated publish time in the signature is near to the current time and validate the sequence number is greater than the previously used one.This attribute uses the following ASN.1 definition: PublishTrustRoots ::= SEQUENCE { seqNumber INTEGER, rootHashes SEQUENCE OF OCTET STRING } seqNumber contains an increasing integer specifying where in the sequence of updates this item is. rootHashes contains the hashes for the certificates that are to be treated as trust roots by the client. While it is recommended that the sender places the certificates that are to be trusted in the message, it is not required as the certificates should be obtainable using normal discovery techniques.In the event that multiple agents publish a set of trustlists,anchors, it is up to local policy to determine how the different trustlistsanchors should be combined. Clients SHOULD be able to handle the update oftrust listsmultiple trustlistanchors independently. NOTE: Clientswhichthat handle thisattributecontrol must use extreme care in validating that the operation is permissible. Incorrect handling of thisattributecontrol allows for an attacker to change the set oftrusted rootstrust anchors on the client.Schaad & Myers Expires September 3, 2006 [Page 45] Internet-Draft CMS: Structures March 2006 5.16. Provide Autenticated6.16. Authenticated Data Control The Authenticated DataThiscontrol allowsfor an authoritya server to provide data back to theuserclient in an authenticated manner.In general, one would expectThis control uses the Authenticated Data structure to allow for validation of the data. This control is used where the client has a shared-secret and a secret identifier with the server, but where a trust anchor has not Schaad & Myers Expires May 22, 2008 [Page 58] Internet-Draft CMC: Structures November 2007 yet been downloaded onto the client so that a signing certificate for thesame passphraseserver cannot be validated. The specific case that this control was created for use with the Publish Trust Anchors control Section 6.15, but may be used in other cases as well. The Authenticated Data control is identified by theidentity proof operation. This attribute usesOID: id-cmc-authData ::= { id-cmc 27 } The Authenticated Data control has thefollowingASN.1 definition: AuthPublish ::= BodyPartIDThe bodyPartIDAuthPublish is a body part identifier that refers to a member of the cmsSequenceeither a ResponseBodyelement for the current PKI Response orPKIData sequence.PKI Data. The cmsSequence elementwithin theis AuthenticatedData. The encapsulated content is anAuthenticatedData structure with a id-cct-PKIData content. Onlyid-cct-PKIData, there will then be controls in theid-Publish-Roots control is currently expectedcontrolSequence that would need to bein this sequence.processed (one example being the Publish Trust Anchors control Section 6.15). If the authentication operation fails, theerrorCMCFailInfo authDataFail is returned.5.17.6.17. BatchProcess Identification With the processing rules on message bodies, items which have been batchedRequest and Response Controls These controls allow for an RA to collect multiple requests togethermust be identified as such. Additionallyinto a single Full PKI Request and forward it to a CA. The server would then process thereturned batched responses must also be identified as such.requests and return the results in a Full PKI Response. ThebatchRequestsBatch Request controlattributeisused to identify the elements inidentified by thecmsSequence section that contain batched up requests to be processed.OID: id-cmc-batchRequests ::= {id-cmc 28} ThebatchResponsesBatch Response controlattributeisused to identify the set of elements inidentified by thecmsSequence which correspond to batched responses. When a server processes a batchRequests control, it may returnOID: id-cmc-batchResponses ::= {id-cmc 29} Both theitems being processed either as individual messages or in a batched response (identifyingBatch Request and Batch Response controls have theelementsASN.1 definition: BodyPartList ::= SEQUENCE of BodyPartID The data associated with these controls is abatchResponses control).set of body part identifiers. Thepreferable behavior is to batch the responses back tocollection of requests/responses are individually placed in theclient submittingcmsSequence of thebatched request. If only partial responses can be generated at this time,PKIData/PKIResponse. The body part identifiers of these elements are then placed in the body part list. Schaad & Myers Expires May 22, 2008 [Page 59] Internet-Draft CMC: Structures November 2007 When a serverSHOULD generateprocesses abatchResponse with complete responses where available and QueryPendingBatch Request control, it MAY return the responseswhere a complete response is not ready.in one or more PKI Responses. AQueryPending responsesCMCStatus value of partial is returned on all but theentire request SHOULD onlylast PKI Response. The CMCStatus would bereturnedsuccess ifprocessing based on the top level message itself (or onthestatus ofBatch Requests control was processed, therequestor) is involved inresponses are created with their own CMCStatus code. Errors on individual requests are not propagated up to thepending processing. 5.18.top level. 6.18. Publication Information ControlThisThe Publication Information control allows for modifying publication of already issued certificates, both for publishing and removal from publication. A common usage for this control is to remove an existing certificateSchaad & Myers Expires September 3, 2006 [Page 46] Internet-Draft CMS: Structures March 2006from publication during a re-key operation. This control should always be processed after the issuance of new certificates and revocation requests. This control should not be processed if a certificate failed to be issued. Theattribute usesPublication Information control is identified by the OID: id-cmc-publishCert ::= { id-cmc 30 } The Publication Information control has thefollowingASN.1 definition: CMCPublicationInfo ::= SEQUENCE { hashAlg AlgorithmIdentifier, certHashes SEQUENCE of OCTET STRING, pubInfo PKIPublicationInfo PKIPublicationInfo ::= SEQUENCE { action INTEGER { dontPublish (0), pleasePublish (1) }, pubInfos SEQUENCE SIZE (1..MAX) OF SinglePubInfo OPTIONAL } -- pubInfos MUST NOT be present if action is "dontPublish" -- (if action is "pleasePublish" and pubInfos is omitted, -- "dontCare" is assumed) SinglePubInfo ::= SEQUENCE { pubMethod INTEGER { dontCare (0), x500 (1), web (2), ldap (3) }, pubLocation GeneralName OPTIONAL } } The fields in CMCPublicationInfo have the following meaning: Schaad & Myers Expires May 22, 2008 [Page 60] Internet-Draft CMC: Structures November 2007 hashAlg is the algorithm identifier of the hash algorithm used to compute the values in certHashes. certHashescontainsare the hashes of the certificates for which publication is tochangechange. pubInfocontainsis the information where and how the certificates should be published. The fields in pubInfo (taken from [CRMF]) have the following meanings: action indicates the action the service should take. It has two values: dontPublish indicates that the PKI should not publish the certificate (this may indicate that theinformation how where and howrequester intends to publish thecertificates should be published. The actioncertificate him/herself). dontPublish has the added connotation ofremoveremoving from publicationifthe certificate if it is already published. pleasePublish indicates that the PKI MAY publish the certificate using whatever means it chooses unless pubInfos is present. Omission of the the CMC Publication Info control results in the same behavior. pubInfos pubInfos indicates how (e.g., X500, Web, IP Address) the PKI SHOULD publish the certificate. A single certificate SHOULD NOT appear in more than oneCMCPublicationInfo attribute.Publication Information control. The behavior is undefined in the event that it does. 6.19. Control Processed Control ThePKIPublicationInfo control is used to control publication of certificates at the time of issue. 5.19.Control ProcessedThiscontrolexists to allowallows an RA tosingleindicate to subsequentprocessors of thecontrolsectionsprocessors that a specific control has already been processed. This permits an RA in the middle of a processing stream to process a control defined either in a local context or in a subsequent document.ThisThe Control Processed controlusesis identified by the OID: id-cmc-controlProcessed ::= { id-cmc 32 } The Control Processed control has thefollowingASN.1definition::definition: ControlList ::= SEQUENCE { bodyList SEQUENCE SIZE (1..MAX) OF BodyPartReference|} Schaad & Myers Expires May 22, 2008 [Page 61] Internet-Draft CMC: Structures November 2007 bodyListcontainsis a series of body part identifiers that form a path to each of the controls that were processed by the RA. This control is only needed for those controls which are not part of this standard and thus would cause an error condition of a server attempting to deal with a control which is not defined in this document. No error status is needed since an error causes the RA to return the request to the client with the error rather than passing the request on to the next server in the processing list. Schaad & Myers ExpiresSeptember 3, 2006May 22, 2008 [Page47]62] Internet-DraftCMS:CMC: StructuresMarch 2006 6. LocalNovember 2007 7. Registration Authorities This specification permits the use ofLocal Registration Authorities (LRAs).RAs. AnLRARA sits between theend-entityEE and theCertification Authority.CA. From theend-entity'sEE's perspective, theLRARA appears to be theCertification AuthorityCA and from the server theLRARA appears to be a client.LRAsRAs receive theenrollment messages,PKI Requests, perform local processing and then forward them ontoCertificate Authorities.CAs. Some of the types of local processing that anLRARA can perform include: obatchingBatching multipleenrollment messagesPKI Requests together, o Performing challenge/response POP proofs, oaddition ofAdding private or standardized certificate extensions to all certification requests, oarchival ofArchiving private key material, orouting ofRouting requests to different CAs. When anLRARA receivesan enrollment messagea PKI Request it has three options: it may forward themessagePKI Request without modification, it may add a new wrapping layer to themessage,PKI Request, or it may remove one or more existing layers and add a new wrapping layer. When anLRARA adds a new wrapping layer to amessagePKI Request it creates a newPKIData object.PKIData. The new layer contains anycontrol attributescontrols required (for example if theLRARA does the POP proof for an encryption key or theaddExtensionAdd Extension controlattributeto modifyan enrollment request)a PKI Request) and the clientenrollment message.PKI Request. The clientenrollment messagePKI Request is placed in the cmsSequence if it is a FullEnrollment messagePKI Request and in the reqSequence if it is a SimpleEnrollment message.PKI Request. If anLRARA is batching multiple clientmessagesPKI Requests together, then each clientenrollment messagePKI Request is placed into the appropriate location in theLRA'sRA's PKIData object along with all relevantcontrol attributes. (Ifcontrols. If multipleLRAsRAs are in the path between theend-entityEE and theCertification Authority,CA, this will lead to multiple wrapping layers on themessage.)request. In processing a PKI Request, anenrollment message, an LRARA MUST NOT alter anycertificate request bodycertification requests (PKCS #10 or CRMF) as any alteration would invalidate the signature on the certification request and thus the POP for the private key. An example of how this would look is illustrated by the following figure: Schaad & Myers ExpiresSeptember 3, 2006May 22, 2008 [Page48]63] Internet-DraftCMS:CMC: StructuresMarch 2006November 2007 SignedData (byLRA)RA) PKIData controlSequenceLRARA added control statements reqSequence Zero or more SimpleCertificationRequestsPKI Requests from clients cmsSequence Zero or more Full PKImessagesRequests from clients SignedData(by(signed by client) PKIData Under some circumstances anLRARA is required to remove wrapping layers. The following sections look at the processing required if encryption layers and signing layers need to be removed.6.1.7.1. Encryption Removal There are two cases that require anLRARA to remove or change encryption inan enrollment message.a PKI Request. In the first case the encryption was applied for the purposes of protecting the entireenrollment requestPKI Request from unauthorized entities. If the CA does not have arecipient infoRecipient Info entry in the encryption layer, theLRARA MUST remove the encryption layer. TheLRARA MAY add a new encryption layer with or without adding a new signing layer. The second change of encryption that may be required is to change the encryption inside of a signing layer. In this case theLRARA MUST remove all signing layers containing the encryption. All control statements MUST be merged according to local policy rules as each signing layer is removed and the resulting merged controls MUST be placed in a new signing layer provided by theLRA.RA. If the signing layer provided by theend-entityEE needs to also beremoved toremoved, theLRARA can also removethethis layer.6.2.7.2. Signature Layer Removal Only two instances exist where anLRARA should remove a signature layer on a FullEnrollment message.PKI Request. If an encryption layer needs to be modified within themessage,request, or if aCertificate AuthorityCA will not accept secondary delegation(i.e.(i.e., multipleLRARA signatures). In all othersituations LRAssituations, RAs SHOULD NOT remove a signing layer from amessage.PKI Request. If anLRARA removes a signing layer from amessage,PKI Request, all control statements MUST be merged according to local policy rules. The resulting merged control statements MUST be placed in a new signing layer provided by theLRA.RA. Schaad & Myers ExpiresSeptember 3, 2006May 22, 2008 [Page49]64] Internet-DraftCMS:CMC: StructuresMarch 2006 7.November 2007 8. Security Considerations Initiation of a secure communications channel between an end-entity and a CA orLRARA (and, similarly, between anLRARA and anotherLRARA or CA) necessarily requires an out-of-band trust initiation mechanism. For example, a secure channel may be constructed between theend- entityend-entity and the CA viaIPSECIPsec [IPsec] orTLS.TLS [TLS]. Many such schemes exist and the choice of any particular scheme for trust initiation is outside the scope of this document. Implementers of this protocol are strongly encouraged to consider generally accepted principles of secure key management when integrating this capability within an overall security architecture. Mechanisms for thwarting replay attacks may be required in particular implementations of this protocol depending on the operational environment. In cases where the CA maintains significant state information, replay attacks may be detectable without the inclusion of the optional nonce mechanisms. Implementers of this protocol need to carefully consider environmental conditions before choosing whether or not to implement the senderNonce and recipientNonceattributescontrols described insection 5.6.Section 6.6. Developers of state-constrained PKI clients are strongly encouraged to incorporate the use of theseattributes. Under no circumstances shouldcontrols. Extreme care needs to be taken when archiving a signing key. The holder of the archived keybe archived. Doing so allowsmay have thearchiving entityability topotentiallyuse the keyfor forgingto generate forged signatures. There are however reasons why a signing key should be archived. An archived CA signing key can be recovered in the event of failure to continue to produced CRLs following a disaster. Due care must be taken prior to archiving keys. Once a key is given to an archiving entity, the archiving entity could use the keys in a way not conducive to the archiving entity. Users should be made especially aware that proper verification is made of the certificate used to encrypt the private key material. Clients and servers need to do some checks on cryptographic parameters prior to issuing certificates to make sure that weak parameters are not used. A description of the small subgroup attack is provided in [X942]. Methods of avoiding the small subgroup attack can be found in [SMALL-GROUP]. CMC implementations ought to be aware of this attack when doing parameter validations. When using a shared-secret for authentication purposes, the shared- secret should be generated using good random numbertechniques.techniques [RANDOM]. User selection of the secret allows for dictionary attacks to be mounted. Schaad & Myers Expires May 22, 2008 [Page 65] Internet-Draft CMC: Structures November 2007 Extreme care must be used when processing the Publish TrustRoots attribute.Anchors control. Incorrect processing can lead to thepractice of slamming where an attacker changespractice of slamming where an attacker changes the set of trusted anchors in order to weaken security. One method of controlling the use of the Publish Trust Anchors control is as follows. The client needs to associate with each trust anchor accepted by the client the source of the trust anchor. Additionally the client should associate with each trust anchor the types of messages that the trust anchor is valid for. (I.e., is the trust anchor used for validating S/MIME messages, TLS or CMC enrollment messages.) When a new message is received with a Publish Trust Anchor control, the client would accept the set of new trust anchors for specific applications only if the signature validates, the signer of the message has the required policy approval for updating the trust anchors and local policy also would allow updating theset of trusted roots in order to weaken Schaad & Myers Expires September 3, 2006 [Page 50] Internet-Draft CMS: Structures March 2006 security.trust anchors. Schaad & Myers ExpiresSeptember 3, 2006May 22, 2008 [Page51]66] Internet-DraftCMS:CMC: StructuresMarch 2006 8.November 2007 9. IANA Considerations This document defines a number of control objects. These are identified by Object Identifiers (OIDs). The objects are defined from an arc delegated by IANA to the PKIX Working Group. No further action by IANA is necessary for this document or any anticipated updates. Schaad & Myers ExpiresSeptember 3, 2006May 22, 2008 [Page52]67] Internet-DraftCMS:CMC: StructuresMarch 2006 9.November 2007 10. Acknowledgments The authors and the PKIX Working Group aregreatfulgrateful for the participation of Xiaoui Lui and Jeff Weinstein in helping to author the original versions of this document. The authors would like to thank Brian LaMacchia for his work in developing and writing up many of the concepts presented in this document. The authors would also like to thank Alex Deacon and Barb Fox for their contributions. Schaad & Myers ExpiresSeptember 3, 2006May 22, 2008 [Page53]68] Internet-DraftCMS:CMC: StructuresMarch 2006 10.November 2007 11. References10.1.11.1. Normative References [CMS] Housley, R., "Cryptographic Message Syntax (CMS)", RFC 3852, July 2004. [CRMF] Schaad, J., "Internet X.509CertificateCertification RequestmessageMessage Format", RFC 4211, January 2005. [DH-POP] Prafullchandra, H. and J. Schaad, "Diffie-Hellman Proof- of-Possession Algorithms", RFC 2875, June 2000. [HMAC] Krawczyk, H., Bellare, M., and R. Canetti, "Diffie-Hellman Proof-of-Possession Algorithms", RFC 2104, February 1997. [PKCS10] Kaliski, B., "PKCS #10: Certification Request Syntax v1.5", RFC 2314, October 1997. [PKIXCERT] Housley, R., Ford, W., Polk, W., and D. Solo, "Internet X.509 Public Key Infrastructure Certificate and Certificate Revocation List (CRL) Profile", RFC 3280, April 2002. [RFC2119] Bradner, S., "Key words for use in RFCs to Indicate Requirement Levels", RFC 2119, BCP 14, March 1997.10.2.11.2. Informational References [CMC-TRANS] Schaad, J. and M. Myers, "CMC Transport", draft-ietf-pkix-cmc-trans-00.txt , December 2004. [CMC-MUST] Schaad, J. and M. Myers, "CMC Compliance", draft-ietf-pkix-cmc-must-00.txt , December 2004. [DH] Kaliski, B., "PKCS 3: Diffie-Hellman Key Agreement v1.4", Lost 1900. [IPsec] Kent, S. and K. Seo, "Security Architecture for the Internet Protocol", RFC 4301, December 2005. [PASSWORD] Burr, W., Dodson, D., and W. Polk, "Electronic Authentication Guideline", NIST SP 800-63, April 2006. Schaad & Myers Expires May 22, 2008 [Page 69] Internet-Draft CMC: Structures November 2007 [PKCS1] Kaliski, B., "PKCS #1: RSA Encryption, Version 1.5", PKCS #1, March 1998. [PKCS7] Kaliski, B., "PKCS #7: Cryptographic Message Syntax v1.5", RFC 2315, October 1997. [PKCS8] Laboratories, RSA., "PKCS#8: Private-Key Information Syntax Standard, Version 1.2", November 1993.[PKCS10] Kaliski, B., "PKCS #10: Certification Request Syntax v1.5",[RANDOM] Eastlake, 3rd, D., Schiller, J., and S. Crocker, ""Randomness Requirements for Security", BCP 106, RFC2314, October 1997.4086, June 2005. [SMALL-GROUP] Zuccherato, R., "Methods for Avoiding the "Small-Subgroup" Attacks on the Diffie-Hellman Key Agreement Method for S/MIME", RFC 2785, March 2000. [SMIMEV2] Dusse, S., Hoffman, P., Ramsdell, B., Lundblade, L., andSchaad & Myers Expires September 3, 2006 [Page 54] Internet-Draft CMS: Structures March 2006L. Repka, "S/MIME Version 2 Message Specification", RFC 2311, March 1998. [SMIMEV3] Ramsdell, B., "S/MIME Version 3 Message Specification", RFC2633, June 1999.3851, July 2004. [TLS] Dierks, T. and E. Rescorla, "The Transport Layer Security (TLS) Protocol Version 1.1", RFC 4346, April 2006. [X942] Rescorla, E., "Diffie-Hellman Key Agreement Method", RFC 2631, June 1999. [RFC2797] Myers, M., Liu, X., Schaad, J., and J. Weinstein, "Certificate Management Messages over CMS", RFC 2797, April 2000. Schaad & Myers ExpiresSeptember 3, 2006May 22, 2008 [Page55]70] Internet-DraftCMS:CMC: StructuresMarch 2006November 2007 Appendix A. ASN.1 Module EnrollmentMessageSyntax { iso(1) identified-organization(3) dod(4) internet(1) security(5) mechansims(5) pkix(7) id-mod(0) id-mod-cmc2002(23) } DEFINITIONS IMPLICIT TAGS::::= BEGIN -- EXPORTS All -- -- The types and values defined in this module are exported for use -- in the other ASN.1 modules. Other applications may use them for -- their own purposes. IMPORTS -- PKIX Part 1 - Implicit From [PKIXCERT] CertificateSerialNumber, GeneralName, CRLReason, ReasonFlags FROM PKIX1Implicit88 {iso(1) identified-organization(3) dod(6) internet(1) security(5) mechanisms(5) pkix(7) id-mod(0) id-pkix1-implicit(19)} -- PKIX Part 1 - Explicit From [PKIXCERT] AlgorithmIdentifier, Extension, Name FROM PKIX1Explicit88 {iso(1) identified-organization(3) dod(6) internet(1) security(5) mechanisms(5) pkix(7) id-mod(0) id-pkix1-explicit(18)} -- Cryptographic Message Syntax FROM [CMS] ContentInfo, Attribute, IssuerAndSerialNumber FROM CryptographicMessageSyntax2004 {1 2 840 113549 1 9 16 0 24}iso(1) member-body(2) usa(840) rsadsi(113549) pkcs(1) pkcs-9(9) smime(16) modules(0) cms-2004(24)} -- CRMF FROM [CRMF] CertReqMsg, PKIPublicationInfo FROM PKIXCRMF {iso(1) identified-organization(3) dod(6) internet(1) security(5) mechanisms(5) pkix(7) id-mod(0) id-mod-crmf(5)}; -- Global Types UTF8String ::= [UNIVERSAL 12] IMPLICIT OCTET STRING -- The content of this type conforms to RFC 2279. id-pkix OBJECT IDENTIFIER ::= { iso(1) identified-organization(3) dod(6) internet(1) security(5) mechanisms(5) pkix(7) } Schaad & Myers Expires May 22, 2008 [Page 71] Internet-Draft CMC: Structures November 2007 id-cmc OBJECT IDENTIFIER ::= {id-pkix 7} -- CMC controls id-cct OBJECT IDENTIFIER ::= {id-pkix 12} -- CMC content typesSchaad & Myers Expires September 3, 2006 [Page 56] Internet-Draft CMS: Structures March 2006-- The following controls have the type OCTET STRING id-cmc-identityProof OBJECT IDENTIFIER ::= {id-cmc 3} id-cmc-dataReturn OBJECT IDENTIFIER ::= {id-cmc 4} id-cmc-regInfo OBJECT IDENTIFIER ::= {id-cmc 18} id-cmc-responseInfo OBJECT IDENTIFIER ::= {id-cmc 19} id-cmc-queryPending OBJECT IDENTIFIER ::= {id-cmc 21} id-cmc-popLinkRandom OBJECT IDENTIFIER ::= {id-cmc 22} id-cmc-popLinkWitness OBJECT IDENTIFIER ::= {id-cmc 23} -- The following controls have the type UTF8String id-cmc-identification OBJECT IDENTIFIER ::= {id-cmc 2} -- The following controls have the type INTEGER id-cmc-transactionId OBJECT IDENTIFIER ::= {id-cmc 5} -- The following controls have the type OCTET STRING id-cmc-senderNonce OBJECT IDENTIFIER ::= {id-cmc 6} id-cmc-recipientNonce OBJECT IDENTIFIER ::= {id-cmc 7} -- This is the content type used for a request message in the protocol id-cct-PKIData OBJECT IDENTIFIER ::= { id-cct 2 } PKIData ::= SEQUENCE { controlSequence SEQUENCE SIZE(0..MAX) OF TaggedAttribute, reqSequence SEQUENCE SIZE(0..MAX) OF TaggedRequest, cmsSequence SEQUENCE SIZE(0..MAX) OF TaggedContentInfo, otherMsgSequence SEQUENCE SIZE(0..MAX) OF OtherMsg } bodyIdMax INTEGER ::= 4294967295 BodyPartID ::= INTEGER(0..bodyIdMax) TaggedAttribute ::= SEQUENCE { bodyPartID BodyPartID, attrType OBJECT IDENTIFIER, attrValues SET OF AttributeValue }AttributeValue ::= ANYSchaad & Myers ExpiresSeptember 3, 2006May 22, 2008 [Page57]72] Internet-DraftCMS:CMC: StructuresMarch 2006November 2007 AttributeValue ::= ANY TaggedRequest ::= CHOICE { tcr [0] TaggedCertificationRequest, crm [1] CertReqMsg, orm [2] SEQUENCE { bodyPartID BodyPartID, requestMessageType OBJECT IDENTIFIER, requestMessageValue ANY DEFINED BY requestMessageType } } TaggedCertificationRequest ::= SEQUENCE { bodyPartID BodyPartID, certificationRequest CertificationRequest } CertificationRequest ::= SEQUENCE { certificationRequestInfo SEQUENCE { version INTEGER, subject Name, subjectPublicKeyInfo SEQUENCE { algorithm AlgorithmIdentifier, subjectPublicKey BIT STRING }, attributes [0] IMPLICIT SET OF Attribute }, signatureAlgorithm AlgorithmIdentifier, signature BIT STRING } TaggedContentInfo ::= SEQUENCE { bodyPartID BodyPartID, contentInfo ContentInfo } OtherMsg ::= SEQUENCE { bodyPartID BodyPartID, otherMsgType OBJECT IDENTIFIER, otherMsgValue ANY DEFINED BY otherMsgType } -- This defines the response message in the protocol id-cct-PKIResponse OBJECT IDENTIFIER ::= { id-cct 3 } ResponseBody ::= PKIResponse PKIResponse ::= SEQUENCE { controlSequence SEQUENCE SIZE(0..MAX) OF TaggedAttribute, cmsSequence SEQUENCE SIZE(0..MAX) OF TaggedContentInfo, otherMsgSequence SEQUENCE SIZE(0..MAX) OF OtherMsg Schaad & Myers Expires May 22, 2008 [Page 73] Internet-Draft CMC: Structures November 2007 } -- Used to return status state in a responseSchaad & Myers Expires September 3, 2006 [Page 58] Internet-Draft CMS: Structures March 2006id-cmc-statusInfo OBJECT IDENTIFIER ::= {id-cmc 1} CMCStatusInfo ::= SEQUENCE { cMCStatus CMCStatus, bodyList SEQUENCE SIZE (1..MAX) OF BodyPartID, statusString UTF8String OPTIONAL, otherInfo CHOICE { failInfo CMCFailInfo, pendInfo PendInfo } OPTIONAL } PendInfo ::= SEQUENCE { pendToken OCTET STRING, pendTime GeneralizedTime } CMCStatus ::= INTEGER { success (0),-- you got exactly what you asked for -- reserved (1), -- use is deprecated. failed (2), -- you don't get it, more information elsewhere in the message pending (3), -- the request body part has not yet been processed, -- requester is responsible to poll back on thisfailed (2), pending (3), noSupport (4),-- the requested operation is not supportedconfirmRequired (5),-- confirmation using the confirmCertAcceptance control is -- requiredpopRequired(6) -- A certificate request requires an indirect POP operation. -- Info for the indirect POP in this message.(6), partial (7) } CMCFailInfo ::= INTEGER { badAlg (0),-- Unrecognized or unsupported algorithmbadMessageCheck (1),-- integrity check failedbadRequest (2),-- transaction not permitted or supportedbadTime (3),-- Message time field was not sufficiently close to the systemtimebadCertId (4),-- No certificate could be identified matching the provided criteriaunsuportedExt (5),-- A requested X.509 extension is not supported by the recipient CA. Schaad & Myers Expires September 3, 2006 [Page 59] Internet-Draft CMS: Structures March 2006mustArchiveKeys (6),-- Private key material must be suppliedbadIdentity (7),-- Identification Attribute failed to verifypopRequired (8),-- Server requires a POP proof before issuing certificatepopFailed (9),-- Server failed to get an acceptable POP for the requestnoKeyReuse (10),-- Server policy does not allow key re-useinternalCAError (11), tryLater (12), authDataFail (13)-- Failure occurred during processing of authenticated data} -- Used forLRAsRAs to add extensions tocertificatecertification requests Schaad & Myers Expires May 22, 2008 [Page 74] Internet-Draft CMC: Structures November 2007 id-cmc-addExtensions OBJECT IDENTIFIER ::= {id-cmc 8} AddExtensions ::= SEQUENCE { pkiDataReference BodyPartID, certReferences SEQUENCE OF BodyPartID, extensions SEQUENCE OF Extension } id-cmc-encryptedPOP OBJECT IDENTIFIER ::= {id-cmc 9} id-cmc-decryptedPOP OBJECT IDENTIFIER ::= {id-cmc 10} EncryptedPOP ::= SEQUENCE { request TaggedRequest, cms ContentInfo, thePOPAlgID AlgorithmIdentifier, witnessAlgID AlgorithmIdentifier, witness OCTET STRING } DecryptedPOP ::= SEQUENCE { bodyPartID BodyPartID, thePOPAlgID AlgorithmIdentifier, thePOP OCTET STRING } id-cmc-lraPOPWitness OBJECT IDENTIFIER ::= {id-cmc 11} LraPopWitness ::= SEQUENCE { pkiDataBodyid BodyPartID, bodyIds SEQUENCE OF BodyPartIDSchaad & Myers Expires September 3, 2006 [Page 60] Internet-Draft CMS: Structures March 2006} -- id-cmc-getCert OBJECT IDENTIFIER ::= {id-cmc 15} GetCert ::= SEQUENCE { issuerName GeneralName, serialNumber INTEGER } id-cmc-getCRL OBJECT IDENTIFIER ::= {id-cmc 16} GetCRL ::= SEQUENCE { issuerName Name, cRLName GeneralName OPTIONAL, time GeneralizedTime OPTIONAL, Schaad & Myers Expires May 22, 2008 [Page 75] Internet-Draft CMC: Structures November 2007 reasons ReasonFlags OPTIONAL } id-cmc-revokeRequest OBJECT IDENTIFIER ::= {id-cmc 17} RevokeRequest ::= SEQUENCE { issuerName Name, serialNumber INTEGER, reason CRLReason, invalidityDate GeneralizedTime OPTIONAL, passphrase OCTET STRING OPTIONAL, comment UTF8String OPTIONAL } id-cmc-confirmCertAcceptance OBJECT IDENTIFIER ::= {id-cmc 24} CMCCertId ::= IssuerAndSerialNumber -- The following is used to request V3 extensions be added to a certificate id-ExtensionReq OBJECT IDENTIFIER ::= {iso(1) member-body(2) us(840) rsadsi(113549) pkcs(1) pkcs-9(9) 14} ExtensionReq ::= SEQUENCE SIZE (1..MAX) OF Extension -- The following exists to allow Diffie-HellmanCertificateCertification Requests Messages tobe-- be well-formed id-alg-noSignature OBJECT IDENTIFIER ::= {id-pkix id-alg(6) 2} NoSignatureValue ::= OCTET STRING -- Unauthenticated attribute to carry removable data.Schaad & Myers Expires September 3, 2006 [Page 61] Internet-Draft CMS: Structures March 2006-- This will be used in the key archive draft among others. id-aa OBJECT IDENTIFIER ::= { iso(1) member-body(2) us(840) rsadsi(113549) pkcs(1) pkcs-9(9) smime(16) id-aa(2)} id-aa-cmc-unsignedData OBJECT IDENTIFIER ::= {id-aa 34} CMCUnsignedData ::= SEQUENCE { bodyPartPathSEQUENCE SIZE (1..MAX) OF BodyPartID,BodyPartPath, identifier OBJECT IDENTIFIER, content ANY DEFINED BY identifier } -- Replaces CMC Status Info --id-cmc-statusInfoExid-cmc-statusInfoV2 OBJECT IDENTIFIER ::= {id-cmc 25}CMCStatusInfoExSchaad & Myers Expires May 22, 2008 [Page 76] Internet-Draft CMC: Structures November 2007 CMCStatusInfoV2 ::= SEQUENCE { cMCStatus CMCStatus, bodyList SEQUENCE SIZE (1..MAX) OF BodyPartReference, statusString UTF8String OPTIONAL, otherInfo CHOICE { failInfo CMCFailInfo, pendInfo PendInfo, extendedFailInfo SEQUENCE { failInfoOID OBJECT IDENTIFIER, failInfoValue AttributeValue } } OPTIONAL } BodyPartReference ::= CHOICE { bodyPartID BodyPartID, bodyPartPath BodyPartPath } BodyPartPath ::= SEQUENCE SIZE (1..MAX) OF BodyPartID}-- Allow for distribution of trustrootsanchors --id-cmc-trustedRootsid-cmc-trustedAnchors OBJECT IDENTIFIER ::= {id-cmc 26}PublishTrustRootsPublishTrustAnchors ::= SEQUENCE { seqNumber INTEGER,rootHasheshashAlgorithm AlgorithmIdentifier, anchorHashes SEQUENCE OF OCTET STRING } id-cmc-authData OBJECT IDENTIFIER ::= {id-cmc 27}Schaad & Myers Expires September 3, 2006 [Page 62] Internet-Draft CMS: Structures March 2006AuthPublish ::= BodyPartID -- These two items use BodyPartList id-cmc-batchRequests OBJECT IDENTIFIER ::= {id-cmc 28} id-cmc-batchResponses OBJECT IDENTIFIER ::= {id-cmc 29} BodyPartList ::= SEQUENCE SIZE (1..MAX) OF BodyPartID -- id-cmc-publishCert OBJECT IDENTIFIER ::= {id-cmc 30} CMCPublicationInfo ::= SEQUENCE { Schaad & Myers Expires May 22, 2008 [Page 77] Internet-Draft CMC: Structures November 2007 hashAlg AlgorithmIdentifier, certHashes SEQUENCE of OCTET STRING, pubInfo PKIPublicationInfo } id-cmc-modCertTemplate OBJECT IDENTIFIER ::= {id-cmc 31} ModCertTemplate ::= SEQUENCE { pkiDataReferenceBodyPartList,BodyPartPath, certReferencesSEQUENCE OF BodyPartID,BodyPartList, replace BOOLEAN DEFAULT TRUE, certTemplate CertTemplate } -- Inform follow on servers that one or more controls have already been processed id-cmc-controlProcessed OBJECT IDENTIFIER ::= {id-cmc 32} ControlsProcessed ::= SEQUENCE { bodyList SEQUENCE SIZE(1..MAX) OF BodyPartReference } -- Identity Proof control w/ algorithm agility id-cmc-identityProofV2 ::= { id-cmc 33 } IdentifyProofV2 ::= SEQUENCE { proofAlgID AlgorithmIdentifier, macAlgId AlgorithmIdentifier, witness OCTET STRING } id-cmc-popLinkWitnessV2 ::= { id-cmc XX } PopLinkWitnessV2 ::= SEQUENCE { keyGenAlgorithm AlgorithmIdentifier, macAlgorithm AlgorithmIdentifier, witness OCTET STRING } END Schaad & Myers ExpiresSeptember 3, 2006May 22, 2008 [Page63]78] Internet-DraftCMS:CMC: StructuresMarch 2006November 2007 Appendix B. Enrollment Message Flows This section is informational. The purpose of this section is to present, in an abstracted version, the messages that would flow between the client and server for several different common cases. Appendix B.1. Request of a Signing Certificate This section looks at the messages that would flow in the event that an enrollment is occurring for a signing only key. If the certificate was designed for both signing and encryption, the only difference would be the key usage extension in thecertificatecertification request. Message from client to server: ContentInfo.contentType =id-SignedDataid-signedData ContentInfo.content SignedData.encapContentInfo eContentType = id-ct-PKIData eContent controlSequence {102, id-cmc-identityProof, computed value} {103, id-cmc-senderNonce, 10001} reqSequence certRequest certReqId = 201 certTemplate subject = My Proposed DN publicKey = My Public Key extensions {id-ce-subjectPublicKeyIdentifier, 1000} {id-ce-keyUsage, digitalSignature} SignedData.SignerInfos SignerInfo sid.subjectKeyIdentifier = 1000 Response from server to client: Schaad & Myers ExpiresSeptember 3, 2006May 22, 2008 [Page64]79] Internet-DraftCMS:CMC: StructuresMarch 2006November 2007 ContentInfo.contentType =id-SignedDataid-signedData ContentInfo.content SignedData.encapContentInfo eContentType = id-ct-PKIResponse eContent controlSequence {102,id-cmc-statusInfoEx,id-cmc-statusInfoV2, {success, 201}} {103, id-cmc-senderNonce, 10005} {104, id-cmc-recipientNonce, 10001} certificates Newly issued certificate Other certificates SignedData.SignerInfos Signed by CA Appendix B.2. SingleCertificateCertification Request, But Modified by RA This section looks at the messages that would flow in the event that an enrollment is has one RA in the middle of the data flow. That RA will modify thecertificatecertification request before passing it on the CA. Message from client to RA: ContentInfo.contentType =id-SignedDataid-signedData ContentInfo.content SignedData.encapContentInfo eContentType = id-ct-PKIData eContent controlSequence {102, id-cmc-identityProof, computed value} {103, id-cmc-senderNonce, 10001} reqSequence certRequest certReqId = 201 certTemplate subject = My Proposed DN publicKey = My Public Key extensions {id-ce-subjectPublicKeyIdentifier, 1000} {id-ce-keyUsage, digitalSignature} SignedData.SignerInfos SignerInfo sid.subjectKeyIdentifier = 1000 Message from RA to CA: Schaad & Myers ExpiresSeptember 3, 2006May 22, 2008 [Page65]80] Internet-DraftCMS:CMC: StructuresMarch 2006November 2007 ContentInfo.contentType =id-SignedDataid-signedData ContentInfo.content SignedData.encapContentInfo eContentType = id-ct-PKIData eContent controlSequence { 102, id-cmc-batchRequests, { 1, 2} } { 103, id-cmc-addExtensions, { {1, 201, {id-ce-certificatePolicies, anyPolicy}} {1, 201, {id-ce-subjectAltName, {extension data}} {2, XXX, {id-ce-subjectAltName, {extension data}}} cmsSequence { 1, <Message from client to RA #1> } { 2, <Message from client to RA #2> } SignedData.SignerInfos SignerInfo sid = RA key. Response from the CA to the RA: Schaad & Myers ExpiresSeptember 3, 2006May 22, 2008 [Page66]81] Internet-DraftCMS:CMC: StructuresMarch 2006November 2007 ContentInfo.contentType =id-SignedDataid-signedData ContentInfo.content SignedData.encapContentInfo eContentType = id-ct-PKIResponse eContent controlSequence {102, id-cmc-BatchResponse, {999, 998}} {102,id-cmc-statusInfoEx,id-cmc-statusInfoV2, {failed, 2, badIdentity}} cmsSequence { bodyPartID = 999 contentInfo ContentInfo.contentType =id-SignedDataid-signedData ContentInfo.content SignedData.encapContentInfo eContentType = id-ct-PKIResponse eContent controlSequence {102,id-cmc-statusInfoEx,id-cmc-statusInfoV2, {success, 201}} certificates Newly issued certificate Other certificates SignedData.SignerInfos Signed by CA } { bodyPartID = 998, contentInfo ContentInfo.contentType =id-SignedDataid-signedData ContentInfo.content SignedData.encapContentInfo eContentType = id-ct-PKIResponse eContent controlSequence {102,id-cmc-statusInfoEx,id-cmc-statusInfoV2, {failure, badAlg}} certificates Newly issued certificate Other certificates SignedData.SignerInfos Signed by CA } SignedData.SignerInfos Signed by CA Response from RA to client: Schaad & Myers ExpiresSeptember 3, 2006May 22, 2008 [Page67]82] Internet-DraftCMS:CMC: StructuresMarch 2006November 2007 ContentInfo.contentType =id-SignedDataid-signedData ContentInfo.content SignedData.encapContentInfo eContentType = id-ct-PKIResponse eContent controlSequence {102,id-cmc-statusInfoEx,id-cmc-statusInfoV2, {success, 201}} certificates Newly issued certificate Other certificates SignedData.SignerInfos Signed by CA Appendix B.3. Indirect POP for an RSA certificate This section looks at the messages that would flow in the event that an enrollment is done for an encryption only certificate using an indirect POP method. For simplicity it is assumed that thecertificatecertification requestor already has a signing only certificate The fact that a second round trip is required is implicit rather than explicit. The server determines this based on fact that no other POP exists for thecertificatecertification request. Message #1 from client to server: Schaad & Myers ExpiresSeptember 3, 2006May 22, 2008 [Page68]83] Internet-DraftCMS:CMC: StructuresMarch 2006November 2007 ContentInfo.contentType =id-SignedDataid-signedData ContentInfo.content SignedData.encapContentInfo eContentType = id-ct-PKIData eContent controlSequence {102,id-cmc-transactionID,id-cmc-transactionId, 10132985123483401} {103, id-cmc-senderNonce, 10001} {104,id-cmc-dataRetrun,id-cmc-dataReturn, <packet of binary data identifying where the key in question is.>} reqSequence certRequest certReqId = 201 certTemplate subject = <My DN from my signing cert> publicKey = My Public Key extensions {id-ce-keyUsage, keyEncipherment} popo keyEncipherment subsequentMessage SignedData.SignerInfos SignerInfo Signed by requestor's signing cert Response #1 from server to client: Schaad & Myers ExpiresSeptember 3, 2006May 22, 2008 [Page69]84] Internet-DraftCMS:CMC: StructuresMarch 2006November 2007 ContentInfo.contentType =id-SignedDataid-signedData ContentInfo.content SignedData.encapContentInfo eContentType = id-ct-PKIResponse eContent controlSequence {101,id-cmc-statusInfoEx,id-cmc-statusInfoV2, {failed, 201, popRequired}} {102,id-cmc-transactionID,id-cmc-transactionId, 10132985123483401} {103, id-cmc-senderNonce, 10005} {104, id-cmc-recipientNonce, 10001} {105, id-cmc-encryptedPOP, { request { certRequest certReqId = 201 certTemplate subject = <My DN from my signing cert> publicKey = My Public Key extensions {id-ce-keyUsage, keyEncipherment} popo keyEncipherment subsequentMessage } cms contentType = id-envelopedData content recipipentInfos.riid.issuerSerialNumber = <NULL, 201> encryptedContentInfo eContentType = id-data eContent = <Encrypted value of 'y'> thePOPAlgID = HMAC-SHA1 witnessAlgID = SHA-1 witness <hashed value of 'y'>}} {106, id-cmc-dataReturn, <packet of binary data identifying where the key in question is.>} certificates Newly issued certificate Other certificates SignedData.SignerInfos Signed by CA Schaad & Myers ExpiresSeptember 3, 2006May 22, 2008 [Page70]85] Internet-DraftCMS:CMC: StructuresMarch 2006November 2007 ContentInfo.contentType =id-SignedDataid-signedData ContentInfo.content SignedData.encapContentInfo eContentType = id-ct-PKIData eContent controlSequence {102,id-cmc-transactionID,id-cmc-transactionId, 10132985123483401} {103, id-cmc-senderNonce, 100101} {104,id-cmc-dataRetrun,id-cmc-dataReturn, <packet of binary data identifying where the key in question is.>} {105, id-cmc-recipientNonce, 10005} {107, id-cmc-decryptedPOP, { bodyPartID 201, thePOPAlgID HMAC-SHA1, thePOP <HMAC computed value goes here>}} reqSequence certRequest certReqId = 201 certTemplate subject = <My DN from my signing cert> publicKey = My Public Key extensions {id-ce-keyUsage, keyEncipherment} popo keyEncipherment subsequentMessage SignedData.SignerInfos SignerInfo Signed by requestor's signing cert Response from server to client: ContentInfo.contentType =id-SignedDataid-signedData ContentInfo.content SignedData.encapContentInfo eContentType = id-ct-PKIResponse eContent controlSequence {101,id-cmc-transactionID,id-cmc-transactionId, 10132985123483401} {102,id-cmc-statusInfoEx,id-cmc-statusInfoV2, {success, 201}} {103, id-cmc-senderNonce, 10019} {104, id-cmc-recipientNonce, 100101} {104, id-cmc-dataReturn, <packet of binary data identifying where the key in question is.>} certificates Newly issued certificate Other certificates SignedData.SignerInfos Schaad & Myers ExpiresSeptember 3, 2006May 22, 2008 [Page71]86] Internet-DraftCMS:CMC: StructuresMarch 2006November 2007 Signed by CA Schaad & Myers ExpiresSeptember 3, 2006May 22, 2008 [Page72]87] Internet-Draft CMC: Structures November 2007 Appendix C. Production of Diffie-Hellman Public Key Certification Requests Part of a certification request is a signature over the request; Diffie-Hellman is a key agreement algorithm and cannot be used to directly produce the required signature object. [DH-POP] provides two ways to produce the necessary signature value. This document also defines a signature algorithm that does not provide a POP value, but can be used to produce the necessary signature value. Appendix C.1. No-Signature Signature Mechanism Key management (encryption/decryption) private keys cannot always be used to produce some type of signature value as they can be in a decrypt only device. Certification requests require that the signature field be populated. This section provides a signature algorithm specifically for that purposes. The following object identifier and signature value are used to identify this signature type: id-alg-noSignature OBJECT IDENTIFIER ::= {id-pkix id-alg(6) 2} NoSignatureValue ::= OCTET STRING The parameters for id-alg-noSignature MUST be present and MUST be encoded as NULL. NoSignatureValue contains the hash of the certification request. It is important to realize that there is no security associated with this signature type. If this signature type is on a certification request and the Certification Authority policy requires proof-of-possession of the private key, the POP mechanism defined in Section 6.7 MUST be used. Schaad & Myers Expires May 22, 2008 [Page 88] Internet-DraftCMS:CMC: StructuresMarch 2006November 2007 AppendixC.D. Change History RFC Editor - please remove this appendix prior to publishing. RFC 27XX to -00 1. Addition ofCMCStatusInfoExExtended CMC Status Info From -00 to -01 1. Removal of Transport section to a new document. 2. Removal of Compliance section to a new document. From -01 to -02 1. Add processing rules for PKIData and PKIResponse processing. 2. Add unsigned attribute for holding data (to be used by key archival). 3. Add trust root identification control. 4. Add Server to Client identity proof method. 5. Add controls to identify batch processing, needed by rules added in item 1. From -02 to -03 1. Add unpublish control 2. Added use of AuthenticatedData structure from CMS 3. Insert Appendix B - Enrollment Message Flows 4. Add ModifyCertificateCertification Request control From -03 to -04 1. Change author list. 2. Add IANA Considerations section 3. Correct module names in ASN.1 4. Add id-cmc-controlProcessed control with associated changes. Schaad & Myers ExpiresSeptember 3, 2006May 22, 2008 [Page73]89] Internet-DraftCMS:CMC: StructuresMarch 2006November 2007 From -04 to -05 1. Change Trust Root to Trust Anchor. Schaad & Myers Expires May 22, 2008 [Page 90] Internet-Draft CMC: Structures November 2007 Authors' Addresses Jim Schaad Soaring Hawk Consulting PO Box 675 Gold Bar, WA 98251 Phone: (425) 785-1031 Email: jimsch@exmsft.com Michael Myers TraceRoute Security, Inc. Email: myers@coastside.inc Schaad & Myers ExpiresSeptember 3, 2006May 22, 2008 [Page74]91] Internet-DraftCMS:CMC: StructuresMarch 2006November 2007 Full Copyright Statement Copyright (C) The IETF Trust (2007). This document is subject to the rights, licenses and restrictions contained in BCP 78, and except as set forth therein, the authors retain all their rights. This document and the information contained herein are provided on an "AS IS" basis and THE CONTRIBUTOR, THE ORGANIZATION HE/SHE REPRESENTS OR IS SPONSORED BY (IF ANY), THE INTERNET SOCIETY, THE IETF TRUST AND THE INTERNET ENGINEERING TASK FORCE DISCLAIM 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. Intellectual PropertyStatementThe IETF takes no position regarding the validity or scope of any Intellectual Property Rights 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; nor does it represent that it has made any independent effort to identify any such rights. Information on the procedures with respect to rights in RFC documents can be found in BCP 78 and BCP 79. Copies of IPR disclosures made to the IETF Secretariat 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 implementers or users of this specification can be obtained from the IETF on-line IPR repository at http://www.ietf.org/ipr. The IETF invites any interested party to bring to its attention any copyrights, patents or patent applications, or other proprietary rights that may cover technology that may be required to implement this standard. Please address the information to the IETF at ietf-ipr@ietf.org.Disclaimer of Validity This document and the information contained herein are provided on an "AS IS" basis and THE CONTRIBUTOR, THE ORGANIZATION HE/SHE REPRESENTS OR IS SPONSORED BY (IF ANY), THE INTERNET SOCIETY AND THE INTERNET ENGINEERING TASK FORCE DISCLAIM 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. Copyright Statement Copyright (C) The Internet Society (2006). This document is subject to the rights, licenses and restrictions contained in BCP 78, and except as set forth therein, the authors retain all their rights.Acknowledgment Funding for the RFC Editor function iscurrentlyprovided by theInternet Society.IETF Administrative Support Activity (IASA). Schaad & Myers ExpiresSeptember 3, 2006May 22, 2008 [Page75]92] ----