2 * The contents of this file are subject to the Mozilla Public
3 * License Version 1.1 (the "License"); you may not use this file
4 * except in compliance with the License. You may obtain a copy of
5 * the License at http://www.mozilla.org/MPL/
7 * Software distributed under the License is distributed on an "AS
8 * IS" basis, WITHOUT WARRANTY OF ANY KIND, either express or
9 * implied. See the License for the specific language governing
10 * rights and limitations under the License.
12 * The Original Code is the Netscape security libraries.
14 * The Initial Developer of the Original Code is Netscape
15 * Communications Corporation. Portions created by Netscape are
16 * Copyright (C) 1994-2000 Netscape Communications Corporation. All
21 * Alternatively, the contents of this file may be used under the
22 * terms of the GNU General Public License Version 2 or later (the
23 * "GPL"), in which case the provisions of the GPL are applicable
24 * instead of those above. If you wish to allow use of your
25 * version of this file only under the terms of the GPL and not to
26 * allow others to use your version of this file under the MPL,
27 * indicate your decision by deleting the provisions above and
28 * replace them with the notice and other provisions required by
29 * the GPL. If you do not delete the provisions above, a recipient
30 * may use your version of this file under either the MPL or the
35 * CMS encryptedData methods.
38 #include <Security/SecCmsEncryptedData.h>
40 #include <Security/SecCmsContentInfo.h>
46 #include <security_asn1/secasn1.h>
47 #include <security_asn1/secerr.h>
50 * SecCmsEncryptedDataCreate - create an empty encryptedData object.
52 * "algorithm" specifies the bulk encryption algorithm to use.
53 * "keysize" is the key size.
55 * An error results in a return value of NULL and an error set.
56 * (Retrieve specific errors via PORT_GetError()/XP_GetError().)
58 SecCmsEncryptedDataRef
59 SecCmsEncryptedDataCreate(SecCmsMessageRef cmsg
, SECOidTag algorithm
, int keysize
)
62 SecCmsEncryptedDataRef encd
;
65 SECAlgorithmID
*pbe_algid
;
71 mark
= PORT_ArenaMark(poolp
);
73 encd
= (SecCmsEncryptedDataRef
)PORT_ArenaZAlloc(poolp
, sizeof(SecCmsEncryptedData
));
79 /* version is set in SecCmsEncryptedDataEncodeBeforeStart() */
82 /* XXX hmmm... hardcoded algorithms? */
84 case SEC_OID_DES_EDE3_CBC
:
86 rv
= SecCmsContentInfoSetContentEncAlg((SecArenaPoolRef
)poolp
, &(encd
->contentInfo
), algorithm
, NULL
, keysize
);
89 /* Assume password-based-encryption. At least, try that. */
95 pbe_algid
= PK11_CreatePBEAlgorithmID(algorithm
, 1, NULL
);
97 if (pbe_algid
== NULL
) {
101 rv
= SecCmsContentInfoSetContentEncAlgID((SecArenaPoolRef
)poolp
, &(encd
->contentInfo
), pbe_algid
, keysize
);
102 SECOID_DestroyAlgorithmID (pbe_algid
, PR_TRUE
);
106 if (rv
!= SECSuccess
)
109 PORT_ArenaUnmark(poolp
, mark
);
113 PORT_ArenaRelease(poolp
, mark
);
118 * SecCmsEncryptedDataDestroy - destroy an encryptedData object
121 SecCmsEncryptedDataDestroy(SecCmsEncryptedDataRef encd
)
126 /* everything's in a pool, so don't worry about the storage */
127 SecCmsContentInfoDestroy(&(encd
->contentInfo
));
132 * SecCmsEncryptedDataGetContentInfo - return pointer to encryptedData object's contentInfo
135 SecCmsEncryptedDataGetContentInfo(SecCmsEncryptedDataRef encd
)
137 return &(encd
->contentInfo
);
141 * SecCmsEncryptedDataEncodeBeforeStart - do all the necessary things to a EncryptedData
142 * before encoding begins.
145 * - set the correct version value.
146 * - get the encryption key
149 SecCmsEncryptedDataEncodeBeforeStart(SecCmsEncryptedDataRef encd
)
152 SecSymmetricKeyRef bulkkey
= NULL
;
154 SecCmsContentInfoRef cinfo
= &(encd
->contentInfo
);
156 if (SecCmsArrayIsEmpty((void **)encd
->unprotectedAttr
))
157 version
= SEC_CMS_ENCRYPTED_DATA_VERSION
;
159 version
= SEC_CMS_ENCRYPTED_DATA_VERSION_UPATTR
;
161 dummy
= SEC_ASN1EncodeInteger (encd
->cmsg
->poolp
, &(encd
->version
), version
);
165 /* now get content encryption key (bulk key) by using our cmsg callback */
166 if (encd
->cmsg
->decrypt_key_cb
)
167 bulkkey
= (*encd
->cmsg
->decrypt_key_cb
)(encd
->cmsg
->decrypt_key_cb_arg
,
168 SecCmsContentInfoGetContentEncAlg(cinfo
));
172 /* store the bulk key in the contentInfo so that the encoder can find it */
173 SecCmsContentInfoSetBulkKey(cinfo
, bulkkey
);
174 CFRelease(bulkkey
); /* This assumes the decrypt_key_cb hands us a copy of the key --mb */
180 * SecCmsEncryptedDataEncodeBeforeData - set up encryption
183 SecCmsEncryptedDataEncodeBeforeData(SecCmsEncryptedDataRef encd
)
185 SecCmsContentInfoRef cinfo
;
186 SecSymmetricKeyRef bulkkey
;
187 SECAlgorithmID
*algid
;
189 cinfo
= &(encd
->contentInfo
);
191 /* find bulkkey and algorithm - must have been set by SecCmsEncryptedDataEncodeBeforeStart */
192 bulkkey
= SecCmsContentInfoGetBulkKey(cinfo
);
195 algid
= SecCmsContentInfoGetContentEncAlg(cinfo
);
199 /* this may modify algid (with IVs generated in a token).
200 * it is therefore essential that algid is a pointer to the "real" contentEncAlg,
201 * not just to a copy */
202 cinfo
->ciphcx
= SecCmsCipherContextStartEncrypt(encd
->cmsg
->poolp
, bulkkey
, algid
);
204 if (cinfo
->ciphcx
== NULL
)
211 * SecCmsEncryptedDataEncodeAfterData - finalize this encryptedData for encoding
214 SecCmsEncryptedDataEncodeAfterData(SecCmsEncryptedDataRef encd
)
216 if (encd
->contentInfo
.ciphcx
) {
217 SecCmsCipherContextDestroy(encd
->contentInfo
.ciphcx
);
218 encd
->contentInfo
.ciphcx
= NULL
;
221 /* nothing to do after data */
227 * SecCmsEncryptedDataDecodeBeforeData - find bulk key & set up decryption
230 SecCmsEncryptedDataDecodeBeforeData(SecCmsEncryptedDataRef encd
)
232 SecSymmetricKeyRef bulkkey
= NULL
;
233 SecCmsContentInfoRef cinfo
;
234 SECAlgorithmID
*bulkalg
;
235 OSStatus rv
= SECFailure
;
237 cinfo
= &(encd
->contentInfo
);
239 bulkalg
= SecCmsContentInfoGetContentEncAlg(cinfo
);
241 if (encd
->cmsg
->decrypt_key_cb
== NULL
) /* no callback? no key../ */
244 bulkkey
= (*encd
->cmsg
->decrypt_key_cb
)(encd
->cmsg
->decrypt_key_cb_arg
, bulkalg
);
246 /* no success finding a bulk key */
249 SecCmsContentInfoSetBulkKey(cinfo
, bulkkey
);
251 cinfo
->ciphcx
= SecCmsCipherContextStartDecrypt(bulkkey
, bulkalg
);
252 if (cinfo
->ciphcx
== NULL
)
253 goto loser
; /* error has been set by SecCmsCipherContextStartDecrypt */
260 * For PKCS5 Encryption Algorithms, the bulkkey is actually a different
261 * structure. Therefore, we need to set the bulkkey to the actual key
262 * prior to freeing it.
264 if (SEC_PKCS5IsAlgorithmPBEAlg(bulkalg
)) {
265 SEC_PKCS5KeyAndPassword
*keyPwd
= (SEC_PKCS5KeyAndPassword
*)bulkkey
;
266 bulkkey
= keyPwd
->key
;
270 /* we are done with (this) bulkkey now. */
280 * SecCmsEncryptedDataDecodeAfterData - finish decrypting this encryptedData's content
283 SecCmsEncryptedDataDecodeAfterData(SecCmsEncryptedDataRef encd
)
285 if (encd
->contentInfo
.ciphcx
) {
286 SecCmsCipherContextDestroy(encd
->contentInfo
.ciphcx
);
287 encd
->contentInfo
.ciphcx
= NULL
;
294 * SecCmsEncryptedDataDecodeAfterEnd - finish decoding this encryptedData
297 SecCmsEncryptedDataDecodeAfterEnd(SecCmsEncryptedDataRef encd
)
299 /* apply final touches */