pem_pk8.c
Go to the documentation of this file.
1 /* Copyright (C) 1995-1998 Eric Young (eay@cryptsoft.com)
2  * All rights reserved.
3  *
4  * This package is an SSL implementation written
5  * by Eric Young (eay@cryptsoft.com).
6  * The implementation was written so as to conform with Netscapes SSL.
7  *
8  * This library is free for commercial and non-commercial use as long as
9  * the following conditions are aheared to. The following conditions
10  * apply to all code found in this distribution, be it the RC4, RSA,
11  * lhash, DES, etc., code; not just the SSL code. The SSL documentation
12  * included with this distribution is covered by the same copyright terms
13  * except that the holder is Tim Hudson (tjh@cryptsoft.com).
14  *
15  * Copyright remains Eric Young's, and as such any Copyright notices in
16  * the code are not to be removed.
17  * If this package is used in a product, Eric Young should be given attribution
18  * as the author of the parts of the library used.
19  * This can be in the form of a textual message at program startup or
20  * in documentation (online or textual) provided with the package.
21  *
22  * Redistribution and use in source and binary forms, with or without
23  * modification, are permitted provided that the following conditions
24  * are met:
25  * 1. Redistributions of source code must retain the copyright
26  * notice, this list of conditions and the following disclaimer.
27  * 2. Redistributions in binary form must reproduce the above copyright
28  * notice, this list of conditions and the following disclaimer in the
29  * documentation and/or other materials provided with the distribution.
30  * 3. All advertising materials mentioning features or use of this software
31  * must display the following acknowledgement:
32  * "This product includes cryptographic software written by
33  * Eric Young (eay@cryptsoft.com)"
34  * The word 'cryptographic' can be left out if the rouines from the library
35  * being used are not cryptographic related :-).
36  * 4. If you include any Windows specific code (or a derivative thereof) from
37  * the apps directory (application code) you must include an acknowledgement:
38  * "This product includes software written by Tim Hudson (tjh@cryptsoft.com)"
39  *
40  * THIS SOFTWARE IS PROVIDED BY ERIC YOUNG ``AS IS'' AND
41  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
42  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
43  * ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
44  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
45  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
46  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
47  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
48  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
49  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
50  * SUCH DAMAGE.
51  *
52  * The licence and distribution terms for any publically available version or
53  * derivative of this code cannot be changed. i.e. this code cannot simply be
54  * copied and put under another distribution licence
55  * [including the GNU Public Licence.] */
56 
57 #include <openssl/pem.h>
58 
59 #include <openssl/err.h>
60 #include <openssl/evp.h>
61 #include <openssl/mem.h>
62 #include <openssl/obj.h>
63 #include <openssl/pkcs8.h>
64 #include <openssl/rand.h>
65 #include <openssl/x509.h>
66 
67 static int do_pk8pkey(BIO *bp, EVP_PKEY *x, int isder,
68  int nid, const EVP_CIPHER *enc,
69  char *kstr, int klen, pem_password_cb *cb, void *u);
70 static int do_pk8pkey_fp(FILE *bp, EVP_PKEY *x, int isder,
71  int nid, const EVP_CIPHER *enc,
72  char *kstr, int klen, pem_password_cb *cb, void *u);
73 
74 /*
75  * These functions write a private key in PKCS#8 format: it is a "drop in"
76  * replacement for PEM_write_bio_PrivateKey() and friends. As usual if 'enc'
77  * is NULL then it uses the unencrypted private key form. The 'nid' versions
78  * uses PKCS#5 v1.5 PBE algorithms whereas the others use PKCS#5 v2.0.
79  */
80 
82  char *kstr, int klen,
83  pem_password_cb *cb, void *u)
84 {
85  return do_pk8pkey(bp, x, 0, nid, NULL, kstr, klen, cb, u);
86 }
87 
89  char *kstr, int klen,
90  pem_password_cb *cb, void *u)
91 {
92  return do_pk8pkey(bp, x, 0, -1, enc, kstr, klen, cb, u);
93 }
94 
96  char *kstr, int klen,
97  pem_password_cb *cb, void *u)
98 {
99  return do_pk8pkey(bp, x, 1, -1, enc, kstr, klen, cb, u);
100 }
101 
103  char *kstr, int klen,
104  pem_password_cb *cb, void *u)
105 {
106  return do_pk8pkey(bp, x, 1, nid, NULL, kstr, klen, cb, u);
107 }
108 
109 static int do_pk8pkey(BIO *bp, EVP_PKEY *x, int isder, int nid,
110  const EVP_CIPHER *enc, char *kstr, int klen,
111  pem_password_cb *cb, void *u)
112 {
113  X509_SIG *p8;
114  PKCS8_PRIV_KEY_INFO *p8inf;
115  char buf[PEM_BUFSIZE];
116  int ret;
117  if (!(p8inf = EVP_PKEY2PKCS8(x))) {
119  return 0;
120  }
121  if (enc || (nid != -1)) {
122  if (!kstr) {
123  klen = 0;
124  if (!cb)
126  klen = cb(buf, PEM_BUFSIZE, 1, u);
127  if (klen <= 0) {
130  return 0;
131  }
132 
133  kstr = buf;
134  }
135  p8 = PKCS8_encrypt(nid, enc, kstr, klen, NULL, 0, 0, p8inf);
136  if (kstr == buf)
139  if (isder)
140  ret = i2d_PKCS8_bio(bp, p8);
141  else
142  ret = PEM_write_bio_PKCS8(bp, p8);
143  X509_SIG_free(p8);
144  return ret;
145  } else {
146  if (isder)
147  ret = i2d_PKCS8_PRIV_KEY_INFO_bio(bp, p8inf);
148  else
151  return ret;
152  }
153 }
154 
156  void *u)
157 {
158  PKCS8_PRIV_KEY_INFO *p8inf = NULL;
159  X509_SIG *p8 = NULL;
160  int klen;
161  EVP_PKEY *ret;
162  char psbuf[PEM_BUFSIZE];
163  p8 = d2i_PKCS8_bio(bp, NULL);
164  if (!p8)
165  return NULL;
166 
167  klen = 0;
168  if (!cb)
170  klen = cb(psbuf, PEM_BUFSIZE, 0, u);
171  if (klen <= 0) {
173  X509_SIG_free(p8);
174  return NULL;
175  }
176  p8inf = PKCS8_decrypt(p8, psbuf, klen);
177  X509_SIG_free(p8);
178  OPENSSL_cleanse(psbuf, klen);
179  if (!p8inf)
180  return NULL;
181  ret = EVP_PKCS82PKEY(p8inf);
183  if (!ret)
184  return NULL;
185  if (x) {
186  if (*x)
187  EVP_PKEY_free(*x);
188  *x = ret;
189  }
190  return ret;
191 }
192 
193 
195  char *kstr, int klen, pem_password_cb *cb, void *u)
196 {
197  return do_pk8pkey_fp(fp, x, 1, -1, enc, kstr, klen, cb, u);
198 }
199 
201  char *kstr, int klen,
202  pem_password_cb *cb, void *u)
203 {
204  return do_pk8pkey_fp(fp, x, 1, nid, NULL, kstr, klen, cb, u);
205 }
206 
208  char *kstr, int klen,
209  pem_password_cb *cb, void *u)
210 {
211  return do_pk8pkey_fp(fp, x, 0, nid, NULL, kstr, klen, cb, u);
212 }
213 
215  char *kstr, int klen, pem_password_cb *cb,
216  void *u)
217 {
218  return do_pk8pkey_fp(fp, x, 0, -1, enc, kstr, klen, cb, u);
219 }
220 
221 static int do_pk8pkey_fp(FILE *fp, EVP_PKEY *x, int isder, int nid,
222  const EVP_CIPHER *enc, char *kstr, int klen,
223  pem_password_cb *cb, void *u)
224 {
225  BIO *bp;
226  int ret;
227  if (!(bp = BIO_new_fp(fp, BIO_NOCLOSE))) {
229  return (0);
230  }
231  ret = do_pk8pkey(bp, x, isder, nid, enc, kstr, klen, cb, u);
232  BIO_free(bp);
233  return ret;
234 }
235 
237  void *u)
238 {
239  BIO *bp;
240  EVP_PKEY *ret;
241  if (!(bp = BIO_new_fp(fp, BIO_NOCLOSE))) {
243  return NULL;
244  }
245  ret = d2i_PKCS8PrivateKey_bio(bp, x, cb, u);
246  BIO_free(bp);
247  return ret;
248 }
249 
250 
252 
253 
BIO_new_fp
#define BIO_new_fp
Definition: boringssl_prefix_symbols.h:819
EVP_PKCS82PKEY
OPENSSL_EXPORT EVP_PKEY * EVP_PKCS82PKEY(PKCS8_PRIV_KEY_INFO *p8)
d2i_PKCS8PrivateKey_bio
EVP_PKEY * d2i_PKCS8PrivateKey_bio(BIO *bp, EVP_PKEY **x, pem_password_cb *cb, void *u)
Definition: pem_pk8.c:155
OPENSSL_cleanse
#define OPENSSL_cleanse
Definition: boringssl_prefix_symbols.h:1864
PEM_BUFSIZE
#define PEM_BUFSIZE
Definition: pem.h:78
bio_st
Definition: bio.h:822
kstr
X509 X509_REQ PKCS7 PKCS8_PRIV_KEY_INFO RSA DSA DSA EC_KEY EVP_PKEY EVP_PKEY int char * kstr
Definition: pem.h:425
evp.h
do_pk8pkey_fp
static int do_pk8pkey_fp(FILE *bp, EVP_PKEY *x, int isder, int nid, const EVP_CIPHER *enc, char *kstr, int klen, pem_password_cb *cb, void *u)
Definition: pem_pk8.c:221
PKCS8_decrypt
OPENSSL_EXPORT PKCS8_PRIV_KEY_INFO * PKCS8_decrypt(X509_SIG *pkcs8, const char *pass, int pass_len)
OPENSSL_PUT_ERROR
#define OPENSSL_PUT_ERROR(library, reason)
Definition: err.h:423
PEM_def_callback
#define PEM_def_callback
Definition: boringssl_prefix_symbols.h:1916
PEM_write_bio_PKCS8
#define PEM_write_bio_PKCS8
Definition: boringssl_prefix_symbols.h:1989
buf
voidpf void * buf
Definition: bloaty/third_party/zlib/contrib/minizip/ioapi.h:136
i2d_PKCS8_bio
OPENSSL_EXPORT int i2d_PKCS8_bio(BIO *bp, X509_SIG *p8)
X509_sig_st
Definition: x_sig.c:64
u
OPENSSL_EXPORT pem_password_cb void * u
Definition: pem.h:351
i2d_PKCS8_PRIV_KEY_INFO_bio
OPENSSL_EXPORT int i2d_PKCS8_PRIV_KEY_INFO_bio(BIO *bp, PKCS8_PRIV_KEY_INFO *p8inf)
pem.h
pkcs8.h
PEM_write_PKCS8PrivateKey_nid
int PEM_write_PKCS8PrivateKey_nid(FILE *fp, EVP_PKEY *x, int nid, char *kstr, int klen, pem_password_cb *cb, void *u)
Definition: pem_pk8.c:207
pem_password_cb
int pem_password_cb(char *buf, int size, int rwflag, void *userdata)
Definition: pem.h:313
i2d_PKCS8PrivateKey_bio
int i2d_PKCS8PrivateKey_bio(BIO *bp, EVP_PKEY *x, const EVP_CIPHER *enc, char *kstr, int klen, pem_password_cb *cb, void *u)
Definition: pem_pk8.c:95
i2d_PKCS8PrivateKey_fp
int i2d_PKCS8PrivateKey_fp(FILE *fp, EVP_PKEY *x, const EVP_CIPHER *enc, char *kstr, int klen, pem_password_cb *cb, void *u)
Definition: pem_pk8.c:194
d2i_PKCS8PrivateKey_fp
EVP_PKEY * d2i_PKCS8PrivateKey_fp(FILE *fp, EVP_PKEY **x, pem_password_cb *cb, void *u)
Definition: pem_pk8.c:236
evp_cipher_st
Definition: cipher.h:585
evp_pkey_st
Definition: evp.h:1046
PEM_R_ERROR_CONVERTING_PRIVATE_KEY
#define PEM_R_ERROR_CONVERTING_PRIVATE_KEY
Definition: pem.h:473
IMPLEMENT_PEM_rw
#define IMPLEMENT_PEM_rw(name, type, str, asn1)
Definition: pem.h:239
d2i_PKCS8_bio
OPENSSL_EXPORT X509_SIG * d2i_PKCS8_bio(BIO *bp, X509_SIG **p8)
EVP_PKEY_free
#define EVP_PKEY_free
Definition: boringssl_prefix_symbols.h:1625
err.h
i2d_PKCS8PrivateKey_nid_bio
int i2d_PKCS8PrivateKey_nid_bio(BIO *bp, EVP_PKEY *x, int nid, char *kstr, int klen, pem_password_cb *cb, void *u)
Definition: pem_pk8.c:102
x
int x
Definition: bloaty/third_party/googletest/googlemock/test/gmock-matchers_test.cc:3610
ERR_R_BUF_LIB
#define ERR_R_BUF_LIB
Definition: err.h:335
PKCS8_PRIV_KEY_INFO_free
#define PKCS8_PRIV_KEY_INFO_free
Definition: boringssl_prefix_symbols.h:2029
nid
int nid
Definition: cipher_extra.c:71
PKCS8_encrypt
OPENSSL_EXPORT X509_SIG * PKCS8_encrypt(int pbe_nid, const EVP_CIPHER *cipher, const char *pass, int pass_len, const uint8_t *salt, size_t salt_len, int iterations, PKCS8_PRIV_KEY_INFO *p8inf)
PEM_R_READ_KEY
#define PEM_R_READ_KEY
Definition: pem.h:478
BIO_free
#define BIO_free
Definition: boringssl_prefix_symbols.h:787
PEM_write_bio_PKCS8PrivateKey
int PEM_write_bio_PKCS8PrivateKey(BIO *bp, EVP_PKEY *x, const EVP_CIPHER *enc, char *kstr, int klen, pem_password_cb *cb, void *u)
Definition: pem_pk8.c:88
rand.h
PEM_write_bio_PKCS8PrivateKey_nid
int PEM_write_bio_PKCS8PrivateKey_nid(BIO *bp, EVP_PKEY *x, int nid, char *kstr, int klen, pem_password_cb *cb, void *u)
Definition: pem_pk8.c:81
benchmark.FILE
FILE
Definition: benchmark.py:21
i2d_PKCS8PrivateKey_nid_fp
int i2d_PKCS8PrivateKey_nid_fp(FILE *fp, EVP_PKEY *x, int nid, char *kstr, int klen, pem_password_cb *cb, void *u)
Definition: pem_pk8.c:200
PEM_R_BAD_PASSWORD_READ
#define PEM_R_BAD_PASSWORD_READ
Definition: pem.h:471
ret
UniquePtr< SSL_SESSION > ret
Definition: ssl_x509.cc:1029
PEM_STRING_PKCS8INF
#define PEM_STRING_PKCS8INF
Definition: pem.h:97
do_pk8pkey
static int do_pk8pkey(BIO *bp, EVP_PKEY *x, int isder, int nid, const EVP_CIPHER *enc, char *kstr, int klen, pem_password_cb *cb, void *u)
Definition: pem_pk8.c:109
obj.h
BIO_NOCLOSE
#define BIO_NOCLOSE
Definition: bio.h:373
X509_SIG_free
#define X509_SIG_free
Definition: boringssl_prefix_symbols.h:2481
mem.h
PEM_write_PKCS8PrivateKey
int PEM_write_PKCS8PrivateKey(FILE *fp, EVP_PKEY *x, const EVP_CIPHER *enc, char *kstr, int klen, pem_password_cb *cb, void *u)
Definition: pem_pk8.c:214
pkcs8_priv_key_info_st
Definition: third_party/boringssl-with-bazel/src/crypto/pkcs8/internal.h:66
EVP_PKEY2PKCS8
OPENSSL_EXPORT PKCS8_PRIV_KEY_INFO * EVP_PKEY2PKCS8(EVP_PKEY *pkey)
klen
X509 X509_REQ PKCS7 PKCS8_PRIV_KEY_INFO RSA DSA DSA EC_KEY EVP_PKEY EVP_PKEY int char int klen
Definition: pem.h:426
cb
OPENSSL_EXPORT pem_password_cb * cb
Definition: pem.h:351
PEM_write_bio_PKCS8_PRIV_KEY_INFO
#define PEM_write_bio_PKCS8_PRIV_KEY_INFO
Definition: boringssl_prefix_symbols.h:1992
x509.h
PEM_STRING_PKCS8
#define PEM_STRING_PKCS8
Definition: pem.h:96


grpc
Author(s):
autogenerated on Fri May 16 2025 02:59:41