lib/gnutls_cert.c

   1 /*
   2  * Copyright (C) 2001-2012 Free Software Foundation, Inc.
   3  *
   4  * Author: Nikos Mavrogiannopoulos
   5  *
   6  * This file is part of GnuTLS.
   7  *
   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.
  12  *
  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.
  17  *
  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/>
  20  *
  21  */
  22
  23 /* Some of the stuff needed for Certificate authentication is contained
  24  * in this file.
  25  */
  26
  27 #include <gnutls_int.h>
  28 #include <gnutls_errors.h>
  29 #include <auth/cert.h>
  30 #include <gnutls_datum.h>
  31 #include <gnutls_mpi.h>
  32 #include <gnutls_global.h>
  33 #include <algorithms.h>
  34 #include <gnutls_dh.h>
  35 #include <gnutls_str.h>
  36 #include <gnutls_state.h>
  37 #include <gnutls_auth.h>
  38 #include <gnutls_x509.h>
  39 #include <gnutls_str_array.h>
  40 #include "x509/x509_int.h"
  41 #ifdef ENABLE_OPENPGP
  42 #include "openpgp/gnutls_openpgp.h"
  43 #endif
  44
  45 /**
  46  * gnutls_certificate_free_keys:
  47  * @sc: is a #gnutls_certificate_credentials_t structure.
  48  *
  49  * This function will delete all the keys and the certificates associated
  50  * with the given credentials. This function must not be called when a
  51  * TLS negotiation that uses the credentials is in progress.
  52  *
  53  **/
  54 void
  55 gnutls_certificate_free_keys (gnutls_certificate_credentials_t sc)
  56 {
  57   unsigned i, j;
  58
  59   for (i = 0; i < sc->ncerts; i++)
  60     {
  61       for (j = 0; j < sc->certs[i].cert_list_length; j++)
  62         {
  63           gnutls_pcert_deinit (&sc->certs[i].cert_list[j]);
  64         }
  65       gnutls_free (sc->certs[i].cert_list);
  66       _gnutls_str_array_clear (&sc->certs[i].names);
  67     }
  68
  69   gnutls_free (sc->certs);
  70   sc->certs = NULL;
  71
  72   for (i = 0; i < sc->ncerts; i++)
  73     {
  74       gnutls_privkey_deinit (sc->pkey[i]);
  75     }
  76
  77   gnutls_free (sc->pkey);
  78   sc->pkey = NULL;
  79
  80   sc->ncerts = 0;
  81 }
  82
  83 /**
  84  * gnutls_certificate_free_cas:
  85  * @sc: is a #gnutls_certificate_credentials_t structure.
  86  *
  87  * This function will delete all the CAs associated with the given
  88  * credentials. Servers that do not use
  89  * gnutls_certificate_verify_peers2() may call this to save some
  90  * memory.
  91  **/
  92 void
  93 gnutls_certificate_free_cas (gnutls_certificate_credentials_t sc)
  94 {
  95   /* FIXME: do nothing for now */
  96   return;
  97 }
  98
  99 /**
 100  * gnutls_certificate_get_issuer:
 101  * @sc: is a #gnutls_certificate_credentials_t structure.
 102  * @cert: is the certificate to find issuer for
 103  * @issuer: Will hold the issuer if any. Should be treated as constant.
 104  * @flags: Use zero.
 105  *
 106  * This function will return the issuer of a given certificate.
 107  *
 108  * Returns: On success, %GNUTLS_E_SUCCESS (0) is returned, otherwise a
 109  *   negative error value.
 110  *
 111  * Since: 3.0
 112  **/
 113 int
 114 gnutls_certificate_get_issuer (gnutls_certificate_credentials_t sc,
 115   gnutls_x509_crt_t cert, gnutls_x509_crt_t* issuer, unsigned int flags)
 116 {
 117   return gnutls_x509_trust_list_get_issuer(sc->tlist, cert, issuer, flags);
 118 }
 119
 120 /**
 121  * gnutls_certificate_free_ca_names:
 122  * @sc: is a #gnutls_certificate_credentials_t structure.
 123  *
 124  * This function will delete all the CA name in the given
 125  * credentials. Clients may call this to save some memory since in
 126  * client side the CA names are not used. Servers might want to use
 127  * this function if a large list of trusted CAs is present and
 128  * sending the names of it would just consume bandwidth without providing
 129  * information to client.
 130  *
 131  * CA names are used by servers to advertise the CAs they support to
 132  * clients.
 133  **/
 134 void
 135 gnutls_certificate_free_ca_names (gnutls_certificate_credentials_t sc)
 136 {
 137   _gnutls_free_datum (&sc->x509_rdn_sequence);
 138 }
 139
 140 /*-
 141  * _gnutls_certificate_get_rsa_params - Returns the RSA parameters pointer
 142  * @rsa_params: holds the RSA parameters or NULL.
 143  * @func: function to retrieve the parameters or NULL.
 144  * @session: The session.
 145  *
 146  * This function will return the rsa parameters pointer.
 147  -*/
 148 gnutls_rsa_params_t
 149 _gnutls_certificate_get_rsa_params (gnutls_rsa_params_t rsa_params,
 150                                     gnutls_params_function * func,
 151                                     gnutls_session_t session)
 152 {
 153   gnutls_params_st params;
 154   int ret;
 155
 156   if (session->internals.params.rsa_params)
 157     {
 158       return session->internals.params.rsa_params;
 159     }
 160
 161   if (rsa_params)
 162     {
 163       session->internals.params.rsa_params = rsa_params;
 164     }
 165   else if (func)
 166     {
 167       ret = func (session, GNUTLS_PARAMS_RSA_EXPORT, &params);
 168       if (ret == 0 && params.type == GNUTLS_PARAMS_RSA_EXPORT)
 169         {
 170           session->internals.params.rsa_params = params.params.rsa_export;
 171           session->internals.params.free_rsa_params = params.deinit;
 172         }
 173     }
 174
 175   return session->internals.params.rsa_params;
 176 }
 177
 178
 179 /**
 180  * gnutls_certificate_free_credentials:
 181  * @sc: is a #gnutls_certificate_credentials_t structure.
 182  *
 183  * This structure is complex enough to manipulate directly thus this
 184  * helper function is provided in order to free (deallocate) it.
 185  *
 186  * This function does not free any temporary parameters associated
 187  * with this structure (ie RSA and DH parameters are not freed by this
 188  * function).
 189  **/
 190 void
 191 gnutls_certificate_free_credentials (gnutls_certificate_credentials_t sc)
 192 {
 193   gnutls_x509_trust_list_deinit(sc->tlist, 1);
 194   gnutls_certificate_free_keys (sc);
 195   gnutls_certificate_free_ca_names (sc);
 196
 197 #ifdef ENABLE_OPENPGP
 198   gnutls_openpgp_keyring_deinit (sc->keyring);
 199 #endif
 200
 201   gnutls_free (sc);
 202 }
 203
 204
 205 /**
 206  * gnutls_certificate_allocate_credentials:
 207  * @res: is a pointer to a #gnutls_certificate_credentials_t structure.
 208  *
 209  * This structure is complex enough to manipulate directly thus this
 210  * helper function is provided in order to allocate it.
 211  *
 212  * Returns: %GNUTLS_E_SUCCESS on success, or an error code.
 213  **/
 214 int
 215 gnutls_certificate_allocate_credentials (gnutls_certificate_credentials_t *
 216                                          res)
 217 {
 218 int ret;
 219
 220   *res = gnutls_calloc (1, sizeof (certificate_credentials_st));
 221
 222   if (*res == NULL)
 223     return GNUTLS_E_MEMORY_ERROR;
 224
 225   ret = gnutls_x509_trust_list_init( &(*res)->tlist, 0);
 226   if (ret < 0)
 227     {
 228       gnutls_assert();
 229       gnutls_free(*res);
 230       return GNUTLS_E_MEMORY_ERROR;
 231     }
 232   (*res)->verify_bits = DEFAULT_VERIFY_BITS;
 233   (*res)->verify_depth = DEFAULT_VERIFY_DEPTH;
 234   (*res)->verify_flags = GNUTLS_VERIFY_ALLOW_UNSORTED_CHAIN;
 235
 236   return 0;
 237 }
 238
 239
 240 /* returns the KX algorithms that are supported by a
 241  * certificate. (Eg a certificate with RSA params, supports
 242  * GNUTLS_KX_RSA algorithm).
 243  * This function also uses the KeyUsage field of the certificate
 244  * extensions in order to disable unneded algorithms.
 245  */
 246 int
 247 _gnutls_selected_cert_supported_kx (gnutls_session_t session,
 248                                     gnutls_kx_algorithm_t * alg,
 249                                     int *alg_size)
 250 {
 251   gnutls_kx_algorithm_t kx;
 252   gnutls_pk_algorithm_t pk, cert_pk;
 253   gnutls_pcert_st *cert;
 254   int i;
 255
 256   if (session->internals.selected_cert_list_length == 0)
 257     {
 258       *alg_size = 0;
 259       return 0;
 260     }
 261
 262   cert = &session->internals.selected_cert_list[0];
 263   cert_pk = gnutls_pubkey_get_pk_algorithm(cert->pubkey, NULL);
 264   i = 0;
 265
 266   for (kx = 0; kx < MAX_ALGOS; kx++)
 267     {
 268       pk = _gnutls_map_pk_get_pk (kx);
 269       if (pk == cert_pk)
 270         {
 271           /* then check key usage */
 272           if (_gnutls_check_key_usage (cert, kx) == 0)
 273             {
 274               alg[i] = kx;
 275               i++;
 276
 277               if (i > *alg_size)
 278                 return gnutls_assert_val(GNUTLS_E_INTERNAL_ERROR);
 279             }
 280         }
 281     }
 282
 283   if (i == 0)
 284     {
 285       gnutls_assert ();
 286       return GNUTLS_E_INVALID_REQUEST;
 287     }
 288
 289   *alg_size = i;
 290
 291   return 0;
 292 }
 293
 294
 295 /**
 296  * gnutls_certificate_server_set_request:
 297  * @session: is a #gnutls_session_t structure.
 298  * @req: is one of GNUTLS_CERT_REQUEST, GNUTLS_CERT_REQUIRE
 299  *
 300  * This function specifies if we (in case of a server) are going to
 301  * send a certificate request message to the client. If @req is
 302  * GNUTLS_CERT_REQUIRE then the server will return an error if the
 303  * peer does not provide a certificate. If you do not call this
 304  * function then the client will not be asked to send a certificate.
 305  **/
 306 void
 307 gnutls_certificate_server_set_request (gnutls_session_t session,
 308                                        gnutls_certificate_request_t req)
 309 {
 310   session->internals.send_cert_req = req;
 311 }
 312
 313 /**
 314  * gnutls_certificate_client_set_retrieve_function:
 315  * @cred: is a #gnutls_certificate_credentials_t structure.
 316  * @func: is the callback function
 317  *
 318  * This function sets a callback to be called in order to retrieve the
 319  * certificate to be used in the handshake.
 320  * You are advised to use gnutls_certificate_set_retrieve_function2() because it
 321  * is much more efficient in the processing it requires from gnutls.
 322  *
 323  * The callback's function prototype is:
 324  * int (*callback)(gnutls_session_t, const gnutls_datum_t* req_ca_dn, int nreqs,
 325  * const gnutls_pk_algorithm_t* pk_algos, int pk_algos_length, gnutls_retr_st* st);
 326  *
 327  * @req_ca_cert is only used in X.509 certificates.
 328  * Contains a list with the CA names that the server considers trusted.
 329  * Normally we should send a certificate that is signed
 330  * by one of these CAs. These names are DER encoded. To get a more
 331  * meaningful value use the function gnutls_x509_rdn_get().
 332  *
 333  * @pk_algos contains a list with server's acceptable signature algorithms.
 334  * The certificate returned should support the server's given algorithms.
 335  *
 336  * @st should contain the certificates and private keys.
 337  *
 338  * If the callback function is provided then gnutls will call it, in the
 339  * handshake, if a certificate is requested by the server (and after the
 340  * certificate request message has been received).
 341  *
 342  * The callback function should set the certificate list to be sent,
 343  * and return 0 on success. If no certificate was selected then the
 344  * number of certificates should be set to zero. The value (-1)
 345  * indicates error and the handshake will be terminated.
 346  **/
 347 void gnutls_certificate_client_set_retrieve_function
 348   (gnutls_certificate_credentials_t cred,
 349    gnutls_certificate_client_retrieve_function * func)
 350 {
 351   cred->client_get_cert_callback = func;
 352 }
 353
 354 /**
 355  * gnutls_certificate_server_set_retrieve_function:
 356  * @cred: is a #gnutls_certificate_credentials_t structure.
 357  * @func: is the callback function
 358  *
 359  * This function sets a callback to be called in order to retrieve the
 360  * certificate to be used in the handshake.
 361  * You are advised to use gnutls_certificate_set_retrieve_function2() because it
 362  * is much more efficient in the processing it requires from gnutls.
 363  *
 364  * The callback's function prototype is:
 365  * int (*callback)(gnutls_session_t, gnutls_retr_st* st);
 366  *
 367  * @st should contain the certificates and private keys.
 368  *
 369  * If the callback function is provided then gnutls will call it, in the
 370  * handshake, after the certificate request message has been received.
 371  *
 372  * The callback function should set the certificate list to be sent, and
 373  * return 0 on success.  The value (-1) indicates error and the handshake
 374  * will be terminated.
 375  **/
 376 void gnutls_certificate_server_set_retrieve_function
 377   (gnutls_certificate_credentials_t cred,
 378    gnutls_certificate_server_retrieve_function * func)
 379 {
 380   cred->server_get_cert_callback = func;
 381 }
 382
 383 /**
 384  * gnutls_certificate_set_retrieve_function:
 385  * @cred: is a #gnutls_certificate_credentials_t structure.
 386  * @func: is the callback function
 387  *
 388  * This function sets a callback to be called in order to retrieve the
 389  * certificate to be used in the handshake. You are advised
 390  * to use gnutls_certificate_set_retrieve_function2() because it
 391  * is much more efficient in the processing it requires from gnutls.
 392  *
 393  * The callback's function prototype is:
 394  * int (*callback)(gnutls_session_t, const gnutls_datum_t* req_ca_dn, int nreqs,
 395  * const gnutls_pk_algorithm_t* pk_algos, int pk_algos_length, gnutls_retr2_st* st);
 396  *
 397  * @req_ca_cert is only used in X.509 certificates.
 398  * Contains a list with the CA names that the server considers trusted.
 399  * Normally we should send a certificate that is signed
 400  * by one of these CAs. These names are DER encoded. To get a more
 401  * meaningful value use the function gnutls_x509_rdn_get().
 402  *
 403  * @pk_algos contains a list with server's acceptable signature algorithms.
 404  * The certificate returned should support the server's given algorithms.
 405  *
 406  * @st should contain the certificates and private keys.
 407  *
 408  * If the callback function is provided then gnutls will call it, in the
 409  * handshake, after the certificate request message has been received.
 410  *
 411  * In server side pk_algos and req_ca_dn are NULL.
 412  *
 413  * The callback function should set the certificate list to be sent,
 414  * and return 0 on success. If no certificate was selected then the
 415  * number of certificates should be set to zero. The value (-1)
 416  * indicates error and the handshake will be terminated.
 417  *
 418  * Since: 3.0
 419  **/
 420 void gnutls_certificate_set_retrieve_function
 421   (gnutls_certificate_credentials_t cred,
 422    gnutls_certificate_retrieve_function * func)
 423 {
 424   cred->get_cert_callback = func;
 425 }
 426
 427 /**
 428  * gnutls_certificate_set_retrieve_function2:
 429  * @cred: is a #gnutls_certificate_credentials_t structure.
 430  * @func: is the callback function
 431  *
 432  * This function sets a callback to be called in order to retrieve the
 433  * certificate to be used in the handshake.
 434  *
 435  * The callback's function prototype is:
 436  * int (*callback)(gnutls_session_t, const gnutls_datum_t* req_ca_dn, int nreqs,
 437  * const gnutls_pk_algorithm_t* pk_algos, int pk_algos_length, gnutls_pcert_st** pcert,
 438  * unsigned int *pcert_length, gnutls_privkey_t * pkey);
 439  *
 440  * @req_ca_cert is only used in X.509 certificates.
 441  * Contains a list with the CA names that the server considers trusted.
 442  * Normally we should send a certificate that is signed
 443  * by one of these CAs. These names are DER encoded. To get a more
 444  * meaningful value use the function gnutls_x509_rdn_get().
 445  *
 446  * @pk_algos contains a list with server's acceptable signature algorithms.
 447  * The certificate returned should support the server's given algorithms.
 448  *
 449  * @pcert should contain a single certificate and public or a list of them.
 450  *
 451  * @pcert_length is the size of the previous list.
 452  *
 453  * @pkey is the private key.
 454  *
 455  * If the callback function is provided then gnutls will call it, in the
 456  * handshake, after the certificate request message has been received.
 457  *
 458  * In server side pk_algos and req_ca_dn are NULL.
 459  *
 460  * The callback function should set the certificate list to be sent,
 461  * and return 0 on success. If no certificate was selected then the
 462  * number of certificates should be set to zero. The value (-1)
 463  * indicates error and the handshake will be terminated.
 464  *
 465  * Since: 3.0
 466  **/
 467 void gnutls_certificate_set_retrieve_function2
 468   (gnutls_certificate_credentials_t cred,
 469    gnutls_certificate_retrieve_function2 * func)
 470 {
 471   cred->get_cert_callback2 = func;
 472 }
 473
 474 /**
 475  * gnutls_certificate_set_verify_function:
 476  * @cred: is a #gnutls_certificate_credentials_t structure.
 477  * @func: is the callback function
 478  *
 479  * This function sets a callback to be called when peer's certificate
 480  * has been received in order to verify it on receipt rather than
 481  * doing after the handshake is completed.
 482  *
 483  * The callback's function prototype is:
 484  * int (*callback)(gnutls_session_t);
 485  *
 486  * If the callback function is provided then gnutls will call it, in the
 487  * handshake, just after the certificate message has been received.
 488  * To verify or obtain the certificate the gnutls_certificate_verify_peers2(),
 489  * gnutls_certificate_type_get(), gnutls_certificate_get_peers() functions
 490  * can be used.
 491  *
 492  * The callback function should return 0 for the handshake to continue
 493  * or non-zero to terminate.
 494  *
 495  * Since: 2.10.0
 496  **/
 497 void
 498   gnutls_certificate_set_verify_function
 499   (gnutls_certificate_credentials_t cred,
 500    gnutls_certificate_verify_function * func)
 501 {
 502   cred->verify_callback = func;
 503 }
 504
 505 /*-
 506  * _gnutls_x509_extract_certificate_activation_time - return the peer's certificate activation time
 507  * @cert: should contain an X.509 DER encoded certificate
 508  *
 509  * This function will return the certificate's activation time in UNIX time
 510  * (ie seconds since 00:00:00 UTC January 1, 1970).
 511  *
 512  * Returns a (time_t) -1 in case of an error.
 513  *
 514  -*/
 515 static time_t
 516 _gnutls_x509_get_raw_crt_activation_time (const gnutls_datum_t * cert)
 517 {
 518   gnutls_x509_crt_t xcert;
 519   time_t result;
 520
 521   result = gnutls_x509_crt_init (&xcert);
 522   if (result < 0)
 523     return (time_t) - 1;
 524
 525   result = gnutls_x509_crt_import (xcert, cert, GNUTLS_X509_FMT_DER);
 526   if (result < 0)
 527     {
 528       gnutls_x509_crt_deinit (xcert);
 529       return (time_t) - 1;
 530     }
 531
 532   result = gnutls_x509_crt_get_activation_time (xcert);
 533
 534   gnutls_x509_crt_deinit (xcert);
 535
 536   return result;
 537 }
 538
 539 /*-
 540  * gnutls_x509_extract_certificate_expiration_time:
 541  * @cert: should contain an X.509 DER encoded certificate
 542  *
 543  * This function will return the certificate's expiration time in UNIX
 544  * time (ie seconds since 00:00:00 UTC January 1, 1970).  Returns a
 545  *
 546  * (time_t) -1 in case of an error.
 547  *
 548  -*/
 549 static time_t
 550 _gnutls_x509_get_raw_crt_expiration_time (const gnutls_datum_t * cert)
 551 {
 552   gnutls_x509_crt_t xcert;
 553   time_t result;
 554
 555   result = gnutls_x509_crt_init (&xcert);
 556   if (result < 0)
 557     return (time_t) - 1;
 558
 559   result = gnutls_x509_crt_import (xcert, cert, GNUTLS_X509_FMT_DER);
 560   if (result < 0)
 561     {
 562       gnutls_x509_crt_deinit (xcert);
 563       return (time_t) - 1;
 564     }
 565
 566   result = gnutls_x509_crt_get_expiration_time (xcert);
 567
 568   gnutls_x509_crt_deinit (xcert);
 569
 570   return result;
 571 }
 572
 573 #ifdef ENABLE_OPENPGP
 574 /*-
 575  * _gnutls_openpgp_crt_verify_peers - return the peer's certificate status
 576  * @session: is a gnutls session
 577  *
 578  * This function will try to verify the peer's certificate and return its status (TRUSTED, INVALID etc.).
 579  * Returns a negative error code in case of an error, or GNUTLS_E_NO_CERTIFICATE_FOUND if no certificate was sent.
 580  -*/
 581 static int
 582 _gnutls_openpgp_crt_verify_peers (gnutls_session_t session,
 583                                   unsigned int *status)
 584 {
 585   cert_auth_info_t info;
 586   gnutls_certificate_credentials_t cred;
 587   int peer_certificate_list_size, ret;
 588
 589   CHECK_AUTH (GNUTLS_CRD_CERTIFICATE, GNUTLS_E_INVALID_REQUEST);
 590
 591   info = _gnutls_get_auth_info (session);
 592   if (info == NULL)
 593     return GNUTLS_E_INVALID_REQUEST;
 594
 595   cred = (gnutls_certificate_credentials_t)
 596     _gnutls_get_cred (session->key, GNUTLS_CRD_CERTIFICATE, NULL);
 597   if (cred == NULL)
 598     {
 599       gnutls_assert ();
 600       return GNUTLS_E_INSUFFICIENT_CREDENTIALS;
 601     }
 602
 603   if (info->raw_certificate_list == NULL || info->ncerts == 0)
 604     {
 605       gnutls_assert ();
 606       return GNUTLS_E_NO_CERTIFICATE_FOUND;
 607     }
 608
 609   /* generate a list of gnutls_certs based on the auth info
 610    * raw certs.
 611    */
 612   peer_certificate_list_size = info->ncerts;
 613
 614   if (peer_certificate_list_size != 1)
 615     {
 616       gnutls_assert ();
 617       return GNUTLS_E_INTERNAL_ERROR;
 618     }
 619
 620   /* Verify certificate
 621    */
 622   ret =
 623     _gnutls_openpgp_verify_key (cred, &info->raw_certificate_list[0],
 624                                 peer_certificate_list_size, status);
 625
 626   if (ret < 0)
 627     {
 628       gnutls_assert ();
 629       return ret;
 630     }
 631
 632   return 0;
 633 }
 634 #endif
 635
 636 /**
 637  * gnutls_certificate_verify_peers2:
 638  * @session: is a gnutls session
 639  * @status: is the output of the verification
 640  *
 641  * This function will try to verify the peer's certificate and return
 642  * its status (trusted, invalid etc.).  The value of @status should
 643  * be one or more of the gnutls_certificate_status_t enumerated
 644  * elements bitwise or'd. To avoid denial of service attacks some
 645  * default upper limits regarding the certificate key size and chain
 646  * size are set. To override them use
 647  * gnutls_certificate_set_verify_limits().
 648  *
 649  * Note that you must also check the peer's name in order to check if
 650  * the verified certificate belongs to the actual peer.
 651  *
 652  * This function uses gnutls_x509_crt_list_verify() with the CAs in
 653  * the credentials as trusted CAs.
 654  *
 655  * Returns: a negative error code on error and %GNUTLS_E_SUCCESS (0) on success.
 656  **/
 657 int
 658 gnutls_certificate_verify_peers2 (gnutls_session_t session,
 659                                   unsigned int *status)
 660 {
 661   cert_auth_info_t info;
 662
 663   CHECK_AUTH (GNUTLS_CRD_CERTIFICATE, GNUTLS_E_INVALID_REQUEST);
 664
 665   info = _gnutls_get_auth_info (session);
 666   if (info == NULL)
 667     {
 668       return GNUTLS_E_NO_CERTIFICATE_FOUND;
 669     }
 670
 671   if (info->raw_certificate_list == NULL || info->ncerts == 0)
 672     return GNUTLS_E_NO_CERTIFICATE_FOUND;
 673
 674   switch (gnutls_certificate_type_get (session))
 675     {
 676     case GNUTLS_CRT_X509:
 677       return _gnutls_x509_cert_verify_peers (session, status);
 678 #ifdef ENABLE_OPENPGP
 679     case GNUTLS_CRT_OPENPGP:
 680       return _gnutls_openpgp_crt_verify_peers (session, status);
 681 #endif
 682     default:
 683       return GNUTLS_E_INVALID_REQUEST;
 684     }
 685 }
 686
 687 /**
 688  * gnutls_certificate_expiration_time_peers:
 689  * @session: is a gnutls session
 690  *
 691  * This function will return the peer's certificate expiration time.
 692  *
 693  * Returns: (time_t)-1 on error.
 694  *
 695  * Deprecated: gnutls_certificate_verify_peers2() now verifies expiration times.
 696  **/
 697 time_t
 698 gnutls_certificate_expiration_time_peers (gnutls_session_t session)
 699 {
 700   cert_auth_info_t info;
 701
 702   CHECK_AUTH (GNUTLS_CRD_CERTIFICATE, GNUTLS_E_INVALID_REQUEST);
 703
 704   info = _gnutls_get_auth_info (session);
 705   if (info == NULL)
 706     {
 707       return (time_t) - 1;
 708     }
 709
 710   if (info->raw_certificate_list == NULL || info->ncerts == 0)
 711     {
 712       gnutls_assert ();
 713       return (time_t) - 1;
 714     }
 715
 716   switch (gnutls_certificate_type_get (session))
 717     {
 718     case GNUTLS_CRT_X509:
 719       return
 720         _gnutls_x509_get_raw_crt_expiration_time (&info->raw_certificate_list
 721                                                   [0]);
 722 #ifdef ENABLE_OPENPGP
 723     case GNUTLS_CRT_OPENPGP:
 724       return
 725         _gnutls_openpgp_get_raw_key_expiration_time
 726         (&info->raw_certificate_list[0]);
 727 #endif
 728     default:
 729       return (time_t) - 1;
 730     }
 731 }
 732
 733 /**
 734  * gnutls_certificate_activation_time_peers:
 735  * @session: is a gnutls session
 736  *
 737  * This function will return the peer's certificate activation time.
 738  * This is the creation time for openpgp keys.
 739  *
 740  * Returns: (time_t)-1 on error.
 741  *
 742  * Deprecated: gnutls_certificate_verify_peers2() now verifies activation times.
 743  **/
 744 time_t
 745 gnutls_certificate_activation_time_peers (gnutls_session_t session)
 746 {
 747   cert_auth_info_t info;
 748
 749   CHECK_AUTH (GNUTLS_CRD_CERTIFICATE, GNUTLS_E_INVALID_REQUEST);
 750
 751   info = _gnutls_get_auth_info (session);
 752   if (info == NULL)
 753     {
 754       return (time_t) - 1;
 755     }
 756
 757   if (info->raw_certificate_list == NULL || info->ncerts == 0)
 758     {
 759       gnutls_assert ();
 760       return (time_t) - 1;
 761     }
 762
 763   switch (gnutls_certificate_type_get (session))
 764     {
 765     case GNUTLS_CRT_X509:
 766       return
 767         _gnutls_x509_get_raw_crt_activation_time (&info->raw_certificate_list
 768                                                   [0]);
 769 #ifdef ENABLE_OPENPGP
 770     case GNUTLS_CRT_OPENPGP:
 771       return
 772         _gnutls_openpgp_get_raw_key_creation_time (&info->raw_certificate_list
 773                                                    [0]);
 774 #endif
 775     default:
 776       return (time_t) - 1;
 777     }
 778 }
 779
 780 /**
 781  * gnutls_sign_callback_set:
 782  * @session: is a gnutls session
 783  * @sign_func: function pointer to application's sign callback.
 784  * @userdata: void pointer that will be passed to sign callback.
 785  *
 786  * Set the callback function.  The function must have this prototype:
 787  *
 788  * typedef int (*gnutls_sign_func) (gnutls_session_t session,
 789  *                                  void *userdata,
 790  *                                  gnutls_certificate_type_t cert_type,
 791  *                                  const gnutls_datum_t * cert,
 792  *                                  const gnutls_datum_t * hash,
 793  *                                  gnutls_datum_t * signature);
 794  *
 795  * The @userdata parameter is passed to the @sign_func verbatim, and
 796  * can be used to store application-specific data needed in the
 797  * callback function.  See also gnutls_sign_callback_get().
 798  *
 799  * Deprecated: Use the PKCS 11 or #gnutls_privkey_t interfacess like gnutls_privkey_import_ext() instead.
 800  */
 801 void
 802 gnutls_sign_callback_set (gnutls_session_t session,
 803                           gnutls_sign_func sign_func, void *userdata)
 804 {
 805   session->internals.sign_func = sign_func;
 806   session->internals.sign_func_userdata = userdata;
 807 }
 808
 809 /**
 810  * gnutls_sign_callback_get:
 811  * @session: is a gnutls session
 812  * @userdata: if non-%NULL, will be set to abstract callback pointer.
 813  *
 814  * Retrieve the callback function, and its userdata pointer.
 815  *
 816  * Returns: The function pointer set by gnutls_sign_callback_set(), or
 817  *   if not set, %NULL.
 818  *
 819  * Deprecated: Use the PKCS 11 interfaces instead.
 820  */
 821 gnutls_sign_func
 822 gnutls_sign_callback_get (gnutls_session_t session, void **userdata)
 823 {
 824   if (userdata)
 825     *userdata = session->internals.sign_func_userdata;
 826   return session->internals.sign_func;
 827 }
 828
 829