2 * QEMU crypto TLS x509 credential support
4 * Copyright (c) 2015 Red Hat, Inc.
6 * This library is free software; you can redistribute it and/or
7 * modify it under the terms of the GNU Lesser General Public
8 * License as published by the Free Software Foundation; either
9 * version 2.1 of the License, or (at your option) any later version.
11 * This library is distributed in the hope that it will be useful,
12 * but WITHOUT ANY WARRANTY; without even the implied warranty of
13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
14 * Lesser General Public License for more details.
16 * You should have received a copy of the GNU Lesser General Public
17 * License along with this library; if not, see <http://www.gnu.org/licenses/>.
21 #include "qemu/osdep.h"
22 #include "crypto/tlscredsx509.h"
23 #include "tlscredspriv.h"
24 #include "crypto/secret.h"
25 #include "qapi/error.h"
26 #include "qemu/module.h"
27 #include "qom/object_interfaces.h"
33 #include <gnutls/x509.h>
37 qcrypto_tls_creds_check_cert_times(gnutls_x509_crt_t cert
,
43 time_t now
= time(NULL
);
45 if (now
== ((time_t)-1)) {
46 error_setg_errno(errp
, errno
, "cannot get current time");
50 if (gnutls_x509_crt_get_expiration_time(cert
) < now
) {
53 "The CA certificate %s has expired" :
55 "The server certificate %s has expired" :
56 "The client certificate %s has expired")),
61 if (gnutls_x509_crt_get_activation_time(cert
) > now
) {
64 "The CA certificate %s is not yet active" :
66 "The server certificate %s is not yet active" :
67 "The client certificate %s is not yet active")),
77 qcrypto_tls_creds_check_cert_basic_constraints(QCryptoTLSCredsX509
*creds
,
78 gnutls_x509_crt_t cert
,
86 status
= gnutls_x509_crt_get_basic_constraints(cert
, NULL
, NULL
, NULL
);
87 trace_qcrypto_tls_creds_x509_check_basic_constraints(
88 creds
, certFile
, status
);
90 if (status
> 0) { /* It is a CA cert */
92 error_setg(errp
, isServer
?
93 "The certificate %s basic constraints show a CA, "
94 "but we need one for a server" :
95 "The certificate %s basic constraints show a CA, "
96 "but we need one for a client",
100 } else if (status
== 0) { /* It is not a CA cert */
103 "The certificate %s basic constraints do not "
108 } else if (status
== GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE
) {
109 /* Missing basicConstraints */
112 "The certificate %s is missing basic constraints "
117 } else { /* General error */
119 "Unable to query certificate %s basic constraints: %s",
120 certFile
, gnutls_strerror(status
));
129 qcrypto_tls_creds_check_cert_key_usage(QCryptoTLSCredsX509
*creds
,
130 gnutls_x509_crt_t cert
,
131 const char *certFile
,
136 unsigned int usage
= 0;
137 unsigned int critical
= 0;
139 status
= gnutls_x509_crt_get_key_usage(cert
, &usage
, &critical
);
140 trace_qcrypto_tls_creds_x509_check_key_usage(
141 creds
, certFile
, status
, usage
, critical
);
144 if (status
== GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE
) {
145 usage
= isCA
? GNUTLS_KEY_KEY_CERT_SIGN
:
146 GNUTLS_KEY_DIGITAL_SIGNATURE
| GNUTLS_KEY_KEY_ENCIPHERMENT
;
149 "Unable to query certificate %s key usage: %s",
150 certFile
, gnutls_strerror(status
));
156 if (!(usage
& GNUTLS_KEY_KEY_CERT_SIGN
)) {
159 "Certificate %s usage does not permit "
160 "certificate signing", certFile
);
165 if (!(usage
& GNUTLS_KEY_DIGITAL_SIGNATURE
)) {
168 "Certificate %s usage does not permit digital "
169 "signature", certFile
);
173 if (!(usage
& GNUTLS_KEY_KEY_ENCIPHERMENT
)) {
176 "Certificate %s usage does not permit key "
177 "encipherment", certFile
);
188 qcrypto_tls_creds_check_cert_key_purpose(QCryptoTLSCredsX509
*creds
,
189 gnutls_x509_crt_t cert
,
190 const char *certFile
,
196 unsigned int purposeCritical
;
197 unsigned int critical
;
200 bool allowClient
= false, allowServer
= false;
205 status
= gnutls_x509_crt_get_key_purpose_oid(cert
, i
, buffer
,
208 if (status
== GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE
) {
210 /* If there is no data at all, then we must allow
211 client/server to pass */
213 allowServer
= allowClient
= true;
217 if (status
!= GNUTLS_E_SHORT_MEMORY_BUFFER
) {
219 "Unable to query certificate %s key purpose: %s",
220 certFile
, gnutls_strerror(status
));
224 buffer
= g_new0(char, size
);
226 status
= gnutls_x509_crt_get_key_purpose_oid(cert
, i
, buffer
,
227 &size
, &purposeCritical
);
230 trace_qcrypto_tls_creds_x509_check_key_purpose(
231 creds
, certFile
, status
, "<none>", purposeCritical
);
234 "Unable to query certificate %s key purpose: %s",
235 certFile
, gnutls_strerror(status
));
238 trace_qcrypto_tls_creds_x509_check_key_purpose(
239 creds
, certFile
, status
, buffer
, purposeCritical
);
240 if (purposeCritical
) {
244 if (g_str_equal(buffer
, GNUTLS_KP_TLS_WWW_SERVER
)) {
246 } else if (g_str_equal(buffer
, GNUTLS_KP_TLS_WWW_CLIENT
)) {
248 } else if (g_str_equal(buffer
, GNUTLS_KP_ANY
)) {
249 allowServer
= allowClient
= true;
260 "Certificate %s purpose does not allow "
261 "use with a TLS server", certFile
);
269 "Certificate %s purpose does not allow use "
270 "with a TLS client", certFile
);
281 qcrypto_tls_creds_check_cert(QCryptoTLSCredsX509
*creds
,
282 gnutls_x509_crt_t cert
,
283 const char *certFile
,
288 if (qcrypto_tls_creds_check_cert_times(cert
, certFile
,
294 if (qcrypto_tls_creds_check_cert_basic_constraints(creds
,
301 if (qcrypto_tls_creds_check_cert_key_usage(creds
,
308 qcrypto_tls_creds_check_cert_key_purpose(creds
,
310 isServer
, errp
) < 0) {
319 qcrypto_tls_creds_check_cert_pair(gnutls_x509_crt_t cert
,
320 const char *certFile
,
321 gnutls_x509_crt_t
*cacerts
,
323 const char *cacertFile
,
329 if (gnutls_x509_crt_list_verify(&cert
, 1,
333 error_setg(errp
, isServer
?
334 "Unable to verify server certificate %s against "
335 "CA certificate %s" :
336 "Unable to verify client certificate %s against "
338 certFile
, cacertFile
);
343 const char *reason
= "Invalid certificate";
345 if (status
& GNUTLS_CERT_INVALID
) {
346 reason
= "The certificate is not trusted";
349 if (status
& GNUTLS_CERT_SIGNER_NOT_FOUND
) {
350 reason
= "The certificate hasn't got a known issuer";
353 if (status
& GNUTLS_CERT_REVOKED
) {
354 reason
= "The certificate has been revoked";
357 if (status
& GNUTLS_CERT_INSECURE_ALGORITHM
) {
358 reason
= "The certificate uses an insecure algorithm";
362 "Our own certificate %s failed validation against %s: %s",
363 certFile
, cacertFile
, reason
);
371 static gnutls_x509_crt_t
372 qcrypto_tls_creds_load_cert(QCryptoTLSCredsX509
*creds
,
373 const char *certFile
,
378 gnutls_x509_crt_t cert
= NULL
;
379 g_autofree
char *buf
= NULL
;
385 trace_qcrypto_tls_creds_x509_load_cert(creds
, isServer
, certFile
);
387 err
= gnutls_x509_crt_init(&cert
);
389 error_setg(errp
, "Unable to initialize certificate: %s",
390 gnutls_strerror(err
));
394 if (!g_file_get_contents(certFile
, &buf
, &buflen
, &gerr
)) {
395 error_setg(errp
, "Cannot load CA cert list %s: %s",
396 certFile
, gerr
->message
);
401 data
.data
= (unsigned char *)buf
;
402 data
.size
= strlen(buf
);
404 err
= gnutls_x509_crt_import(cert
, &data
, GNUTLS_X509_FMT_PEM
);
406 error_setg(errp
, isServer
?
407 "Unable to import server certificate %s: %s" :
408 "Unable to import client certificate %s: %s",
410 gnutls_strerror(err
));
418 gnutls_x509_crt_deinit(cert
);
426 qcrypto_tls_creds_load_ca_cert_list(QCryptoTLSCredsX509
*creds
,
427 const char *certFile
,
428 gnutls_x509_crt_t
*certs
,
429 unsigned int certMax
,
434 g_autofree
char *buf
= NULL
;
439 trace_qcrypto_tls_creds_x509_load_cert_list(creds
, certFile
);
441 if (!g_file_get_contents(certFile
, &buf
, &buflen
, &gerr
)) {
442 error_setg(errp
, "Cannot load CA cert list %s: %s",
443 certFile
, gerr
->message
);
448 data
.data
= (unsigned char *)buf
;
449 data
.size
= strlen(buf
);
451 if (gnutls_x509_crt_list_import(certs
, &certMax
, &data
,
452 GNUTLS_X509_FMT_PEM
, 0) < 0) {
454 "Unable to import CA certificate list %s",
466 qcrypto_tls_creds_x509_sanity_check(QCryptoTLSCredsX509
*creds
,
468 const char *cacertFile
,
469 const char *certFile
,
472 gnutls_x509_crt_t cert
= NULL
;
473 gnutls_x509_crt_t cacerts
[MAX_CERTS
];
478 memset(cacerts
, 0, sizeof(cacerts
));
480 access(certFile
, R_OK
) == 0) {
481 cert
= qcrypto_tls_creds_load_cert(creds
,
488 if (access(cacertFile
, R_OK
) == 0) {
489 if (qcrypto_tls_creds_load_ca_cert_list(creds
,
491 MAX_CERTS
, &ncacerts
,
498 qcrypto_tls_creds_check_cert(creds
,
499 cert
, certFile
, isServer
,
504 for (i
= 0; i
< ncacerts
; i
++) {
505 if (qcrypto_tls_creds_check_cert(creds
,
506 cacerts
[i
], cacertFile
,
507 isServer
, true, errp
) < 0) {
512 if (cert
&& ncacerts
&&
513 qcrypto_tls_creds_check_cert_pair(cert
, certFile
, cacerts
,
514 ncacerts
, cacertFile
,
515 isServer
, errp
) < 0) {
523 gnutls_x509_crt_deinit(cert
);
525 for (i
= 0; i
< ncacerts
; i
++) {
526 gnutls_x509_crt_deinit(cacerts
[i
]);
533 qcrypto_tls_creds_x509_load(QCryptoTLSCredsX509
*creds
,
536 char *cacert
= NULL
, *cacrl
= NULL
, *cert
= NULL
,
537 *key
= NULL
, *dhparams
= NULL
;
541 trace_qcrypto_tls_creds_x509_load(creds
,
542 creds
->parent_obj
.dir
? creds
->parent_obj
.dir
: "<nodir>");
544 if (creds
->parent_obj
.endpoint
== QCRYPTO_TLS_CREDS_ENDPOINT_SERVER
) {
545 if (qcrypto_tls_creds_get_path(&creds
->parent_obj
,
546 QCRYPTO_TLS_CREDS_X509_CA_CERT
,
547 true, &cacert
, errp
) < 0 ||
548 qcrypto_tls_creds_get_path(&creds
->parent_obj
,
549 QCRYPTO_TLS_CREDS_X509_CA_CRL
,
550 false, &cacrl
, errp
) < 0 ||
551 qcrypto_tls_creds_get_path(&creds
->parent_obj
,
552 QCRYPTO_TLS_CREDS_X509_SERVER_CERT
,
553 true, &cert
, errp
) < 0 ||
554 qcrypto_tls_creds_get_path(&creds
->parent_obj
,
555 QCRYPTO_TLS_CREDS_X509_SERVER_KEY
,
556 true, &key
, errp
) < 0 ||
557 qcrypto_tls_creds_get_path(&creds
->parent_obj
,
558 QCRYPTO_TLS_CREDS_DH_PARAMS
,
559 false, &dhparams
, errp
) < 0) {
563 if (qcrypto_tls_creds_get_path(&creds
->parent_obj
,
564 QCRYPTO_TLS_CREDS_X509_CA_CERT
,
565 true, &cacert
, errp
) < 0 ||
566 qcrypto_tls_creds_get_path(&creds
->parent_obj
,
567 QCRYPTO_TLS_CREDS_X509_CLIENT_CERT
,
568 false, &cert
, errp
) < 0 ||
569 qcrypto_tls_creds_get_path(&creds
->parent_obj
,
570 QCRYPTO_TLS_CREDS_X509_CLIENT_KEY
,
571 false, &key
, errp
) < 0) {
576 if (creds
->sanityCheck
&&
577 qcrypto_tls_creds_x509_sanity_check(creds
,
578 creds
->parent_obj
.endpoint
== QCRYPTO_TLS_CREDS_ENDPOINT_SERVER
,
579 cacert
, cert
, errp
) < 0) {
583 ret
= gnutls_certificate_allocate_credentials(&creds
->data
);
585 error_setg(errp
, "Cannot allocate credentials: '%s'",
586 gnutls_strerror(ret
));
590 ret
= gnutls_certificate_set_x509_trust_file(creds
->data
,
592 GNUTLS_X509_FMT_PEM
);
594 error_setg(errp
, "Cannot load CA certificate '%s': %s",
595 cacert
, gnutls_strerror(ret
));
599 if (cert
!= NULL
&& key
!= NULL
) {
600 char *password
= NULL
;
601 if (creds
->passwordid
) {
602 password
= qcrypto_secret_lookup_as_utf8(creds
->passwordid
,
608 ret
= gnutls_certificate_set_x509_key_file2(creds
->data
,
615 error_setg(errp
, "Cannot load certificate '%s' & key '%s': %s",
616 cert
, key
, gnutls_strerror(ret
));
622 ret
= gnutls_certificate_set_x509_crl_file(creds
->data
,
624 GNUTLS_X509_FMT_PEM
);
626 error_setg(errp
, "Cannot load CRL '%s': %s",
627 cacrl
, gnutls_strerror(ret
));
632 if (creds
->parent_obj
.endpoint
== QCRYPTO_TLS_CREDS_ENDPOINT_SERVER
) {
633 if (qcrypto_tls_creds_get_dh_params_file(&creds
->parent_obj
, dhparams
,
634 &creds
->parent_obj
.dh_params
,
638 gnutls_certificate_set_dh_params(creds
->data
,
639 creds
->parent_obj
.dh_params
);
654 qcrypto_tls_creds_x509_unload(QCryptoTLSCredsX509
*creds
)
657 gnutls_certificate_free_credentials(creds
->data
);
660 if (creds
->parent_obj
.dh_params
) {
661 gnutls_dh_params_deinit(creds
->parent_obj
.dh_params
);
662 creds
->parent_obj
.dh_params
= NULL
;
667 #else /* ! CONFIG_GNUTLS */
671 qcrypto_tls_creds_x509_load(QCryptoTLSCredsX509
*creds G_GNUC_UNUSED
,
674 error_setg(errp
, "TLS credentials support requires GNUTLS");
679 qcrypto_tls_creds_x509_unload(QCryptoTLSCredsX509
*creds G_GNUC_UNUSED
)
685 #endif /* ! CONFIG_GNUTLS */
689 qcrypto_tls_creds_x509_prop_set_loaded(Object
*obj
,
693 QCryptoTLSCredsX509
*creds
= QCRYPTO_TLS_CREDS_X509(obj
);
695 qcrypto_tls_creds_x509_unload(creds
);
697 qcrypto_tls_creds_x509_load(creds
, errp
);
706 qcrypto_tls_creds_x509_prop_get_loaded(Object
*obj
,
707 Error
**errp G_GNUC_UNUSED
)
709 QCryptoTLSCredsX509
*creds
= QCRYPTO_TLS_CREDS_X509(obj
);
711 return creds
->data
!= NULL
;
715 #else /* ! CONFIG_GNUTLS */
719 qcrypto_tls_creds_x509_prop_get_loaded(Object
*obj G_GNUC_UNUSED
,
720 Error
**errp G_GNUC_UNUSED
)
726 #endif /* ! CONFIG_GNUTLS */
730 qcrypto_tls_creds_x509_prop_set_sanity(Object
*obj
,
732 Error
**errp G_GNUC_UNUSED
)
734 QCryptoTLSCredsX509
*creds
= QCRYPTO_TLS_CREDS_X509(obj
);
736 creds
->sanityCheck
= value
;
741 qcrypto_tls_creds_x509_prop_set_passwordid(Object
*obj
,
743 Error
**errp G_GNUC_UNUSED
)
745 QCryptoTLSCredsX509
*creds
= QCRYPTO_TLS_CREDS_X509(obj
);
747 creds
->passwordid
= g_strdup(value
);
752 qcrypto_tls_creds_x509_prop_get_passwordid(Object
*obj
,
753 Error
**errp G_GNUC_UNUSED
)
755 QCryptoTLSCredsX509
*creds
= QCRYPTO_TLS_CREDS_X509(obj
);
757 return g_strdup(creds
->passwordid
);
762 qcrypto_tls_creds_x509_prop_get_sanity(Object
*obj
,
763 Error
**errp G_GNUC_UNUSED
)
765 QCryptoTLSCredsX509
*creds
= QCRYPTO_TLS_CREDS_X509(obj
);
767 return creds
->sanityCheck
;
775 qcrypto_tls_creds_x509_reload(QCryptoTLSCreds
*creds
, Error
**errp
)
777 QCryptoTLSCredsX509
*x509_creds
= QCRYPTO_TLS_CREDS_X509(creds
);
778 Error
*local_err
= NULL
;
779 gnutls_certificate_credentials_t creds_data
= x509_creds
->data
;
780 gnutls_dh_params_t creds_dh_params
= x509_creds
->parent_obj
.dh_params
;
782 x509_creds
->data
= NULL
;
783 x509_creds
->parent_obj
.dh_params
= NULL
;
784 qcrypto_tls_creds_x509_load(x509_creds
, &local_err
);
786 qcrypto_tls_creds_x509_unload(x509_creds
);
787 x509_creds
->data
= creds_data
;
788 x509_creds
->parent_obj
.dh_params
= creds_dh_params
;
789 error_propagate(errp
, local_err
);
794 gnutls_certificate_free_credentials(creds_data
);
796 if (creds_dh_params
) {
797 gnutls_dh_params_deinit(creds_dh_params
);
803 #else /* ! CONFIG_GNUTLS */
807 qcrypto_tls_creds_x509_reload(QCryptoTLSCreds
*creds
, Error
**errp
)
813 #endif /* ! CONFIG_GNUTLS */
817 qcrypto_tls_creds_x509_complete(UserCreatable
*uc
, Error
**errp
)
819 object_property_set_bool(OBJECT(uc
), "loaded", true, errp
);
824 qcrypto_tls_creds_x509_init(Object
*obj
)
826 QCryptoTLSCredsX509
*creds
= QCRYPTO_TLS_CREDS_X509(obj
);
828 creds
->sanityCheck
= true;
833 qcrypto_tls_creds_x509_finalize(Object
*obj
)
835 QCryptoTLSCredsX509
*creds
= QCRYPTO_TLS_CREDS_X509(obj
);
837 g_free(creds
->passwordid
);
838 qcrypto_tls_creds_x509_unload(creds
);
843 qcrypto_tls_creds_x509_class_init(ObjectClass
*oc
, void *data
)
845 UserCreatableClass
*ucc
= USER_CREATABLE_CLASS(oc
);
846 QCryptoTLSCredsClass
*ctcc
= QCRYPTO_TLS_CREDS_CLASS(oc
);
848 ctcc
->reload
= qcrypto_tls_creds_x509_reload
;
850 ucc
->complete
= qcrypto_tls_creds_x509_complete
;
852 object_class_property_add_bool(oc
, "loaded",
853 qcrypto_tls_creds_x509_prop_get_loaded
,
854 qcrypto_tls_creds_x509_prop_set_loaded
);
855 object_class_property_add_bool(oc
, "sanity-check",
856 qcrypto_tls_creds_x509_prop_get_sanity
,
857 qcrypto_tls_creds_x509_prop_set_sanity
);
858 object_class_property_add_str(oc
, "passwordid",
859 qcrypto_tls_creds_x509_prop_get_passwordid
,
860 qcrypto_tls_creds_x509_prop_set_passwordid
);
864 static const TypeInfo qcrypto_tls_creds_x509_info
= {
865 .parent
= TYPE_QCRYPTO_TLS_CREDS
,
866 .name
= TYPE_QCRYPTO_TLS_CREDS_X509
,
867 .instance_size
= sizeof(QCryptoTLSCredsX509
),
868 .instance_init
= qcrypto_tls_creds_x509_init
,
869 .instance_finalize
= qcrypto_tls_creds_x509_finalize
,
870 .class_size
= sizeof(QCryptoTLSCredsX509Class
),
871 .class_init
= qcrypto_tls_creds_x509_class_init
,
872 .interfaces
= (InterfaceInfo
[]) {
873 { TYPE_USER_CREATABLE
},
880 qcrypto_tls_creds_x509_register_types(void)
882 type_register_static(&qcrypto_tls_creds_x509_info
);
886 type_init(qcrypto_tls_creds_x509_register_types
);