xref: /freebsd/crypto/openssl/crypto/pem/pem_lib.c (revision e7be843b4a162e68651d3911f0357ed464915629)
1 /*
2  * Copyright 1995-2025 The OpenSSL Project Authors. All Rights Reserved.
3  *
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
8  */
9 
10 /* We need to use some engine deprecated APIs */
11 #define OPENSSL_SUPPRESS_DEPRECATED
12 
13 #include <stdio.h>
14 #include "crypto/ctype.h"
15 #include <string.h>
16 #include "internal/cryptlib.h"
17 #include <openssl/buffer.h>
18 #include <openssl/objects.h>
19 #include <openssl/evp.h>
20 #include <openssl/rand.h>
21 #include <openssl/x509.h>
22 #include <openssl/pem.h>
23 #include <openssl/pkcs12.h>
24 #include "crypto/asn1.h"
25 #include <openssl/des.h>
26 #include <openssl/engine.h>
27 
28 #define MIN_LENGTH      4
29 
30 static int load_iv(char **fromp, unsigned char *to, int num);
31 static int check_pem(const char *nm, const char *name);
32 int ossl_pem_check_suffix(const char *pem_str, const char *suffix);
33 
PEM_def_callback(char * buf,int num,int rwflag,void * userdata)34 int PEM_def_callback(char *buf, int num, int rwflag, void *userdata)
35 {
36     int i, min_len;
37     const char *prompt;
38 
39     /* We assume that the user passes a default password as userdata */
40     if (userdata) {
41         i = strlen(userdata);
42         i = (i > num) ? num : i;
43         memcpy(buf, userdata, i);
44         return i;
45     }
46 
47     prompt = EVP_get_pw_prompt();
48     if (prompt == NULL)
49         prompt = "Enter PEM pass phrase:";
50 
51     /*
52      * rwflag == 0 means decryption
53      * rwflag == 1 means encryption
54      *
55      * We assume that for encryption, we want a minimum length, while for
56      * decryption, we cannot know any minimum length, so we assume zero.
57      */
58     min_len = rwflag ? MIN_LENGTH : 0;
59 
60     i = EVP_read_pw_string_min(buf, min_len, num, prompt, rwflag);
61     if (i != 0) {
62         ERR_raise(ERR_LIB_PEM, PEM_R_PROBLEMS_GETTING_PASSWORD);
63         memset(buf, 0, (unsigned int)num);
64         return -1;
65     }
66     return strlen(buf);
67 }
68 
PEM_proc_type(char * buf,int type)69 void PEM_proc_type(char *buf, int type)
70 {
71     const char *str;
72     char *p = buf + strlen(buf);
73 
74     if (type == PEM_TYPE_ENCRYPTED)
75         str = "ENCRYPTED";
76     else if (type == PEM_TYPE_MIC_CLEAR)
77         str = "MIC-CLEAR";
78     else if (type == PEM_TYPE_MIC_ONLY)
79         str = "MIC-ONLY";
80     else
81         str = "BAD-TYPE";
82 
83     BIO_snprintf(p, PEM_BUFSIZE - (size_t)(p - buf), "Proc-Type: 4,%s\n", str);
84 }
85 
PEM_dek_info(char * buf,const char * type,int len,const char * str)86 void PEM_dek_info(char *buf, const char *type, int len, const char *str)
87 {
88     long i;
89     char *p = buf + strlen(buf);
90     int j = PEM_BUFSIZE - (size_t)(p - buf), n;
91 
92     n = BIO_snprintf(p, j, "DEK-Info: %s,", type);
93     if (n > 0) {
94         j -= n;
95         p += n;
96         for (i = 0; i < len; i++) {
97             n = BIO_snprintf(p, j, "%02X", 0xff & str[i]);
98             if (n <= 0)
99                 return;
100             j -= n;
101             p += n;
102         }
103         if (j > 1)
104             strcpy(p, "\n");
105     }
106 }
107 
108 #ifndef OPENSSL_NO_STDIO
PEM_ASN1_read(d2i_of_void * d2i,const char * name,FILE * fp,void ** x,pem_password_cb * cb,void * u)109 void *PEM_ASN1_read(d2i_of_void *d2i, const char *name, FILE *fp, void **x,
110                     pem_password_cb *cb, void *u)
111 {
112     BIO *b;
113     void *ret;
114 
115     if ((b = BIO_new(BIO_s_file())) == NULL) {
116         ERR_raise(ERR_LIB_PEM, ERR_R_BUF_LIB);
117         return 0;
118     }
119     BIO_set_fp(b, fp, BIO_NOCLOSE);
120     ret = PEM_ASN1_read_bio(d2i, name, b, x, cb, u);
121     BIO_free(b);
122     return ret;
123 }
124 #endif
125 
check_pem(const char * nm,const char * name)126 static int check_pem(const char *nm, const char *name)
127 {
128     /* Normal matching nm and name */
129     if (strcmp(nm, name) == 0)
130         return 1;
131 
132     /* Make PEM_STRING_EVP_PKEY match any private key */
133 
134     if (strcmp(name, PEM_STRING_EVP_PKEY) == 0) {
135         int slen;
136         const EVP_PKEY_ASN1_METHOD *ameth;
137         if (strcmp(nm, PEM_STRING_PKCS8) == 0)
138             return 1;
139         if (strcmp(nm, PEM_STRING_PKCS8INF) == 0)
140             return 1;
141         slen = ossl_pem_check_suffix(nm, "PRIVATE KEY");
142         if (slen > 0) {
143             /*
144              * NB: ENGINE implementations won't contain a deprecated old
145              * private key decode function so don't look for them.
146              */
147             ameth = EVP_PKEY_asn1_find_str(NULL, nm, slen);
148             if (ameth && ameth->old_priv_decode)
149                 return 1;
150         }
151         return 0;
152     }
153 
154     if (strcmp(name, PEM_STRING_PARAMETERS) == 0) {
155         int slen;
156         const EVP_PKEY_ASN1_METHOD *ameth;
157         slen = ossl_pem_check_suffix(nm, "PARAMETERS");
158         if (slen > 0) {
159             ENGINE *e;
160             ameth = EVP_PKEY_asn1_find_str(&e, nm, slen);
161             if (ameth) {
162                 int r;
163                 if (ameth->param_decode)
164                     r = 1;
165                 else
166                     r = 0;
167 #ifndef OPENSSL_NO_ENGINE
168                 ENGINE_finish(e);
169 #endif
170                 return r;
171             }
172         }
173         return 0;
174     }
175     /* If reading DH parameters handle X9.42 DH format too */
176     if (strcmp(nm, PEM_STRING_DHXPARAMS) == 0
177         && strcmp(name, PEM_STRING_DHPARAMS) == 0)
178         return 1;
179 
180     /* Permit older strings */
181 
182     if (strcmp(nm, PEM_STRING_X509_OLD) == 0
183         && strcmp(name, PEM_STRING_X509) == 0)
184         return 1;
185 
186     if (strcmp(nm, PEM_STRING_X509_REQ_OLD) == 0
187         && strcmp(name, PEM_STRING_X509_REQ) == 0)
188         return 1;
189 
190     /* Allow normal certs to be read as trusted certs */
191     if (strcmp(nm, PEM_STRING_X509) == 0
192         && strcmp(name, PEM_STRING_X509_TRUSTED) == 0)
193         return 1;
194 
195     if (strcmp(nm, PEM_STRING_X509_OLD) == 0
196         && strcmp(name, PEM_STRING_X509_TRUSTED) == 0)
197         return 1;
198 
199     /* Some CAs use PKCS#7 with CERTIFICATE headers */
200     if (strcmp(nm, PEM_STRING_X509) == 0
201         && strcmp(name, PEM_STRING_PKCS7) == 0)
202         return 1;
203 
204     if (strcmp(nm, PEM_STRING_PKCS7_SIGNED) == 0
205         && strcmp(name, PEM_STRING_PKCS7) == 0)
206         return 1;
207 
208 #ifndef OPENSSL_NO_CMS
209     if (strcmp(nm, PEM_STRING_X509) == 0
210         && strcmp(name, PEM_STRING_CMS) == 0)
211         return 1;
212     /* Allow CMS to be read from PKCS#7 headers */
213     if (strcmp(nm, PEM_STRING_PKCS7) == 0
214         && strcmp(name, PEM_STRING_CMS) == 0)
215         return 1;
216 #endif
217 
218     return 0;
219 }
220 
221 #define PEM_FREE(p, flags, num)                                 \
222     pem_free((p), (flags), (num), OPENSSL_FILE, OPENSSL_LINE)
pem_free(void * p,unsigned int flags,size_t num,const char * file,int line)223 static void pem_free(void *p, unsigned int flags, size_t num,
224                      const char *file, int line)
225 {
226     if (flags & PEM_FLAG_SECURE)
227         CRYPTO_secure_clear_free(p, num, file, line);
228     else
229         CRYPTO_free(p, file, line);
230 }
231 
232 #define PEM_MALLOC(num, flags)                                  \
233     pem_malloc((num), (flags), OPENSSL_FILE, OPENSSL_LINE)
pem_malloc(int num,unsigned int flags,const char * file,int line)234 static void *pem_malloc(int num, unsigned int flags,
235                         const char *file, int line)
236 {
237     return (flags & PEM_FLAG_SECURE) ? CRYPTO_secure_malloc(num, file, line)
238                                      : CRYPTO_malloc(num, file, line);
239 
240 }
241 
pem_bytes_read_bio_flags(unsigned char ** pdata,long * plen,char ** pnm,const char * name,BIO * bp,pem_password_cb * cb,void * u,unsigned int flags)242 static int pem_bytes_read_bio_flags(unsigned char **pdata, long *plen,
243                                     char **pnm, const char *name, BIO *bp,
244                                     pem_password_cb *cb, void *u,
245                                     unsigned int flags)
246 {
247     EVP_CIPHER_INFO cipher;
248     char *nm = NULL, *header = NULL;
249     unsigned char *data = NULL;
250     long len = 0;
251     int ret = 0;
252 
253     do {
254         PEM_FREE(nm, flags, 0);
255         PEM_FREE(header, flags, 0);
256         PEM_FREE(data, flags, len);
257         if (!PEM_read_bio_ex(bp, &nm, &header, &data, &len, flags)) {
258             if (ERR_GET_REASON(ERR_peek_error()) == PEM_R_NO_START_LINE)
259                 ERR_add_error_data(2, "Expecting: ", name);
260             return 0;
261         }
262     } while (!check_pem(nm, name));
263     if (!PEM_get_EVP_CIPHER_INFO(header, &cipher))
264         goto err;
265     if (!PEM_do_header(&cipher, data, &len, cb, u))
266         goto err;
267 
268     *pdata = data;
269     *plen = len;
270 
271     if (pnm != NULL)
272         *pnm = nm;
273 
274     ret = 1;
275 
276  err:
277     if (!ret || pnm == NULL)
278         PEM_FREE(nm, flags, 0);
279     PEM_FREE(header, flags, 0);
280     if (!ret)
281         PEM_FREE(data, flags, len);
282     return ret;
283 }
284 
PEM_bytes_read_bio(unsigned char ** pdata,long * plen,char ** pnm,const char * name,BIO * bp,pem_password_cb * cb,void * u)285 int PEM_bytes_read_bio(unsigned char **pdata, long *plen, char **pnm,
286                        const char *name, BIO *bp, pem_password_cb *cb,
287                        void *u) {
288     return pem_bytes_read_bio_flags(pdata, plen, pnm, name, bp, cb, u,
289                                     PEM_FLAG_EAY_COMPATIBLE);
290 }
291 
PEM_bytes_read_bio_secmem(unsigned char ** pdata,long * plen,char ** pnm,const char * name,BIO * bp,pem_password_cb * cb,void * u)292 int PEM_bytes_read_bio_secmem(unsigned char **pdata, long *plen, char **pnm,
293                               const char *name, BIO *bp, pem_password_cb *cb,
294                               void *u) {
295     return pem_bytes_read_bio_flags(pdata, plen, pnm, name, bp, cb, u,
296                                     PEM_FLAG_SECURE | PEM_FLAG_EAY_COMPATIBLE);
297 }
298 
299 #ifndef OPENSSL_NO_STDIO
PEM_ASN1_write(i2d_of_void * i2d,const char * name,FILE * fp,const void * x,const EVP_CIPHER * enc,const unsigned char * kstr,int klen,pem_password_cb * callback,void * u)300 int PEM_ASN1_write(i2d_of_void *i2d, const char *name, FILE *fp,
301                    const void *x, const EVP_CIPHER *enc,
302                    const unsigned char *kstr, int klen,
303                    pem_password_cb *callback, void *u)
304 {
305     BIO *b;
306     int ret;
307 
308     if ((b = BIO_new(BIO_s_file())) == NULL) {
309         ERR_raise(ERR_LIB_PEM, ERR_R_BUF_LIB);
310         return 0;
311     }
312     BIO_set_fp(b, fp, BIO_NOCLOSE);
313     ret = PEM_ASN1_write_bio(i2d, name, b, x, enc, kstr, klen, callback, u);
314     BIO_free(b);
315     return ret;
316 }
317 #endif
318 
319 static int
PEM_ASN1_write_bio_internal(i2d_of_void * i2d,OSSL_i2d_of_void_ctx * i2d_ctx,void * vctx,const char * name,BIO * bp,const void * x,const EVP_CIPHER * enc,const unsigned char * kstr,int klen,pem_password_cb * callback,void * u)320 PEM_ASN1_write_bio_internal(
321     i2d_of_void *i2d, OSSL_i2d_of_void_ctx *i2d_ctx, void *vctx,
322     const char *name, BIO *bp, const void *x, const EVP_CIPHER *enc,
323     const unsigned char *kstr, int klen, pem_password_cb *callback, void *u)
324 {
325     EVP_CIPHER_CTX *ctx = NULL;
326     int dsize = 0, i = 0, j = 0, ret = 0;
327     unsigned char *p, *data = NULL;
328     const char *objstr = NULL;
329     char buf[PEM_BUFSIZE];
330     unsigned char key[EVP_MAX_KEY_LENGTH];
331     unsigned char iv[EVP_MAX_IV_LENGTH];
332 
333     if (enc != NULL) {
334         objstr = EVP_CIPHER_get0_name(enc);
335         if (objstr == NULL || EVP_CIPHER_get_iv_length(enc) == 0
336                 || EVP_CIPHER_get_iv_length(enc) > (int)sizeof(iv)
337                    /*
338                     * Check "Proc-Type: 4,Encrypted\nDEK-Info: objstr,hex-iv\n"
339                     * fits into buf
340                     */
341                 || strlen(objstr) + 23 + 2 * EVP_CIPHER_get_iv_length(enc) + 13
342                    > sizeof(buf)) {
343             ERR_raise(ERR_LIB_PEM, PEM_R_UNSUPPORTED_CIPHER);
344             goto err;
345         }
346     }
347 
348     if (i2d == NULL && i2d_ctx == NULL) {
349         ERR_raise(ERR_LIB_CRYPTO, CRYPTO_R_INVALID_NULL_ARGUMENT);
350         dsize = 0;
351         goto err;
352     }
353     dsize = i2d != NULL ? i2d(x, NULL) : i2d_ctx(x, NULL, vctx);
354     if (dsize <= 0) {
355         ERR_raise(ERR_LIB_PEM, ERR_R_ASN1_LIB);
356         dsize = 0;
357         goto err;
358     }
359     /* Allocate enough space for one extra cipher block */
360     data = OPENSSL_malloc((unsigned int)dsize + EVP_MAX_BLOCK_LENGTH);
361     if (data == NULL)
362         goto err;
363     p = data;
364     i = i2d != NULL ? i2d(x, &p) : i2d_ctx(x, &p, vctx);
365 
366     if (enc != NULL) {
367         if (kstr == NULL) {
368             if (callback == NULL)
369                 klen = PEM_def_callback(buf, PEM_BUFSIZE, 1, u);
370             else
371                 klen = (*callback) (buf, PEM_BUFSIZE, 1, u);
372             if (klen <= 0) {
373                 ERR_raise(ERR_LIB_PEM, PEM_R_READ_KEY);
374                 goto err;
375             }
376 #ifdef CHARSET_EBCDIC
377             /* Convert the pass phrase from EBCDIC */
378             ebcdic2ascii(buf, buf, klen);
379 #endif
380             kstr = (unsigned char *)buf;
381         }
382         /* Generate a salt */
383         if (RAND_bytes(iv, EVP_CIPHER_get_iv_length(enc)) <= 0)
384             goto err;
385         /*
386          * The 'iv' is used as the iv and as a salt.  It is NOT taken from
387          * the BytesToKey function
388          */
389         if (!EVP_BytesToKey(enc, EVP_md5(), iv, kstr, klen, 1, key, NULL))
390             goto err;
391 
392         if (kstr == (unsigned char *)buf)
393             OPENSSL_cleanse(buf, PEM_BUFSIZE);
394 
395         buf[0] = '\0';
396         PEM_proc_type(buf, PEM_TYPE_ENCRYPTED);
397         PEM_dek_info(buf, objstr, EVP_CIPHER_get_iv_length(enc), (char *)iv);
398         /* k=strlen(buf); */
399 
400         ret = 1;
401         if ((ctx = EVP_CIPHER_CTX_new()) == NULL
402             || !EVP_EncryptInit_ex(ctx, enc, NULL, key, iv)
403             || !EVP_EncryptUpdate(ctx, data, &j, data, i)
404             || !EVP_EncryptFinal_ex(ctx, &(data[j]), &i))
405             ret = 0;
406         if (ret == 0)
407             goto err;
408         i += j;
409     } else {
410         ret = 1;
411         buf[0] = '\0';
412     }
413     i = PEM_write_bio(bp, name, buf, data, i);
414     if (i <= 0)
415         ret = 0;
416  err:
417     OPENSSL_cleanse(key, sizeof(key));
418     OPENSSL_cleanse(iv, sizeof(iv));
419     EVP_CIPHER_CTX_free(ctx);
420     OPENSSL_cleanse(buf, PEM_BUFSIZE);
421     OPENSSL_clear_free(data, (unsigned int)dsize);
422     return ret;
423 }
424 
425 int
PEM_ASN1_write_bio(i2d_of_void * i2d,const char * name,BIO * bp,const void * x,const EVP_CIPHER * enc,const unsigned char * kstr,int klen,pem_password_cb * callback,void * u)426 PEM_ASN1_write_bio(i2d_of_void *i2d, const char *name, BIO *bp, const void *x,
427                    const EVP_CIPHER *enc, const unsigned char *kstr, int klen,
428                    pem_password_cb *callback, void *u)
429 {
430     return PEM_ASN1_write_bio_internal(i2d, NULL, NULL, name, bp, x, enc,
431                                        kstr, klen, callback, u);
432 }
433 
PEM_ASN1_write_bio_ctx(OSSL_i2d_of_void_ctx * i2d,void * vctx,const char * name,BIO * bp,const void * x,const EVP_CIPHER * enc,const unsigned char * kstr,int klen,pem_password_cb * callback,void * u)434 int PEM_ASN1_write_bio_ctx(OSSL_i2d_of_void_ctx *i2d, void *vctx,
435                            const char *name, BIO *bp, const void *x,
436                            const EVP_CIPHER *enc, const unsigned char *kstr,
437                            int klen, pem_password_cb *callback, void *u)
438 {
439     return PEM_ASN1_write_bio_internal(NULL, i2d, vctx, name, bp, x, enc,
440                                        kstr, klen, callback, u);
441 }
442 
PEM_do_header(EVP_CIPHER_INFO * cipher,unsigned char * data,long * plen,pem_password_cb * callback,void * u)443 int PEM_do_header(EVP_CIPHER_INFO *cipher, unsigned char *data, long *plen,
444                   pem_password_cb *callback, void *u)
445 {
446     int ok;
447     int keylen;
448     long len = *plen;
449     int ilen = (int) len;       /* EVP_DecryptUpdate etc. take int lengths */
450     EVP_CIPHER_CTX *ctx;
451     unsigned char key[EVP_MAX_KEY_LENGTH];
452     char buf[PEM_BUFSIZE];
453 
454 #if LONG_MAX > INT_MAX
455     /* Check that we did not truncate the length */
456     if (len > INT_MAX) {
457         ERR_raise(ERR_LIB_PEM, PEM_R_HEADER_TOO_LONG);
458         return 0;
459     }
460 #endif
461 
462     if (cipher->cipher == NULL)
463         return 1;
464     if (callback == NULL)
465         keylen = PEM_def_callback(buf, PEM_BUFSIZE, 0, u);
466     else
467         keylen = callback(buf, PEM_BUFSIZE, 0, u);
468     if (keylen < 0) {
469         ERR_raise(ERR_LIB_PEM, PEM_R_BAD_PASSWORD_READ);
470         return 0;
471     }
472 #ifdef CHARSET_EBCDIC
473     /* Convert the pass phrase from EBCDIC */
474     ebcdic2ascii(buf, buf, keylen);
475 #endif
476 
477     if (!EVP_BytesToKey(cipher->cipher, EVP_md5(), &(cipher->iv[0]),
478                         (unsigned char *)buf, keylen, 1, key, NULL))
479         return 0;
480 
481     ctx = EVP_CIPHER_CTX_new();
482     if (ctx == NULL)
483         return 0;
484 
485     ok = EVP_DecryptInit_ex(ctx, cipher->cipher, NULL, key, &(cipher->iv[0]));
486     if (ok)
487         ok = EVP_DecryptUpdate(ctx, data, &ilen, data, ilen);
488     if (ok) {
489         /* Squirrel away the length of data decrypted so far. */
490         *plen = ilen;
491         ok = EVP_DecryptFinal_ex(ctx, &(data[ilen]), &ilen);
492     }
493     if (ok)
494         *plen += ilen;
495     else
496         ERR_raise(ERR_LIB_PEM, PEM_R_BAD_DECRYPT);
497 
498     EVP_CIPHER_CTX_free(ctx);
499     OPENSSL_cleanse((char *)buf, sizeof(buf));
500     OPENSSL_cleanse((char *)key, sizeof(key));
501     return ok;
502 }
503 
504 /*
505  * This implements a very limited PEM header parser that does not support the
506  * full grammar of rfc1421.  In particular, folded headers are not supported,
507  * nor is additional whitespace.
508  *
509  * A robust implementation would make use of a library that turns the headers
510  * into a BIO from which one folded line is read at a time, and is then split
511  * into a header label and content.  We would then parse the content of the
512  * headers we care about.  This is overkill for just this limited use-case, but
513  * presumably we also parse rfc822-style headers for S/MIME, so a common
514  * abstraction might well be more generally useful.
515  */
516 #define PROC_TYPE "Proc-Type:"
517 #define ENCRYPTED "ENCRYPTED"
518 #define DEK_INFO "DEK-Info:"
PEM_get_EVP_CIPHER_INFO(char * header,EVP_CIPHER_INFO * cipher)519 int PEM_get_EVP_CIPHER_INFO(char *header, EVP_CIPHER_INFO *cipher)
520 {
521     const EVP_CIPHER *enc = NULL;
522     int ivlen;
523     char *dekinfostart, c;
524 
525     cipher->cipher = NULL;
526     memset(cipher->iv, 0, sizeof(cipher->iv));
527     if ((header == NULL) || (*header == '\0') || (*header == '\n'))
528         return 1;
529 
530     if (!CHECK_AND_SKIP_PREFIX(header, PROC_TYPE)) {
531         ERR_raise(ERR_LIB_PEM, PEM_R_NOT_PROC_TYPE);
532         return 0;
533     }
534     header += strspn(header, " \t");
535 
536     if (*header++ != '4' || *header++ != ',')
537         return 0;
538     header += strspn(header, " \t");
539 
540     /* We expect "ENCRYPTED" followed by optional white-space + line break */
541     if (!CHECK_AND_SKIP_PREFIX(header, ENCRYPTED) ||
542         strspn(header, " \t\r\n") == 0) {
543         ERR_raise(ERR_LIB_PEM, PEM_R_NOT_ENCRYPTED);
544         return 0;
545     }
546     header += strspn(header, " \t\r");
547     if (*header++ != '\n') {
548         ERR_raise(ERR_LIB_PEM, PEM_R_SHORT_HEADER);
549         return 0;
550     }
551 
552     /*-
553      * https://tools.ietf.org/html/rfc1421#section-4.6.1.3
554      * We expect "DEK-Info: algo[,hex-parameters]"
555      */
556     if (!CHECK_AND_SKIP_PREFIX(header, DEK_INFO)) {
557         ERR_raise(ERR_LIB_PEM, PEM_R_NOT_DEK_INFO);
558         return 0;
559     }
560     header += strspn(header, " \t");
561 
562     /*
563      * DEK-INFO is a comma-separated combination of algorithm name and optional
564      * parameters.
565      */
566     dekinfostart = header;
567     header += strcspn(header, " \t,");
568     c = *header;
569     *header = '\0';
570     cipher->cipher = enc = EVP_get_cipherbyname(dekinfostart);
571     *header = c;
572     header += strspn(header, " \t");
573 
574     if (enc == NULL) {
575         ERR_raise(ERR_LIB_PEM, PEM_R_UNSUPPORTED_ENCRYPTION);
576         return 0;
577     }
578     ivlen = EVP_CIPHER_get_iv_length(enc);
579     if (ivlen > 0 && *header++ != ',') {
580         ERR_raise(ERR_LIB_PEM, PEM_R_MISSING_DEK_IV);
581         return 0;
582     } else if (ivlen == 0 && *header == ',') {
583         ERR_raise(ERR_LIB_PEM, PEM_R_UNEXPECTED_DEK_IV);
584         return 0;
585     }
586 
587     if (!load_iv(&header, cipher->iv, EVP_CIPHER_get_iv_length(enc)))
588         return 0;
589 
590     return 1;
591 }
592 
load_iv(char ** fromp,unsigned char * to,int num)593 static int load_iv(char **fromp, unsigned char *to, int num)
594 {
595     int v, i;
596     char *from;
597 
598     from = *fromp;
599     for (i = 0; i < num; i++)
600         to[i] = 0;
601     num *= 2;
602     for (i = 0; i < num; i++) {
603         v = OPENSSL_hexchar2int(*from);
604         if (v < 0) {
605             ERR_raise(ERR_LIB_PEM, PEM_R_BAD_IV_CHARS);
606             return 0;
607         }
608         from++;
609         to[i / 2] |= v << (long)((!(i & 1)) * 4);
610     }
611 
612     *fromp = from;
613     return 1;
614 }
615 
616 #ifndef OPENSSL_NO_STDIO
PEM_write(FILE * fp,const char * name,const char * header,const unsigned char * data,long len)617 int PEM_write(FILE *fp, const char *name, const char *header,
618               const unsigned char *data, long len)
619 {
620     BIO *b;
621     int ret;
622 
623     if ((b = BIO_new(BIO_s_file())) == NULL) {
624         ERR_raise(ERR_LIB_PEM, ERR_R_BUF_LIB);
625         return 0;
626     }
627     BIO_set_fp(b, fp, BIO_NOCLOSE);
628     ret = PEM_write_bio(b, name, header, data, len);
629     BIO_free(b);
630     return ret;
631 }
632 #endif
633 
PEM_write_bio(BIO * bp,const char * name,const char * header,const unsigned char * data,long len)634 int PEM_write_bio(BIO *bp, const char *name, const char *header,
635                   const unsigned char *data, long len)
636 {
637     int nlen, n, i, j, outl;
638     unsigned char *buf = NULL;
639     EVP_ENCODE_CTX *ctx = EVP_ENCODE_CTX_new();
640     int reason = 0;
641     int retval = 0;
642 
643     if (ctx == NULL) {
644         reason = ERR_R_EVP_LIB;
645         goto err;
646     }
647 
648     EVP_EncodeInit(ctx);
649     nlen = strlen(name);
650 
651     if ((BIO_write(bp, "-----BEGIN ", 11) != 11) ||
652         (BIO_write(bp, name, nlen) != nlen) ||
653         (BIO_write(bp, "-----\n", 6) != 6)) {
654         reason = ERR_R_BIO_LIB;
655         goto err;
656     }
657 
658     i = header != NULL ? strlen(header) : 0;
659     if (i > 0) {
660         if ((BIO_write(bp, header, i) != i) || (BIO_write(bp, "\n", 1) != 1)) {
661             reason = ERR_R_BIO_LIB;
662             goto err;
663         }
664     }
665 
666     buf = OPENSSL_malloc(PEM_BUFSIZE * 8);
667     if (buf == NULL)
668         goto err;
669 
670     i = j = 0;
671     while (len > 0) {
672         n = (int)((len > (PEM_BUFSIZE * 5)) ? (PEM_BUFSIZE * 5) : len);
673         if (!EVP_EncodeUpdate(ctx, buf, &outl, &(data[j]), n)) {
674             reason = ERR_R_EVP_LIB;
675             goto err;
676         }
677         if ((outl) && (BIO_write(bp, (char *)buf, outl) != outl)) {
678             reason = ERR_R_BIO_LIB;
679             goto err;
680         }
681         i += outl;
682         len -= n;
683         j += n;
684     }
685     EVP_EncodeFinal(ctx, buf, &outl);
686     if ((outl > 0) && (BIO_write(bp, (char *)buf, outl) != outl)) {
687         reason = ERR_R_BIO_LIB;
688         goto err;
689     }
690     if ((BIO_write(bp, "-----END ", 9) != 9) ||
691         (BIO_write(bp, name, nlen) != nlen) ||
692         (BIO_write(bp, "-----\n", 6) != 6)) {
693         reason = ERR_R_BIO_LIB;
694         goto err;
695     }
696     retval = i + outl;
697 
698  err:
699     if (retval == 0 && reason != 0)
700         ERR_raise(ERR_LIB_PEM, reason);
701     EVP_ENCODE_CTX_free(ctx);
702     OPENSSL_clear_free(buf, PEM_BUFSIZE * 8);
703     return retval;
704 }
705 
706 #ifndef OPENSSL_NO_STDIO
PEM_read(FILE * fp,char ** name,char ** header,unsigned char ** data,long * len)707 int PEM_read(FILE *fp, char **name, char **header, unsigned char **data,
708              long *len)
709 {
710     BIO *b;
711     int ret;
712 
713     if ((b = BIO_new(BIO_s_file())) == NULL) {
714         ERR_raise(ERR_LIB_PEM, ERR_R_BUF_LIB);
715         return 0;
716     }
717     BIO_set_fp(b, fp, BIO_NOCLOSE);
718     ret = PEM_read_bio(b, name, header, data, len);
719     BIO_free(b);
720     return ret;
721 }
722 #endif
723 
724 /* Some helpers for PEM_read_bio_ex(). */
sanitize_line(char * linebuf,int len,unsigned int flags,int first_call)725 static int sanitize_line(char *linebuf, int len, unsigned int flags, int first_call)
726 {
727     int i;
728     if (first_call) {
729         /* Other BOMs imply unsupported multibyte encoding,
730          * so don't strip them and let the error raise */
731         const unsigned char utf8_bom[3] = {0xEF, 0xBB, 0xBF};
732 
733         if (len > 3 && memcmp(linebuf, utf8_bom, 3) == 0) {
734             memmove(linebuf, linebuf + 3, len - 3);
735             linebuf[len - 3] = 0;
736             len -= 3;
737         }
738     }
739 
740     if (flags & PEM_FLAG_EAY_COMPATIBLE) {
741         /* Strip trailing whitespace */
742         while ((len >= 0) && (linebuf[len] <= ' '))
743             len--;
744         /* Go back to whitespace before applying uniform line ending. */
745         len++;
746     } else if (flags & PEM_FLAG_ONLY_B64) {
747         for (i = 0; i < len; ++i) {
748             if (!ossl_isbase64(linebuf[i]) || linebuf[i] == '\n'
749                 || linebuf[i] == '\r')
750                 break;
751         }
752         len = i;
753     } else {
754         /* EVP_DecodeBlock strips leading and trailing whitespace, so just strip
755          * control characters in-place and let everything through. */
756         for (i = 0; i < len; ++i) {
757             if (linebuf[i] == '\n' || linebuf[i] == '\r')
758                 break;
759             if (ossl_iscntrl(linebuf[i]))
760                 linebuf[i] = ' ';
761         }
762         len = i;
763     }
764     /* The caller allocated LINESIZE+1, so this is safe. */
765     linebuf[len++] = '\n';
766     linebuf[len] = '\0';
767     return len;
768 }
769 
770 #define LINESIZE 255
771 /* Note trailing spaces for begin and end. */
772 #define BEGINSTR "-----BEGIN "
773 #define ENDSTR "-----END "
774 #define TAILSTR "-----\n"
775 #define BEGINLEN ((int)(sizeof(BEGINSTR) - 1))
776 #define ENDLEN ((int)(sizeof(ENDSTR) - 1))
777 #define TAILLEN ((int)(sizeof(TAILSTR) - 1))
get_name(BIO * bp,char ** name,unsigned int flags)778 static int get_name(BIO *bp, char **name, unsigned int flags)
779 {
780     char *linebuf;
781     int ret = 0;
782     int len;
783     int first_call = 1;
784 
785     /*
786      * Need to hold trailing NUL (accounted for by BIO_gets() and the newline
787      * that will be added by sanitize_line() (the extra '1').
788      */
789     linebuf = PEM_MALLOC(LINESIZE + 1, flags);
790     if (linebuf == NULL)
791         return 0;
792 
793     do {
794         len = BIO_gets(bp, linebuf, LINESIZE);
795 
796         if (len <= 0) {
797             ERR_raise(ERR_LIB_PEM, PEM_R_NO_START_LINE);
798             goto err;
799         }
800 
801         /* Strip trailing garbage and standardize ending. */
802         len = sanitize_line(linebuf, len, flags & ~PEM_FLAG_ONLY_B64, first_call);
803         first_call = 0;
804 
805         /* Allow leading empty or non-matching lines. */
806     } while (!HAS_PREFIX(linebuf, BEGINSTR)
807              || len < TAILLEN
808              || !HAS_PREFIX(linebuf + len - TAILLEN, TAILSTR));
809     linebuf[len - TAILLEN] = '\0';
810     len = len - BEGINLEN - TAILLEN + 1;
811     *name = PEM_MALLOC(len, flags);
812     if (*name == NULL)
813         goto err;
814     memcpy(*name, linebuf + BEGINLEN, len);
815     ret = 1;
816 
817 err:
818     PEM_FREE(linebuf, flags, LINESIZE + 1);
819     return ret;
820 }
821 
822 /* Keep track of how much of a header we've seen. */
823 enum header_status {
824     MAYBE_HEADER,
825     IN_HEADER,
826     POST_HEADER
827 };
828 
829 /**
830  * Extract the optional PEM header, with details on the type of content and
831  * any encryption used on the contents, and the bulk of the data from the bio.
832  * The end of the header is marked by a blank line; if the end-of-input marker
833  * is reached prior to a blank line, there is no header.
834  *
835  * The header and data arguments are BIO** since we may have to swap them
836  * if there is no header, for efficiency.
837  *
838  * We need the name of the PEM-encoded type to verify the end string.
839  */
get_header_and_data(BIO * bp,BIO ** header,BIO ** data,char * name,unsigned int flags)840 static int get_header_and_data(BIO *bp, BIO **header, BIO **data, char *name,
841                                unsigned int flags)
842 {
843     BIO *tmp = *header;
844     char *linebuf, *p;
845     int len, ret = 0, end = 0, prev_partial_line_read = 0, partial_line_read = 0;
846     /* 0 if not seen (yet), 1 if reading header, 2 if finished header */
847     enum header_status got_header = MAYBE_HEADER;
848     unsigned int flags_mask;
849     size_t namelen;
850 
851     /* Need to hold trailing NUL (accounted for by BIO_gets() and the newline
852      * that will be added by sanitize_line() (the extra '1'). */
853     linebuf = PEM_MALLOC(LINESIZE + 1, flags);
854     if (linebuf == NULL)
855         return 0;
856 
857     while(1) {
858         flags_mask = ~0u;
859         len = BIO_gets(bp, linebuf, LINESIZE);
860         if (len <= 0) {
861             ERR_raise(ERR_LIB_PEM, PEM_R_BAD_END_LINE);
862             goto err;
863         }
864 
865         /*
866          * Check if line has been read completely or if only part of the line
867          * has been read. Keep the previous value to ignore newlines that
868          * appear due to reading a line up until the char before the newline.
869          */
870         prev_partial_line_read = partial_line_read;
871         partial_line_read = len == LINESIZE-1 && linebuf[LINESIZE-2] != '\n';
872 
873         if (got_header == MAYBE_HEADER) {
874             if (memchr(linebuf, ':', len) != NULL)
875                 got_header = IN_HEADER;
876         }
877         if (HAS_PREFIX(linebuf, ENDSTR) || got_header == IN_HEADER)
878             flags_mask &= ~PEM_FLAG_ONLY_B64;
879         len = sanitize_line(linebuf, len, flags & flags_mask, 0);
880 
881         /* Check for end of header. */
882         if (linebuf[0] == '\n') {
883             /*
884              * If previous line has been read only partially this newline is a
885              * regular newline at the end of a line and not an empty line.
886              */
887             if (!prev_partial_line_read) {
888                 if (got_header == POST_HEADER) {
889                     /* Another blank line is an error. */
890                     ERR_raise(ERR_LIB_PEM, PEM_R_BAD_END_LINE);
891                     goto err;
892                 }
893                 got_header = POST_HEADER;
894                 tmp = *data;
895             }
896             continue;
897         }
898 
899         /* Check for end of stream (which means there is no header). */
900         p = linebuf;
901         if (CHECK_AND_SKIP_PREFIX(p, ENDSTR)) {
902             namelen = strlen(name);
903             if (strncmp(p, name, namelen) != 0 ||
904                 !HAS_PREFIX(p + namelen, TAILSTR)) {
905                 ERR_raise(ERR_LIB_PEM, PEM_R_BAD_END_LINE);
906                 goto err;
907             }
908             if (got_header == MAYBE_HEADER) {
909                 *header = *data;
910                 *data = tmp;
911             }
912             break;
913         } else if (end) {
914             /* Malformed input; short line not at end of data. */
915             ERR_raise(ERR_LIB_PEM, PEM_R_BAD_END_LINE);
916             goto err;
917         }
918         /*
919          * Else, a line of text -- could be header or data; we don't
920          * know yet.  Just pass it through.
921          */
922         if (BIO_puts(tmp, linebuf) < 0)
923             goto err;
924         /*
925          * Only encrypted files need the line length check applied.
926          */
927         if (got_header == POST_HEADER) {
928             /* 65 includes the trailing newline */
929             if (len > 65)
930                 goto err;
931             if (len < 65)
932                 end = 1;
933         }
934     }
935 
936     ret = 1;
937 err:
938     PEM_FREE(linebuf, flags, LINESIZE + 1);
939     return ret;
940 }
941 
942 /**
943  * Read in PEM-formatted data from the given BIO.
944  *
945  * By nature of the PEM format, all content must be printable ASCII (except
946  * for line endings).  Other characters are malformed input and will be rejected.
947  */
PEM_read_bio_ex(BIO * bp,char ** name_out,char ** header,unsigned char ** data,long * len_out,unsigned int flags)948 int PEM_read_bio_ex(BIO *bp, char **name_out, char **header,
949                     unsigned char **data, long *len_out, unsigned int flags)
950 {
951     EVP_ENCODE_CTX *ctx = NULL;
952     const BIO_METHOD *bmeth;
953     BIO *headerB = NULL, *dataB = NULL;
954     char *name = NULL;
955     int len, taillen, headerlen, ret = 0;
956     BUF_MEM *buf_mem;
957 
958     *len_out = 0;
959     *name_out = *header = NULL;
960     *data = NULL;
961     if ((flags & PEM_FLAG_EAY_COMPATIBLE) && (flags & PEM_FLAG_ONLY_B64)) {
962         /* These two are mutually incompatible; bail out. */
963         ERR_raise(ERR_LIB_PEM, ERR_R_PASSED_INVALID_ARGUMENT);
964         goto end;
965     }
966     bmeth = (flags & PEM_FLAG_SECURE) ? BIO_s_secmem() : BIO_s_mem();
967 
968     headerB = BIO_new(bmeth);
969     dataB = BIO_new(bmeth);
970     if (headerB == NULL || dataB == NULL) {
971         ERR_raise(ERR_LIB_PEM, ERR_R_BIO_LIB);
972         goto end;
973     }
974 
975     if (!get_name(bp, &name, flags))
976         goto end;
977     if (!get_header_and_data(bp, &headerB, &dataB, name, flags))
978         goto end;
979 
980     BIO_get_mem_ptr(dataB, &buf_mem);
981     len = buf_mem->length;
982 
983     /* There was no data in the PEM file */
984     if (len == 0)
985         goto end;
986 
987     ctx = EVP_ENCODE_CTX_new();
988     if (ctx == NULL) {
989         ERR_raise(ERR_LIB_PEM, ERR_R_EVP_LIB);
990         goto end;
991     }
992 
993     EVP_DecodeInit(ctx);
994     if (EVP_DecodeUpdate(ctx, (unsigned char*)buf_mem->data, &len,
995                          (unsigned char*)buf_mem->data, len) < 0
996             || EVP_DecodeFinal(ctx, (unsigned char*)&(buf_mem->data[len]),
997                                &taillen) < 0) {
998         ERR_raise(ERR_LIB_PEM, PEM_R_BAD_BASE64_DECODE);
999         goto end;
1000     }
1001     len += taillen;
1002     buf_mem->length = len;
1003 
1004     headerlen = BIO_get_mem_data(headerB, NULL);
1005     *header = PEM_MALLOC(headerlen + 1, flags);
1006     *data = PEM_MALLOC(len, flags);
1007     if (*header == NULL || *data == NULL)
1008         goto out_free;
1009     if (headerlen != 0 && BIO_read(headerB, *header, headerlen) != headerlen)
1010         goto out_free;
1011     (*header)[headerlen] = '\0';
1012     if (BIO_read(dataB, *data, len) != len)
1013         goto out_free;
1014     *len_out = len;
1015     *name_out = name;
1016     name = NULL;
1017     ret = 1;
1018     goto end;
1019 
1020 out_free:
1021     PEM_FREE(*header, flags, 0);
1022     *header = NULL;
1023     PEM_FREE(*data, flags, 0);
1024     *data = NULL;
1025 end:
1026     EVP_ENCODE_CTX_free(ctx);
1027     PEM_FREE(name, flags, 0);
1028     BIO_free(headerB);
1029     BIO_free(dataB);
1030     return ret;
1031 }
1032 
PEM_read_bio(BIO * bp,char ** name,char ** header,unsigned char ** data,long * len)1033 int PEM_read_bio(BIO *bp, char **name, char **header, unsigned char **data,
1034                  long *len)
1035 {
1036     return PEM_read_bio_ex(bp, name, header, data, len, PEM_FLAG_EAY_COMPATIBLE);
1037 }
1038 
1039 /*
1040  * Check pem string and return prefix length. If for example the pem_str ==
1041  * "RSA PRIVATE KEY" and suffix = "PRIVATE KEY" the return value is 3 for the
1042  * string "RSA".
1043  */
1044 
ossl_pem_check_suffix(const char * pem_str,const char * suffix)1045 int ossl_pem_check_suffix(const char *pem_str, const char *suffix)
1046 {
1047     int pem_len = strlen(pem_str);
1048     int suffix_len = strlen(suffix);
1049     const char *p;
1050     if (suffix_len + 1 >= pem_len)
1051         return 0;
1052     p = pem_str + pem_len - suffix_len;
1053     if (strcmp(p, suffix))
1054         return 0;
1055     p--;
1056     if (*p != ' ')
1057         return 0;
1058     return p - pem_str;
1059 }
1060