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
;
64 SECAlgorithmID
*pbe_algid
;
69 mark
= PORT_ArenaMark(poolp
);
71 encd
= (SecCmsEncryptedDataRef
)PORT_ArenaZAlloc(poolp
, sizeof(SecCmsEncryptedData
));
77 /* version is set in SecCmsEncryptedDataEncodeBeforeStart() */
80 /* XXX hmmm... hardcoded algorithms? */
82 case SEC_OID_DES_EDE3_CBC
:
84 rv
= SecCmsContentInfoSetContentEncAlg((SecArenaPoolRef
)poolp
, &(encd
->contentInfo
), algorithm
, NULL
, keysize
);
87 /* Assume password-based-encryption. At least, try that. */
92 pbe_algid
= PK11_CreatePBEAlgorithmID(algorithm
, 1, NULL
);
94 if (pbe_algid
== NULL
) {
98 rv
= SecCmsContentInfoSetContentEncAlgID((SecArenaPoolRef
)poolp
, &(encd
->contentInfo
), pbe_algid
, keysize
);
99 SECOID_DestroyAlgorithmID (pbe_algid
, PR_TRUE
);
102 if (rv
!= SECSuccess
)
105 PORT_ArenaUnmark(poolp
, mark
);
109 PORT_ArenaRelease(poolp
, mark
);
114 * SecCmsEncryptedDataDestroy - destroy an encryptedData object
117 SecCmsEncryptedDataDestroy(SecCmsEncryptedDataRef encd
)
122 /* everything's in a pool, so don't worry about the storage */
123 SecCmsContentInfoDestroy(&(encd
->contentInfo
));
128 * SecCmsEncryptedDataGetContentInfo - return pointer to encryptedData object's contentInfo
131 SecCmsEncryptedDataGetContentInfo(SecCmsEncryptedDataRef encd
)
133 return &(encd
->contentInfo
);
137 * SecCmsEncryptedDataEncodeBeforeStart - do all the necessary things to a EncryptedData
138 * before encoding begins.
141 * - set the correct version value.
142 * - get the encryption key
145 SecCmsEncryptedDataEncodeBeforeStart(SecCmsEncryptedDataRef encd
)
148 SecSymmetricKeyRef bulkkey
= NULL
;
150 SecCmsContentInfoRef cinfo
= &(encd
->contentInfo
);
152 if (SecCmsArrayIsEmpty((void **)encd
->unprotectedAttr
))
153 version
= SEC_CMS_ENCRYPTED_DATA_VERSION
;
155 version
= SEC_CMS_ENCRYPTED_DATA_VERSION_UPATTR
;
157 dummy
= SEC_ASN1EncodeInteger (encd
->cmsg
->poolp
, &(encd
->version
), version
);
161 /* now get content encryption key (bulk key) by using our cmsg callback */
162 if (encd
->cmsg
->decrypt_key_cb
)
163 bulkkey
= (*encd
->cmsg
->decrypt_key_cb
)(encd
->cmsg
->decrypt_key_cb_arg
,
164 SecCmsContentInfoGetContentEncAlg(cinfo
));
168 /* store the bulk key in the contentInfo so that the encoder can find it */
169 SecCmsContentInfoSetBulkKey(cinfo
, bulkkey
);
170 CFRelease(bulkkey
); /* This assumes the decrypt_key_cb hands us a copy of the key --mb */
176 * SecCmsEncryptedDataEncodeBeforeData - set up encryption
179 SecCmsEncryptedDataEncodeBeforeData(SecCmsEncryptedDataRef encd
)
181 SecCmsContentInfoRef cinfo
;
182 SecSymmetricKeyRef bulkkey
;
183 SECAlgorithmID
*algid
;
185 cinfo
= &(encd
->contentInfo
);
187 /* find bulkkey and algorithm - must have been set by SecCmsEncryptedDataEncodeBeforeStart */
188 bulkkey
= SecCmsContentInfoGetBulkKey(cinfo
);
191 algid
= SecCmsContentInfoGetContentEncAlg(cinfo
);
195 /* this may modify algid (with IVs generated in a token).
196 * it is therefore essential that algid is a pointer to the "real" contentEncAlg,
197 * not just to a copy */
198 cinfo
->ciphcx
= SecCmsCipherContextStartEncrypt(encd
->cmsg
->poolp
, bulkkey
, algid
);
200 if (cinfo
->ciphcx
== NULL
)
207 * SecCmsEncryptedDataEncodeAfterData - finalize this encryptedData for encoding
210 SecCmsEncryptedDataEncodeAfterData(SecCmsEncryptedDataRef encd
)
212 if (encd
->contentInfo
.ciphcx
) {
213 SecCmsCipherContextDestroy(encd
->contentInfo
.ciphcx
);
214 encd
->contentInfo
.ciphcx
= NULL
;
217 /* nothing to do after data */
223 * SecCmsEncryptedDataDecodeBeforeData - find bulk key & set up decryption
226 SecCmsEncryptedDataDecodeBeforeData(SecCmsEncryptedDataRef encd
)
228 SecSymmetricKeyRef bulkkey
= NULL
;
229 SecCmsContentInfoRef cinfo
;
230 SECAlgorithmID
*bulkalg
;
231 OSStatus rv
= SECFailure
;
233 cinfo
= &(encd
->contentInfo
);
235 bulkalg
= SecCmsContentInfoGetContentEncAlg(cinfo
);
237 if (encd
->cmsg
->decrypt_key_cb
== NULL
) /* no callback? no key../ */
240 bulkkey
= (*encd
->cmsg
->decrypt_key_cb
)(encd
->cmsg
->decrypt_key_cb_arg
, bulkalg
);
242 /* no success finding a bulk key */
245 SecCmsContentInfoSetBulkKey(cinfo
, bulkkey
);
247 cinfo
->ciphcx
= SecCmsCipherContextStartDecrypt(bulkkey
, bulkalg
);
248 if (cinfo
->ciphcx
== NULL
)
249 goto loser
; /* error has been set by SecCmsCipherContextStartDecrypt */
256 * For PKCS5 Encryption Algorithms, the bulkkey is actually a different
257 * structure. Therefore, we need to set the bulkkey to the actual key
258 * prior to freeing it.
260 if (SEC_PKCS5IsAlgorithmPBEAlg(bulkalg
)) {
261 SEC_PKCS5KeyAndPassword
*keyPwd
= (SEC_PKCS5KeyAndPassword
*)bulkkey
;
262 bulkkey
= keyPwd
->key
;
266 /* we are done with (this) bulkkey now. */
276 * SecCmsEncryptedDataDecodeAfterData - finish decrypting this encryptedData's content
279 SecCmsEncryptedDataDecodeAfterData(SecCmsEncryptedDataRef encd
)
281 if (encd
->contentInfo
.ciphcx
) {
282 SecCmsCipherContextDestroy(encd
->contentInfo
.ciphcx
);
283 encd
->contentInfo
.ciphcx
= NULL
;
290 * SecCmsEncryptedDataDecodeAfterEnd - finish decoding this encryptedData
293 SecCmsEncryptedDataDecodeAfterEnd(SecCmsEncryptedDataRef encd
)
295 /* apply final touches */