2 * Copyright (C) 2002-2012 Free Software Foundation, Inc.
4 * Author: Nikos Mavrogiannopoulos
6 * This file is part of GnuTLS.
8 * The GnuTLS is free software; you can redistribute it and/or
9 * modify it under the terms of the GNU Lesser General Public License
10 * as published by the Free Software Foundation; either version 3 of
11 * the License, or (at your option) any later version.
13 * This library is distributed in the hope that it will be useful, but
14 * WITHOUT ANY WARRANTY; without even the implied warranty of
15 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
16 * Lesser General Public License for more details.
18 * You should have received a copy of the GNU Lesser General Public License
19 * along with this program. If not, see <http://www.gnu.org/licenses/>
23 #include <gnutls_int.h>
24 #include "gnutls_auth.h"
25 #include "gnutls_errors.h"
26 #include <auth/cert.h>
27 #include "gnutls_dh.h"
28 #include "gnutls_num.h"
29 #include "gnutls_datum.h"
30 #include <gnutls_pk.h>
31 #include <algorithms.h>
32 #include <gnutls_global.h>
33 #include <gnutls_record.h>
34 #include <gnutls_sig.h>
35 #include <gnutls_state.h>
36 #include <gnutls_pk.h>
37 #include <gnutls_str.h>
40 #include <gnutls_x509.h>
41 #include <gnutls/ocsp.h>
42 #include "x509/common.h"
43 #include "x509/x509_int.h"
44 #include <gnutls_str_array.h>
45 #include "read-file.h"
47 # include <wincrypt.h>
51 * some x509 certificate parsing functions.
54 /* Check if the number of bits of the key in the certificate
58 check_bits (gnutls_session_t session
, gnutls_x509_crt_t crt
, unsigned int max_bits
)
63 ret
= gnutls_x509_crt_get_pk_algorithm (crt
, &bits
);
71 if (bits
> max_bits
&& max_bits
> 0)
74 return GNUTLS_E_CONSTRAINT_ERROR
;
77 if (gnutls_pk_bits_to_sec_param(pk
, bits
) == GNUTLS_SEC_PARAM_INSECURE
)
80 _gnutls_audit_log(session
, "The security level of the certificate (%s: %u) is weak\n", gnutls_pk_get_name(pk
), bits
);
81 if (session
->internals
.priorities
.allow_weak_keys
== 0)
82 return gnutls_assert_val(GNUTLS_E_CERTIFICATE_ERROR
);
89 #define MAX_OCSP_VALIDITY_SECS (3*60*60*24)
91 /* If the certificate is revoked status will be GNUTLS_CERT_REVOKED.
94 * Zero on success, a negative error code otherwise.
97 check_ocsp_response (gnutls_session_t session
, gnutls_x509_crt_t cert
,
98 gnutls_x509_crt_t issuer
,
99 gnutls_datum_t
*data
, unsigned int * ostatus
)
101 gnutls_ocsp_resp_t resp
;
103 unsigned int status
, cert_status
;
104 time_t rtime
, vtime
, ntime
, now
;
106 now
= gnutls_time(0);
108 ret
= gnutls_ocsp_resp_init (&resp
);
110 return gnutls_assert_val(ret
);
112 ret
= gnutls_ocsp_resp_import (resp
, data
);
114 return gnutls_assert_val(ret
);
116 ret
= gnutls_ocsp_resp_check_crt(resp
, 0, cert
);
119 _gnutls_audit_log (session
, "Got OCSP response on an unrelated certificate.\n");
123 ret
= gnutls_ocsp_resp_verify_direct( resp
, issuer
, &status
, 0);
125 return gnutls_assert_val(ret
);
127 /* do not consider revocation data if response was not verified */
130 ret
= gnutls_assert_val(0);
134 ret
= gnutls_ocsp_resp_get_single(resp
, 0, NULL
, NULL
, NULL
, NULL
,
135 &cert_status
, &vtime
, &ntime
, &rtime
, NULL
);
138 ret
= gnutls_assert_val(0);
139 *ostatus
|= GNUTLS_CERT_REVOCATION_DATA_INVALID
;
143 if (cert_status
== GNUTLS_OCSP_CERT_REVOKED
)
145 _gnutls_audit_log(session
, "The certificate was revoked via OCSP\n");
146 *ostatus
|= GNUTLS_CERT_REVOKED
;
147 ret
= gnutls_assert_val(0);
153 if (now
- vtime
> MAX_OCSP_VALIDITY_SECS
)
155 _gnutls_audit_log(session
, "The OCSP response is old\n");
160 /* there is a newer OCSP answer, don't trust this one */
163 _gnutls_audit_log(session
, "There is a newer OCSP response but was not provided by the server\n");
164 if (now
-ntime
> MAX_OCSP_VALIDITY_SECS
)
165 *ostatus
|= GNUTLS_CERT_REVOCATION_DATA_TOO_OLD
;
171 gnutls_ocsp_resp_deinit (resp
);
177 #define CLEAR_CERTS for(x=0;x<peer_certificate_list_size;x++) { \
178 if (peer_certificate_list[x]) \
179 gnutls_x509_crt_deinit(peer_certificate_list[x]); \
181 gnutls_free( peer_certificate_list)
184 * _gnutls_x509_cert_verify_peers - return the peer's certificate status
185 * @session: is a gnutls session
187 * This function will try to verify the peer's certificate and return its status (TRUSTED, REVOKED etc.).
188 * The return value (status) should be one of the gnutls_certificate_status_t enumerated elements.
189 * However you must also check the peer's name in order to check if the verified certificate belongs to the
190 * actual peer. Returns a negative error code in case of an error, or GNUTLS_E_NO_CERTIFICATE_FOUND if no certificate was sent.
193 _gnutls_x509_cert_verify_peers (gnutls_session_t session
,
194 unsigned int *status
)
196 cert_auth_info_t info
;
197 gnutls_certificate_credentials_t cred
;
198 gnutls_x509_crt_t
*peer_certificate_list
;
200 int peer_certificate_list_size
, i
, x
, ret
;
201 gnutls_x509_crt_t issuer
;
202 unsigned int ocsp_status
= 0;
204 CHECK_AUTH (GNUTLS_CRD_CERTIFICATE
, GNUTLS_E_INVALID_REQUEST
);
206 info
= _gnutls_get_auth_info (session
);
210 return GNUTLS_E_INVALID_REQUEST
;
213 cred
= (gnutls_certificate_credentials_t
)
214 _gnutls_get_cred (session
, GNUTLS_CRD_CERTIFICATE
, NULL
);
218 return GNUTLS_E_INSUFFICIENT_CREDENTIALS
;
221 if (info
->raw_certificate_list
== NULL
|| info
->ncerts
== 0)
222 return GNUTLS_E_NO_CERTIFICATE_FOUND
;
224 if (info
->ncerts
> cred
->verify_depth
&& cred
->verify_depth
> 0)
227 return GNUTLS_E_CONSTRAINT_ERROR
;
230 /* generate a list of gnutls_certs based on the auth info
233 peer_certificate_list_size
= info
->ncerts
;
234 peer_certificate_list
=
235 gnutls_calloc (peer_certificate_list_size
, sizeof (gnutls_x509_crt_t
));
236 if (peer_certificate_list
== NULL
)
239 return GNUTLS_E_MEMORY_ERROR
;
242 for (i
= 0; i
< peer_certificate_list_size
; i
++)
244 ret
= gnutls_x509_crt_init (&peer_certificate_list
[i
]);
253 gnutls_x509_crt_import (peer_certificate_list
[i
],
254 &info
->raw_certificate_list
[i
],
255 GNUTLS_X509_FMT_DER
);
263 ret
= check_bits (session
, peer_certificate_list
[i
], cred
->verify_bits
);
273 /* Use the OCSP extension if any */
274 ret
= gnutls_ocsp_status_request_get(session
, &resp
);
278 if (peer_certificate_list_size
> 1)
279 issuer
= peer_certificate_list
[1];
282 ret
= gnutls_x509_trust_list_get_issuer(cred
->tlist
, peer_certificate_list
[0],
290 ret
= check_ocsp_response(session
, peer_certificate_list
[0], issuer
, &resp
, &ocsp_status
);
294 return gnutls_assert_val(ret
);
298 /* Verify certificate
300 ret
= gnutls_x509_trust_list_verify_crt (cred
->tlist
, peer_certificate_list
,
301 peer_certificate_list_size
,
302 cred
->verify_flags
| session
->internals
.
303 priorities
.additional_verify_flags
,
314 *status
|= ocsp_status
;
319 /* Returns the name of the certificate of a null name
321 static int get_x509_name(gnutls_x509_crt_t crt
, gnutls_str_array_t
*names
)
324 int i
, ret
= 0, ret2
;
327 for (i
= 0; !(ret
< 0); i
++)
329 max_size
= sizeof(name
);
331 ret
= gnutls_x509_crt_get_subject_alt_name(crt
, i
, name
, &max_size
, NULL
);
332 if (ret
== GNUTLS_SAN_DNSNAME
)
334 ret2
= _gnutls_str_array_append(names
, name
, max_size
);
337 _gnutls_str_array_clear(names
);
338 return gnutls_assert_val(ret2
);
343 max_size
= sizeof(name
);
344 ret
= gnutls_x509_crt_get_dn_by_oid (crt
, OID_X520_COMMON_NAME
, 0, 0, name
, &max_size
);
347 ret
= _gnutls_str_array_append(names
, name
, max_size
);
350 _gnutls_str_array_clear(names
);
351 return gnutls_assert_val(ret
);
358 static int get_x509_name_raw(gnutls_datum_t
*raw
, gnutls_x509_crt_fmt_t type
, gnutls_str_array_t
*names
)
361 gnutls_x509_crt_t crt
;
363 ret
= gnutls_x509_crt_init (&crt
);
370 ret
= gnutls_x509_crt_import (crt
, raw
, type
);
374 gnutls_x509_crt_deinit (crt
);
378 ret
= get_x509_name(crt
, names
);
379 gnutls_x509_crt_deinit (crt
);
383 /* Reads a DER encoded certificate list from memory and stores it to a
384 * gnutls_cert structure. Returns the number of certificates parsed.
387 parse_der_cert_mem (gnutls_certificate_credentials_t res
,
388 const void *input_cert
, int input_cert_size
)
391 gnutls_x509_crt_t crt
;
392 gnutls_pcert_st
*ccert
;
394 gnutls_str_array_t names
;
396 _gnutls_str_array_init(&names
);
398 ccert
= gnutls_malloc (sizeof (*ccert
));
402 return GNUTLS_E_MEMORY_ERROR
;
405 ret
= gnutls_x509_crt_init (&crt
);
412 tmp
.data
= (uint8_t *) input_cert
;
413 tmp
.size
= input_cert_size
;
415 ret
= gnutls_x509_crt_import (crt
, &tmp
, GNUTLS_X509_FMT_DER
);
419 gnutls_x509_crt_deinit (crt
);
423 ret
= get_x509_name(crt
, &names
);
427 gnutls_x509_crt_deinit (crt
);
431 ret
= gnutls_pcert_import_x509 (ccert
, crt
, 0);
432 gnutls_x509_crt_deinit (crt
);
440 ret
= certificate_credential_append_crt_list (res
, names
, ccert
, 1);
450 _gnutls_str_array_clear(&names
);
455 /* Reads a base64 encoded certificate list from memory and stores it to
456 * a gnutls_cert structure. Returns the number of certificate parsed.
459 parse_pem_cert_mem (gnutls_certificate_credentials_t res
,
460 const char *input_cert
, int input_cert_size
)
466 gnutls_pcert_st
*certs
= NULL
;
467 gnutls_str_array_t names
;
469 _gnutls_str_array_init(&names
);
471 /* move to the certificate
473 ptr
= memmem (input_cert
, input_cert_size
,
474 PEM_CERT_SEP
, sizeof (PEM_CERT_SEP
) - 1);
476 ptr
= memmem (input_cert
, input_cert_size
,
477 PEM_CERT_SEP2
, sizeof (PEM_CERT_SEP2
) - 1);
482 return GNUTLS_E_BASE64_DECODING_ERROR
;
484 size
= input_cert_size
- (ptr
- input_cert
);
490 certs
= gnutls_realloc_fast (certs
, (count
+ 1) * sizeof (gnutls_pcert_st
));
495 ret
= GNUTLS_E_MEMORY_ERROR
;
499 tmp
.data
= (void*)ptr
;
504 ret
= get_x509_name_raw(&tmp
, GNUTLS_X509_FMT_PEM
, &names
);
512 ret
= gnutls_pcert_import_x509_raw (&certs
[count
], &tmp
, GNUTLS_X509_FMT_PEM
, 0);
519 /* now we move ptr after the pem header
522 /* find the next certificate (if any)
524 size
= input_cert_size
- (ptr
- input_cert
);
530 ptr3
= memmem (ptr
, size
, PEM_CERT_SEP
, sizeof (PEM_CERT_SEP
) - 1);
532 ptr3
= memmem (ptr
, size
, PEM_CERT_SEP2
,
533 sizeof (PEM_CERT_SEP2
) - 1);
545 ret
= certificate_credential_append_crt_list (res
, names
, certs
, count
);
555 _gnutls_str_array_clear(&names
);
556 for (i
=0;i
<count
;i
++)
557 gnutls_pcert_deinit(&certs
[i
]);
564 /* Reads a DER or PEM certificate from memory
567 read_cert_mem (gnutls_certificate_credentials_t res
, const void *cert
,
568 int cert_size
, gnutls_x509_crt_fmt_t type
)
572 if (type
== GNUTLS_X509_FMT_DER
)
573 ret
= parse_der_cert_mem (res
, cert
, cert_size
);
575 ret
= parse_pem_cert_mem (res
, cert
, cert_size
);
586 /* Reads a PEM encoded PKCS-1 RSA/DSA private key from memory. Type
587 * indicates the certificate format. KEY can be NULL, to indicate
588 * that GnuTLS doesn't know the private key.
591 read_key_mem (gnutls_certificate_credentials_t res
,
592 const void *key
, int key_size
, gnutls_x509_crt_fmt_t type
)
596 gnutls_privkey_t privkey
;
600 tmp
.data
= (uint8_t *) key
;
603 ret
= gnutls_privkey_init(&privkey
);
611 gnutls_privkey_set_pin_function(privkey
, res
->pin
.cb
, res
->pin
.data
);
613 ret
= gnutls_privkey_import_x509_raw (privkey
, &tmp
, type
, NULL
, 0);
620 ret
= certificate_credentials_append_pkey (res
, privkey
);
624 gnutls_privkey_deinit (privkey
);
632 return GNUTLS_E_INVALID_REQUEST
;
640 /* Reads a private key from a token.
643 read_key_url (gnutls_certificate_credentials_t res
, const char *url
)
646 gnutls_privkey_t pkey
= NULL
;
648 /* allocate space for the pkey list
650 ret
= gnutls_privkey_init (&pkey
);
658 gnutls_privkey_set_pin_function(pkey
, res
->pin
.cb
, res
->pin
.data
);
660 ret
= gnutls_privkey_import_url (pkey
, url
, 0);
667 ret
= certificate_credentials_append_pkey (res
, pkey
);
678 gnutls_privkey_deinit (pkey
);
684 /* Reads a private key from a token.
687 read_cas_url (gnutls_certificate_credentials_t res
, const char *url
)
690 gnutls_x509_crt_t
*xcrt_list
= NULL
;
691 gnutls_pkcs11_obj_t
*pcrt_list
= NULL
;
692 unsigned int pcrt_list_size
= 0;
694 /* FIXME: should we use login? */
696 gnutls_pkcs11_obj_list_import_url (NULL
, &pcrt_list_size
, url
,
697 GNUTLS_PKCS11_OBJ_ATTR_CRT_TRUSTED
, 0);
698 if (ret
< 0 && ret
!= GNUTLS_E_SHORT_MEMORY_BUFFER
)
704 if (pcrt_list_size
== 0)
710 pcrt_list
= gnutls_malloc (sizeof (*pcrt_list
) * pcrt_list_size
);
711 if (pcrt_list
== NULL
)
714 return GNUTLS_E_MEMORY_ERROR
;
718 gnutls_pkcs11_obj_list_import_url (pcrt_list
, &pcrt_list_size
, url
,
719 GNUTLS_PKCS11_OBJ_ATTR_CRT_TRUSTED
, 0);
726 xcrt_list
= gnutls_malloc (sizeof (*xcrt_list
) * pcrt_list_size
);
727 if (xcrt_list
== NULL
)
730 ret
= GNUTLS_E_MEMORY_ERROR
;
735 gnutls_x509_crt_list_import_pkcs11 (xcrt_list
, pcrt_list_size
, pcrt_list
,
743 ret
= gnutls_x509_trust_list_add_cas(res
->tlist
, xcrt_list
, pcrt_list_size
, 0);
751 gnutls_free (xcrt_list
);
752 gnutls_free (pcrt_list
);
759 /* Reads a certificate key from a token.
762 read_cert_url (gnutls_certificate_credentials_t res
, const char *url
)
765 gnutls_x509_crt_t crt
;
766 gnutls_pcert_st
*ccert
;
767 gnutls_str_array_t names
;
769 _gnutls_str_array_init(&names
);
771 ccert
= gnutls_malloc (sizeof (*ccert
));
775 return GNUTLS_E_MEMORY_ERROR
;
778 ret
= gnutls_x509_crt_init (&crt
);
786 gnutls_x509_crt_set_pin_function(crt
, res
->pin
.cb
, res
->pin
.data
);
788 ret
= gnutls_x509_crt_import_pkcs11_url (crt
, url
, 0);
789 if (ret
== GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE
)
791 gnutls_x509_crt_import_pkcs11_url (crt
, url
,
792 GNUTLS_PKCS11_OBJ_FLAG_LOGIN
);
797 gnutls_x509_crt_deinit (crt
);
801 ret
= get_x509_name(crt
, &names
);
805 gnutls_x509_crt_deinit (crt
);
809 ret
= gnutls_pcert_import_x509 (ccert
, crt
, 0);
810 gnutls_x509_crt_deinit (crt
);
818 ret
= certificate_credential_append_crt_list (res
, names
, ccert
, 1);
828 _gnutls_str_array_clear(&names
);
834 /* Reads a certificate file
837 read_cert_file (gnutls_certificate_credentials_t res
,
838 const char *certfile
, gnutls_x509_crt_fmt_t type
)
845 if (strncmp (certfile
, "pkcs11:", 7) == 0)
847 return read_cert_url (res
, certfile
);
849 #endif /* ENABLE_PKCS11 */
851 data
= read_binary_file (certfile
, &size
);
856 return GNUTLS_E_FILE_ERROR
;
859 ret
= read_cert_mem (res
, data
, size
, type
);
868 /* Reads PKCS-1 RSA private key file or a DSA file (in the format openssl
872 read_key_file (gnutls_certificate_credentials_t res
,
873 const char *keyfile
, gnutls_x509_crt_fmt_t type
)
879 if (gnutls_url_is_supported(keyfile
))
881 return read_key_url (res
, keyfile
);
884 data
= read_binary_file (keyfile
, &size
);
889 return GNUTLS_E_FILE_ERROR
;
892 ret
= read_key_mem (res
, data
, size
, type
);
899 * gnutls_certificate_set_x509_key_mem:
900 * @res: is a #gnutls_certificate_credentials_t structure.
901 * @cert: contains a certificate list (path) for the specified private key
902 * @key: is the private key, or %NULL
903 * @type: is PEM or DER
905 * This function sets a certificate/private key pair in the
906 * gnutls_certificate_credentials_t structure. This function may be called
907 * more than once, in case multiple keys/certificates exist for the
910 * Note that the keyUsage (2.5.29.15) PKIX extension in X.509 certificates
911 * is supported. This means that certificates intended for signing cannot
912 * be used for ciphersuites that require encryption.
914 * If the certificate and the private key are given in PEM encoding
915 * then the strings that hold their values must be null terminated.
917 * The @key may be %NULL if you are using a sign callback, see
918 * gnutls_sign_callback_set().
920 * Returns: %GNUTLS_E_SUCCESS (0) on success, or a negative error code.
923 gnutls_certificate_set_x509_key_mem (gnutls_certificate_credentials_t res
,
924 const gnutls_datum_t
* cert
,
925 const gnutls_datum_t
* key
,
926 gnutls_x509_crt_fmt_t type
)
930 /* this should be first
932 if ((ret
= read_key_mem (res
, key
? key
->data
: NULL
,
933 key
? key
->size
: 0, type
)) < 0)
936 if ((ret
= read_cert_mem (res
, cert
->data
, cert
->size
, type
)) < 0)
941 if (key
&& (ret
= _gnutls_check_key_cert_match (res
)) < 0)
950 static int check_if_sorted(gnutls_pcert_st
* crt
, int nr
)
952 gnutls_x509_crt_t x509
;
953 char prev_dn
[MAX_DN
];
955 size_t prev_dn_size
, dn_size
;
958 /* check if the X.509 list is ordered */
959 if (nr
> 1 && crt
[0].type
== GNUTLS_CRT_X509
)
964 ret
= gnutls_x509_crt_init(&x509
);
966 return gnutls_assert_val(ret
);
968 ret
= gnutls_x509_crt_import(x509
, &crt
[i
].cert
, GNUTLS_X509_FMT_DER
);
971 ret
= gnutls_assert_val(ret
);
977 dn_size
= sizeof(dn
);
978 ret
= gnutls_x509_crt_get_dn(x509
, dn
, &dn_size
);
981 ret
= gnutls_assert_val(ret
);
985 if (dn_size
!= prev_dn_size
|| memcmp(dn
, prev_dn
, dn_size
) != 0)
987 ret
= gnutls_assert_val(GNUTLS_E_CERTIFICATE_LIST_UNSORTED
);
992 prev_dn_size
= sizeof(prev_dn
);
993 ret
= gnutls_x509_crt_get_issuer_dn(x509
, prev_dn
, &prev_dn_size
);
996 ret
= gnutls_assert_val(ret
);
1000 gnutls_x509_crt_deinit(x509
);
1007 gnutls_x509_crt_deinit(x509
);
1012 certificate_credential_append_crt_list (gnutls_certificate_credentials_t res
,
1013 gnutls_str_array_t names
, gnutls_pcert_st
* crt
, int nr
)
1017 ret
= check_if_sorted(crt
, nr
);
1019 return gnutls_assert_val(ret
);
1021 res
->certs
= gnutls_realloc_fast (res
->certs
,
1024 if (res
->certs
== NULL
)
1027 return GNUTLS_E_MEMORY_ERROR
;
1030 res
->certs
[res
->ncerts
].cert_list
= crt
;
1031 res
->certs
[res
->ncerts
].cert_list_length
= nr
;
1032 res
->certs
[res
->ncerts
].names
= names
;
1039 certificate_credentials_append_pkey (gnutls_certificate_credentials_t res
,
1040 gnutls_privkey_t pkey
)
1042 res
->pkey
= gnutls_realloc_fast (res
->pkey
,
1044 sizeof (gnutls_privkey_t
));
1045 if (res
->pkey
== NULL
)
1048 return GNUTLS_E_MEMORY_ERROR
;
1050 res
->pkey
[res
->ncerts
] = pkey
;
1056 * gnutls_certificate_set_x509_key:
1057 * @res: is a #gnutls_certificate_credentials_t structure.
1058 * @cert_list: contains a certificate list (path) for the specified private key
1059 * @cert_list_size: holds the size of the certificate list
1060 * @key: is a #gnutls_x509_privkey_t key
1062 * This function sets a certificate/private key pair in the
1063 * gnutls_certificate_credentials_t structure. This function may be
1064 * called more than once, in case multiple keys/certificates exist for
1065 * the server. For clients that wants to send more than their own end
1066 * entity certificate (e.g., also an intermediate CA cert) then put
1067 * the certificate chain in @cert_list.
1069 * Returns: %GNUTLS_E_SUCCESS (0) on success, or a negative error code.
1074 gnutls_certificate_set_x509_key (gnutls_certificate_credentials_t res
,
1075 gnutls_x509_crt_t
* cert_list
,
1077 gnutls_x509_privkey_t key
)
1080 gnutls_privkey_t pkey
;
1081 gnutls_pcert_st
*pcerts
= NULL
;
1082 gnutls_str_array_t names
;
1084 _gnutls_str_array_init(&names
);
1086 /* this should be first
1088 ret
= gnutls_privkey_init (&pkey
);
1096 gnutls_privkey_set_pin_function(pkey
, res
->pin
.cb
, res
->pin
.data
);
1098 ret
= gnutls_privkey_import_x509 (pkey
, key
, GNUTLS_PRIVKEY_IMPORT_COPY
);
1105 ret
= certificate_credentials_append_pkey (res
, pkey
);
1112 /* load certificates */
1113 pcerts
= gnutls_malloc (sizeof (gnutls_pcert_st
) * cert_list_size
);
1117 return GNUTLS_E_MEMORY_ERROR
;
1120 ret
= get_x509_name(cert_list
[0], &names
);
1122 return gnutls_assert_val(ret
);
1124 for (i
= 0; i
< cert_list_size
; i
++)
1126 ret
= gnutls_pcert_import_x509 (&pcerts
[i
], cert_list
[i
], 0);
1134 ret
= certificate_credential_append_crt_list (res
, names
, pcerts
, cert_list_size
);
1143 if ((ret
= _gnutls_check_key_cert_match (res
)) < 0)
1152 _gnutls_str_array_clear(&names
);
1157 * gnutls_certificate_set_key:
1158 * @res: is a #gnutls_certificate_credentials_t structure.
1159 * @names: is an array of DNS name of the certificate (NULL if none)
1160 * @names_size: holds the size of the names list
1161 * @pcert_list: contains a certificate list (path) for the specified private key
1162 * @pcert_list_size: holds the size of the certificate list
1163 * @key: is a #gnutls_privkey_t key
1165 * This function sets a certificate/private key pair in the
1166 * gnutls_certificate_credentials_t structure. This function may be
1167 * called more than once, in case multiple keys/certificates exist for
1168 * the server. For clients that wants to send more than its own end
1169 * entity certificate (e.g., also an intermediate CA cert) then put
1170 * the certificate chain in @pcert_list. The @pcert_list and @key will
1171 * become part of the credentials structure and must not
1172 * be deallocated. They will be automatically deallocated when @res
1175 * Returns: %GNUTLS_E_SUCCESS (0) on success, or a negative error code.
1180 gnutls_certificate_set_key (gnutls_certificate_credentials_t res
,
1183 gnutls_pcert_st
* pcert_list
,
1184 int pcert_list_size
,
1185 gnutls_privkey_t key
)
1188 gnutls_str_array_t str_names
;
1190 _gnutls_str_array_init(&str_names
);
1192 if (names
!= NULL
&& names_size
> 0)
1194 for (i
=0;i
<names_size
;i
++)
1196 ret
= _gnutls_str_array_append(&str_names
, names
[i
], strlen(names
[i
]));
1199 ret
= gnutls_assert_val(ret
);
1206 gnutls_privkey_set_pin_function(key
, res
->pin
.cb
, res
->pin
.data
);
1208 ret
= certificate_credentials_append_pkey (res
, key
);
1215 ret
= certificate_credential_append_crt_list (res
, str_names
, pcert_list
, pcert_list_size
);
1224 if ((ret
= _gnutls_check_key_cert_match (res
)) < 0)
1233 _gnutls_str_array_clear(&str_names
);
1238 * gnutls_certificate_set_x509_key_file:
1239 * @res: is a #gnutls_certificate_credentials_t structure.
1240 * @certfile: is a file that containing the certificate list (path) for
1241 * the specified private key, in PKCS7 format, or a list of certificates
1242 * @keyfile: is a file that contains the private key
1243 * @type: is PEM or DER
1245 * This function sets a certificate/private key pair in the
1246 * gnutls_certificate_credentials_t structure. This function may be
1247 * called more than once, in case multiple keys/certificates exist for
1248 * the server. For clients that need to send more than its own end
1249 * entity certificate, e.g., also an intermediate CA cert, then the
1250 * @certfile must contain the ordered certificate chain.
1252 * This function can also accept URLs at @keyfile and @certfile. In that case it
1253 * will import the private key and certificate indicated by the URLs. Note
1254 * that the supported URLs are the ones indicated by gnutls_url_is_supported().
1256 * Returns: %GNUTLS_E_SUCCESS (0) on success, or a negative error code.
1259 gnutls_certificate_set_x509_key_file (gnutls_certificate_credentials_t res
,
1260 const char *certfile
,
1261 const char *keyfile
,
1262 gnutls_x509_crt_fmt_t type
)
1266 /* this should be first
1268 if ((ret
= read_key_file (res
, keyfile
, type
)) < 0)
1271 if ((ret
= read_cert_file (res
, certfile
, type
)) < 0)
1276 if ((ret
= _gnutls_check_key_cert_match (res
)) < 0)
1286 add_new_crt_to_rdn_seq (gnutls_certificate_credentials_t res
, gnutls_x509_crt_t
* crts
,
1287 unsigned int crt_size
)
1292 unsigned char *newdata
, *p
;
1295 /* Add DN of the last added CAs to the RDN sequence
1296 * This will be sent to clients when a certificate
1297 * request message is sent.
1300 /* FIXME: in case of a client it is not needed
1301 * to do that. This would save time and memory.
1302 * However we don't have that information available
1304 * Further, this function is now much more efficient,
1305 * so optimizing that is less important.
1308 for (i
= 0; i
< crt_size
; i
++)
1310 if ((ret
= gnutls_x509_crt_get_raw_dn (crts
[i
], &tmp
)) < 0)
1316 newsize
= res
->x509_rdn_sequence
.size
+ 2 + tmp
.size
;
1317 if (newsize
< res
->x509_rdn_sequence
.size
)
1320 _gnutls_free_datum (&tmp
);
1321 return GNUTLS_E_SHORT_MEMORY_BUFFER
;
1324 newdata
= gnutls_realloc (res
->x509_rdn_sequence
.data
, newsize
);
1325 if (newdata
== NULL
)
1328 _gnutls_free_datum (&tmp
);
1329 return GNUTLS_E_MEMORY_ERROR
;
1332 p
= newdata
+ res
->x509_rdn_sequence
.size
;
1333 _gnutls_write_uint16 (tmp
.size
, p
);
1334 if (tmp
.data
!= NULL
)
1335 memcpy (p
+2, tmp
.data
, tmp
.size
);
1337 _gnutls_free_datum (&tmp
);
1339 res
->x509_rdn_sequence
.size
= newsize
;
1340 res
->x509_rdn_sequence
.data
= newdata
;
1346 /* Returns 0 if it's ok to use the gnutls_kx_algorithm_t with this
1347 * certificate (uses the KeyUsage field).
1350 _gnutls_check_key_usage (const gnutls_pcert_st
* cert
, gnutls_kx_algorithm_t alg
)
1352 unsigned int key_usage
= 0;
1358 return GNUTLS_E_INTERNAL_ERROR
;
1361 if (_gnutls_map_kx_get_cred (alg
, 1) == GNUTLS_CRD_CERTIFICATE
||
1362 _gnutls_map_kx_get_cred (alg
, 0) == GNUTLS_CRD_CERTIFICATE
)
1365 gnutls_pubkey_get_key_usage(cert
->pubkey
, &key_usage
);
1367 encipher_type
= _gnutls_kx_encipher_type (alg
);
1369 if (key_usage
!= 0 && encipher_type
!= CIPHER_IGN
)
1371 /* If key_usage has been set in the certificate
1374 if (encipher_type
== CIPHER_ENCRYPT
)
1376 /* If the key exchange method requires an encipher
1377 * type algorithm, and key's usage does not permit
1378 * encipherment, then fail.
1380 if (!(key_usage
& GNUTLS_KEY_KEY_ENCIPHERMENT
))
1383 return GNUTLS_E_KEY_USAGE_VIOLATION
;
1387 if (encipher_type
== CIPHER_SIGN
)
1389 /* The same as above, but for sign only keys
1391 if (!(key_usage
& GNUTLS_KEY_DIGITAL_SIGNATURE
))
1394 return GNUTLS_E_KEY_USAGE_VIOLATION
;
1403 parse_pem_ca_mem (gnutls_certificate_credentials_t res
,
1404 const uint8_t * input_cert
, int input_cert_size
)
1406 gnutls_x509_crt_t
*x509_cert_list
;
1407 unsigned int x509_ncerts
;
1411 tmp
.data
= (void*)input_cert
;
1412 tmp
.size
= input_cert_size
;
1414 ret
= gnutls_x509_crt_list_import2( &x509_cert_list
, &x509_ncerts
, &tmp
,
1415 GNUTLS_X509_FMT_PEM
, 0);
1422 if ((ret
= add_new_crt_to_rdn_seq (res
, x509_cert_list
, x509_ncerts
)) < 0)
1428 ret
= gnutls_x509_trust_list_add_cas(res
->tlist
, x509_cert_list
, x509_ncerts
, 0);
1436 gnutls_free(x509_cert_list
);
1440 /* Reads a DER encoded certificate list from memory and stores it to a
1441 * gnutls_cert structure. Returns the number of certificates parsed.
1444 parse_der_ca_mem (gnutls_certificate_credentials_t res
,
1445 const void *input_cert
, int input_cert_size
)
1447 gnutls_x509_crt_t crt
;
1451 tmp
.data
= (void*)input_cert
;
1452 tmp
.size
= input_cert_size
;
1454 ret
= gnutls_x509_crt_init( &crt
);
1461 ret
= gnutls_x509_crt_import( crt
, &tmp
, GNUTLS_X509_FMT_DER
);
1468 if ((ret
= add_new_crt_to_rdn_seq (res
, &crt
, 1)) < 0)
1474 ret
= gnutls_x509_trust_list_add_cas(res
->tlist
, &crt
, 1, 0);
1484 gnutls_x509_crt_deinit(crt
);
1489 * gnutls_certificate_set_x509_trust_mem:
1490 * @res: is a #gnutls_certificate_credentials_t structure.
1491 * @ca: is a list of trusted CAs or a DER certificate
1492 * @type: is DER or PEM
1494 * This function adds the trusted CAs in order to verify client or
1495 * server certificates. In case of a client this is not required to be
1496 * called if the certificates are not verified using
1497 * gnutls_certificate_verify_peers2(). This function may be called
1500 * In case of a server the CAs set here will be sent to the client if
1501 * a certificate request is sent. This can be disabled using
1502 * gnutls_certificate_send_x509_rdn_sequence().
1504 * Returns: the number of certificates processed or a negative error code
1508 gnutls_certificate_set_x509_trust_mem (gnutls_certificate_credentials_t res
,
1509 const gnutls_datum_t
* ca
,
1510 gnutls_x509_crt_fmt_t type
)
1514 if (type
== GNUTLS_X509_FMT_DER
)
1515 ret
= parse_der_ca_mem (res
,
1516 ca
->data
, ca
->size
);
1518 ret
= parse_pem_ca_mem (res
,
1519 ca
->data
, ca
->size
);
1521 if (ret
== GNUTLS_E_NO_CERTIFICATE_FOUND
)
1528 * gnutls_certificate_set_x509_trust:
1529 * @res: is a #gnutls_certificate_credentials_t structure.
1530 * @ca_list: is a list of trusted CAs
1531 * @ca_list_size: holds the size of the CA list
1533 * This function adds the trusted CAs in order to verify client
1534 * or server certificates. In case of a client this is not required
1535 * to be called if the certificates are not verified using
1536 * gnutls_certificate_verify_peers2().
1537 * This function may be called multiple times.
1539 * In case of a server the CAs set here will be sent to the client if
1540 * a certificate request is sent. This can be disabled using
1541 * gnutls_certificate_send_x509_rdn_sequence().
1543 * Returns: the number of certificates processed or a negative error code
1549 gnutls_certificate_set_x509_trust (gnutls_certificate_credentials_t res
,
1550 gnutls_x509_crt_t
* ca_list
,
1554 gnutls_x509_crt_t new_list
[ca_list_size
];
1556 for (i
= 0; i
< ca_list_size
; i
++)
1558 ret
= gnutls_x509_crt_init (&new_list
[i
]);
1565 ret
= _gnutls_x509_crt_cpy (new_list
[i
], ca_list
[i
]);
1573 if ((ret
= add_new_crt_to_rdn_seq (res
, new_list
, ca_list_size
)) < 0)
1579 ret
= gnutls_x509_trust_list_add_cas(res
->tlist
, new_list
, ca_list_size
, 0);
1590 gnutls_x509_crt_deinit(new_list
[j
]);
1597 * gnutls_certificate_set_x509_trust_file:
1598 * @cred: is a #gnutls_certificate_credentials_t structure.
1599 * @cafile: is a file containing the list of trusted CAs (DER or PEM list)
1600 * @type: is PEM or DER
1602 * This function adds the trusted CAs in order to verify client or
1603 * server certificates. In case of a client this is not required to
1604 * be called if the certificates are not verified using
1605 * gnutls_certificate_verify_peers2(). This function may be called
1608 * In case of a server the names of the CAs set here will be sent to
1609 * the client if a certificate request is sent. This can be disabled
1610 * using gnutls_certificate_send_x509_rdn_sequence().
1612 * This function can also accept URLs. In that case it
1613 * will import all certificates that are marked as trusted. Note
1614 * that the supported URLs are the ones indicated by gnutls_url_is_supported().
1616 * Returns: number of certificates processed, or a negative error code on
1620 gnutls_certificate_set_x509_trust_file (gnutls_certificate_credentials_t cred
,
1622 gnutls_x509_crt_fmt_t type
)
1628 #ifdef ENABLE_PKCS11
1629 if (strncmp (cafile
, "pkcs11:", 7) == 0)
1631 return read_cas_url (cred
, cafile
);
1635 cas
.data
= (void*)read_binary_file (cafile
, &size
);
1636 if (cas
.data
== NULL
)
1639 return GNUTLS_E_FILE_ERROR
;
1644 ret
= gnutls_certificate_set_x509_trust_mem(cred
, &cas
, type
);
1658 * gnutls_certificate_set_x509_system_trust:
1659 * @cred: is a #gnutls_certificate_credentials_t structure.
1661 * This function adds the system's default trusted CAs in order to
1662 * verify client or server certificates.
1664 * In the case the system is currently unsupported %GNUTLS_E_UNIMPLEMENTED_FEATURE
1667 * Returns: the number of certificates processed or a negative error code
1673 gnutls_certificate_set_x509_system_trust (gnutls_certificate_credentials_t cred
)
1675 return gnutls_x509_trust_list_add_system_trust(cred
->tlist
, 0, 0);
1679 parse_pem_crl_mem (gnutls_x509_trust_list_t tlist
,
1680 const char * input_crl
, unsigned int input_crl_size
)
1682 gnutls_x509_crl_t
*x509_crl_list
;
1683 unsigned int x509_ncrls
;
1687 tmp
.data
= (void*)input_crl
;
1688 tmp
.size
= input_crl_size
;
1690 ret
= gnutls_x509_crl_list_import2( &x509_crl_list
, &x509_ncrls
, &tmp
,
1691 GNUTLS_X509_FMT_PEM
, 0);
1698 ret
= gnutls_x509_trust_list_add_crls(tlist
, x509_crl_list
, x509_ncrls
, 0, 0);
1706 gnutls_free(x509_crl_list
);
1710 /* Reads a DER encoded certificate list from memory and stores it to a
1711 * gnutls_cert structure. Returns the number of certificates parsed.
1714 parse_der_crl_mem (gnutls_x509_trust_list_t tlist
,
1715 const void *input_crl
, unsigned int input_crl_size
)
1717 gnutls_x509_crl_t crl
;
1721 tmp
.data
= (void*)input_crl
;
1722 tmp
.size
= input_crl_size
;
1724 ret
= gnutls_x509_crl_init( &crl
);
1731 ret
= gnutls_x509_crl_import( crl
, &tmp
, GNUTLS_X509_FMT_DER
);
1738 ret
= gnutls_x509_trust_list_add_crls(tlist
, &crl
, 1, 0, 0);
1748 gnutls_x509_crl_deinit(crl
);
1754 /* Reads a DER or PEM CRL from memory
1757 read_crl_mem (gnutls_certificate_credentials_t res
, const void *crl
,
1758 int crl_size
, gnutls_x509_crt_fmt_t type
)
1762 if (type
== GNUTLS_X509_FMT_DER
)
1763 ret
= parse_der_crl_mem (res
->tlist
, crl
, crl_size
);
1765 ret
= parse_pem_crl_mem (res
->tlist
, crl
, crl_size
);
1776 * gnutls_certificate_set_x509_crl_mem:
1777 * @res: is a #gnutls_certificate_credentials_t structure.
1778 * @CRL: is a list of trusted CRLs. They should have been verified before.
1779 * @type: is DER or PEM
1781 * This function adds the trusted CRLs in order to verify client or
1782 * server certificates. In case of a client this is not required to
1783 * be called if the certificates are not verified using
1784 * gnutls_certificate_verify_peers2(). This function may be called
1787 * Returns: number of CRLs processed, or a negative error code on error.
1790 gnutls_certificate_set_x509_crl_mem (gnutls_certificate_credentials_t res
,
1791 const gnutls_datum_t
* CRL
,
1792 gnutls_x509_crt_fmt_t type
)
1794 return read_crl_mem (res
, CRL
->data
, CRL
->size
, type
);
1798 * gnutls_certificate_set_x509_crl:
1799 * @res: is a #gnutls_certificate_credentials_t structure.
1800 * @crl_list: is a list of trusted CRLs. They should have been verified before.
1801 * @crl_list_size: holds the size of the crl_list
1803 * This function adds the trusted CRLs in order to verify client or
1804 * server certificates. In case of a client this is not required to
1805 * be called if the certificates are not verified using
1806 * gnutls_certificate_verify_peers2(). This function may be called
1809 * Returns: %GNUTLS_E_SUCCESS (0) on success, or a negative error code.
1814 gnutls_certificate_set_x509_crl (gnutls_certificate_credentials_t res
,
1815 gnutls_x509_crl_t
* crl_list
,
1819 gnutls_x509_crl_t new_crl
[crl_list_size
];
1821 for (i
= 0; i
< crl_list_size
; i
++)
1823 ret
= gnutls_x509_crl_init (&new_crl
[i
]);
1830 ret
= _gnutls_x509_crl_cpy (new_crl
[i
], crl_list
[i
]);
1838 ret
= gnutls_x509_trust_list_add_crls(res
->tlist
, new_crl
, crl_list_size
, 0, 0);
1849 gnutls_x509_crl_deinit(new_crl
[j
]);
1855 * gnutls_certificate_set_x509_crl_file:
1856 * @res: is a #gnutls_certificate_credentials_t structure.
1857 * @crlfile: is a file containing the list of verified CRLs (DER or PEM list)
1858 * @type: is PEM or DER
1860 * This function adds the trusted CRLs in order to verify client or server
1861 * certificates. In case of a client this is not required
1862 * to be called if the certificates are not verified using
1863 * gnutls_certificate_verify_peers2().
1864 * This function may be called multiple times.
1866 * Returns: number of CRLs processed or a negative error code on error.
1869 gnutls_certificate_set_x509_crl_file (gnutls_certificate_credentials_t res
,
1870 const char *crlfile
,
1871 gnutls_x509_crt_fmt_t type
)
1875 char *data
= (void*)read_binary_file (crlfile
, &size
);
1880 return GNUTLS_E_FILE_ERROR
;
1883 if (type
== GNUTLS_X509_FMT_DER
)
1884 ret
= parse_der_crl_mem (res
->tlist
, data
, size
);
1886 ret
= parse_pem_crl_mem (res
->tlist
, data
, size
);
1899 #include <gnutls/pkcs12.h>
1903 * gnutls_certificate_set_x509_simple_pkcs12_file:
1904 * @res: is a #gnutls_certificate_credentials_t structure.
1905 * @pkcs12file: filename of file containing PKCS#12 blob.
1906 * @type: is PEM or DER of the @pkcs12file.
1907 * @password: optional password used to decrypt PKCS#12 file, bags and keys.
1909 * This function sets a certificate/private key pair and/or a CRL in
1910 * the gnutls_certificate_credentials_t structure. This function may
1911 * be called more than once (in case multiple keys/certificates exist
1914 * PKCS#12 files with a MAC, encrypted bags and PKCS #8
1915 * private keys are supported. However,
1916 * only password based security, and the same password for all
1917 * operations, are supported.
1919 * PKCS#12 file may contain many keys and/or certificates, and there
1920 * is no way to identify which key/certificate pair you want. You
1921 * should make sure the PKCS#12 file only contain one key/certificate
1922 * pair and/or one CRL.
1924 * It is believed that the limitations of this function is acceptable
1925 * for most usage, and that any more flexibility would introduce
1926 * complexity that would make it harder to use this functionality at
1929 * Returns: %GNUTLS_E_SUCCESS (0) on success, or a negative error code.
1932 gnutls_certificate_set_x509_simple_pkcs12_file
1933 (gnutls_certificate_credentials_t res
, const char *pkcs12file
,
1934 gnutls_x509_crt_fmt_t type
, const char *password
)
1936 gnutls_datum_t p12blob
;
1940 p12blob
.data
= (void*)read_binary_file (pkcs12file
, &size
);
1941 p12blob
.size
= (unsigned int) size
;
1942 if (p12blob
.data
== NULL
)
1945 return GNUTLS_E_FILE_ERROR
;
1949 gnutls_certificate_set_x509_simple_pkcs12_mem (res
, &p12blob
, type
,
1951 free (p12blob
.data
);
1957 * gnutls_certificate_set_x509_simple_pkcs12_mem:
1958 * @res: is a #gnutls_certificate_credentials_t structure.
1959 * @p12blob: the PKCS#12 blob.
1960 * @type: is PEM or DER of the @pkcs12file.
1961 * @password: optional password used to decrypt PKCS#12 file, bags and keys.
1963 * This function sets a certificate/private key pair and/or a CRL in
1964 * the gnutls_certificate_credentials_t structure. This function may
1965 * be called more than once (in case multiple keys/certificates exist
1968 * Encrypted PKCS#12 bags and PKCS#8 private keys are supported. However,
1969 * only password based security, and the same password for all
1970 * operations, are supported.
1972 * PKCS#12 file may contain many keys and/or certificates, and there
1973 * is no way to identify which key/certificate pair you want. You
1974 * should make sure the PKCS#12 file only contain one key/certificate
1975 * pair and/or one CRL.
1977 * It is believed that the limitations of this function is acceptable
1978 * for most usage, and that any more flexibility would introduce
1979 * complexity that would make it harder to use this functionality at
1982 * Returns: %GNUTLS_E_SUCCESS (0) on success, or a negative error code.
1987 gnutls_certificate_set_x509_simple_pkcs12_mem
1988 (gnutls_certificate_credentials_t res
, const gnutls_datum_t
* p12blob
,
1989 gnutls_x509_crt_fmt_t type
, const char *password
)
1991 gnutls_pkcs12_t p12
;
1992 gnutls_x509_privkey_t key
= NULL
;
1993 gnutls_x509_crt_t
*chain
= NULL
;
1994 gnutls_x509_crl_t crl
= NULL
;
1995 unsigned int chain_size
= 0, i
;
1998 ret
= gnutls_pkcs12_init (&p12
);
2005 ret
= gnutls_pkcs12_import (p12
, p12blob
, type
, 0);
2009 gnutls_pkcs12_deinit (p12
);
2015 ret
= gnutls_pkcs12_verify_mac (p12
, password
);
2019 gnutls_pkcs12_deinit (p12
);
2024 ret
= gnutls_pkcs12_simple_parse (p12
, password
, &key
, &chain
, &chain_size
,
2025 NULL
, NULL
, &crl
, 0);
2026 gnutls_pkcs12_deinit (p12
);
2035 ret
= gnutls_certificate_set_x509_key (res
, chain
, chain_size
, key
);
2045 ret
= GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE
;
2051 ret
= gnutls_certificate_set_x509_crl (res
, &crl
, 1);
2064 for (i
=0;i
<chain_size
;i
++)
2065 gnutls_x509_crt_deinit (chain
[i
]);
2069 gnutls_x509_privkey_deinit (key
);
2071 gnutls_x509_crl_deinit (crl
);
2079 * gnutls_certificate_free_crls:
2080 * @sc: is a #gnutls_certificate_credentials_t structure.
2082 * This function will delete all the CRLs associated
2083 * with the given credentials.
2086 gnutls_certificate_free_crls (gnutls_certificate_credentials_t sc
)
2088 /* do nothing for now */
2093 * gnutls_certificate_credentials_t:
2094 * @cred: is a #gnutls_certificate_credentials_t structure.
2095 * @fn: A PIN callback
2096 * @userdata: Data to be passed in the callback
2098 * This function will set a callback function to be used when
2099 * required to access a protected object. This function overrides any other
2100 * global PIN functions.
2102 * Note that this function must be called right after initialization
2107 void gnutls_certificate_set_pin_function (gnutls_certificate_credentials_t cred
,
2108 gnutls_pin_callback_t fn
, void *userdata
)
2111 cred
->pin
.data
= userdata
;