2 * Copyright 1999-2022 The OpenSSL Project Authors. All Rights Reserved.
4 * Licensed under the Apache License 2.0 (the "License"). You may not use
5 * this file except in compliance with the License. You can obtain a copy
6 * in the file LICENSE in the source distribution or at
7 * https://www.openssl.org/source/license.html
11 #include "internal/cryptlib.h"
12 #include <openssl/pkcs12.h>
13 #include "crypto/x509.h" /* for ossl_x509_add_cert_new() */
15 /* Simplified PKCS#12 routines */
17 static int parse_pk12(PKCS12 *p12, const char *pass, int passlen,
18 EVP_PKEY **pkey, STACK_OF(X509) *ocerts);
20 static int parse_bags(const STACK_OF(PKCS12_SAFEBAG) *bags, const char *pass,
21 int passlen, EVP_PKEY **pkey, STACK_OF(X509) *ocerts,
22 OSSL_LIB_CTX *libctx, const char *propq);
24 static int parse_bag(PKCS12_SAFEBAG *bag, const char *pass, int passlen,
25 EVP_PKEY **pkey, STACK_OF(X509) *ocerts,
26 OSSL_LIB_CTX *libctx, const char *propq);
29 * Parse and decrypt a PKCS#12 structure returning user key, user cert and
30 * other (CA) certs. Note either ca should be NULL, *ca should be NULL, or it
31 * should point to a valid STACK structure. pkey and/or cert may be NULL;
32 * if non-NULL the variables they point to can be passed uninitialised.
35 int PKCS12_parse(PKCS12 *p12, const char *pass, EVP_PKEY **pkey, X509 **cert,
38 STACK_OF(X509) *ocerts = NULL;
46 /* Check for NULL PKCS12 structure */
49 ERR_raise(ERR_LIB_PKCS12, PKCS12_R_INVALID_NULL_PKCS12_POINTER);
54 if (PKCS12_mac_present(p12)) {
56 * If password is zero length or NULL then try verifying both cases to
57 * determine which password is correct. The reason for this is that under
58 * PKCS#12 password based encryption no password and a zero length
59 * password are two different things...
61 if (pass == NULL || *pass == '\0') {
62 if (PKCS12_verify_mac(p12, NULL, 0))
64 else if (PKCS12_verify_mac(p12, "", 0))
67 ERR_raise(ERR_LIB_PKCS12, PKCS12_R_MAC_VERIFY_FAILURE);
70 } else if (!PKCS12_verify_mac(p12, pass, -1)) {
71 ERR_raise(ERR_LIB_PKCS12, PKCS12_R_MAC_VERIFY_FAILURE);
74 } else if (pass == NULL || *pass == '\0') {
78 /* If needed, allocate stack for other certificates */
79 if ((cert != NULL || ca != NULL)
80 && (ocerts = sk_X509_new_null()) == NULL) {
81 ERR_raise(ERR_LIB_PKCS12, ERR_R_CRYPTO_LIB);
85 if (!parse_pk12(p12, pass, -1, pkey, ocerts)) {
86 int err = ERR_peek_last_error();
88 if (ERR_GET_LIB(err) != ERR_LIB_EVP
89 && ERR_GET_REASON(err) != EVP_R_UNSUPPORTED_ALGORITHM)
90 ERR_raise(ERR_LIB_PKCS12, PKCS12_R_PARSE_ERROR);
94 /* Split the certs in ocerts over *cert and *ca as far as requested */
95 while ((x = sk_X509_shift(ocerts)) != NULL) {
96 if (pkey != NULL && *pkey != NULL
97 && cert != NULL && *cert == NULL) {
101 match = X509_check_private_key(x, *pkey);
110 if (!ossl_x509_add_cert_new(ca, x, X509_ADD_FLAG_DEFAULT))
116 sk_X509_free(ocerts);
123 EVP_PKEY_free(*pkey);
131 OSSL_STACK_OF_X509_free(ocerts);
136 /* Parse the outer PKCS#12 structure */
138 /* pkey and/or ocerts may be NULL */
139 static int parse_pk12(PKCS12 *p12, const char *pass, int passlen,
140 EVP_PKEY **pkey, STACK_OF(X509) *ocerts)
142 STACK_OF(PKCS7) *asafes;
143 STACK_OF(PKCS12_SAFEBAG) *bags;
147 if ((asafes = PKCS12_unpack_authsafes(p12)) == NULL)
149 for (i = 0; i < sk_PKCS7_num(asafes); i++) {
150 p7 = sk_PKCS7_value(asafes, i);
151 bagnid = OBJ_obj2nid(p7->type);
152 if (bagnid == NID_pkcs7_data) {
153 bags = PKCS12_unpack_p7data(p7);
154 } else if (bagnid == NID_pkcs7_encrypted) {
155 bags = PKCS12_unpack_p7encdata(p7, pass, passlen);
159 sk_PKCS7_pop_free(asafes, PKCS7_free);
162 if (!parse_bags(bags, pass, passlen, pkey, ocerts,
163 p7->ctx.libctx, p7->ctx.propq)) {
164 sk_PKCS12_SAFEBAG_pop_free(bags, PKCS12_SAFEBAG_free);
165 sk_PKCS7_pop_free(asafes, PKCS7_free);
168 sk_PKCS12_SAFEBAG_pop_free(bags, PKCS12_SAFEBAG_free);
170 sk_PKCS7_pop_free(asafes, PKCS7_free);
174 /* pkey and/or ocerts may be NULL */
175 static int parse_bags(const STACK_OF(PKCS12_SAFEBAG) *bags, const char *pass,
176 int passlen, EVP_PKEY **pkey, STACK_OF(X509) *ocerts,
177 OSSL_LIB_CTX *libctx, const char *propq)
180 for (i = 0; i < sk_PKCS12_SAFEBAG_num(bags); i++) {
181 if (!parse_bag(sk_PKCS12_SAFEBAG_value(bags, i),
182 pass, passlen, pkey, ocerts,
189 /* pkey and/or ocerts may be NULL */
190 static int parse_bag(PKCS12_SAFEBAG *bag, const char *pass, int passlen,
191 EVP_PKEY **pkey, STACK_OF(X509) *ocerts,
192 OSSL_LIB_CTX *libctx, const char *propq)
194 PKCS8_PRIV_KEY_INFO *p8;
196 const ASN1_TYPE *attrib;
197 ASN1_BMPSTRING *fname = NULL;
198 ASN1_OCTET_STRING *lkid = NULL;
200 if ((attrib = PKCS12_SAFEBAG_get0_attr(bag, NID_friendlyName)))
201 fname = attrib->value.bmpstring;
203 if ((attrib = PKCS12_SAFEBAG_get0_attr(bag, NID_localKeyID)))
204 lkid = attrib->value.octet_string;
206 switch (PKCS12_SAFEBAG_get_nid(bag)) {
208 if (pkey == NULL || *pkey != NULL)
210 *pkey = EVP_PKCS82PKEY_ex(PKCS12_SAFEBAG_get0_p8inf(bag),
216 case NID_pkcs8ShroudedKeyBag:
217 if (pkey == NULL || *pkey != NULL)
219 if ((p8 = PKCS12_decrypt_skey_ex(bag, pass, passlen,
220 libctx, propq)) == NULL)
222 *pkey = EVP_PKCS82PKEY_ex(p8, libctx, propq);
223 PKCS8_PRIV_KEY_INFO_free(p8);
230 || PKCS12_SAFEBAG_get_bag_nid(bag) != NID_x509Certificate)
232 if ((x509 = PKCS12_SAFEBAG_get1_cert_ex(bag, libctx, propq)) == NULL)
234 if (lkid && !X509_keyid_set1(x509, lkid->data, lkid->length)) {
242 len = ASN1_STRING_to_UTF8(&data, fname);
244 r = X509_alias_set1(x509, data, len);
253 if (!sk_X509_push(ocerts, x509)) {
260 case NID_safeContentsBag:
261 return parse_bags(PKCS12_SAFEBAG_get0_safes(bag), pass, passlen, pkey,
262 ocerts, libctx, propq);