vnc-tls.h

   1 /*
   2  * QEMU VNC display driver. TLS helpers
   3  *
   4  * Copyright (C) 2006 Anthony Liguori <anthony@codemonkey.ws>
   5  * Copyright (C) 2006 Fabrice Bellard
   6  * Copyright (C) 2009 Red Hat, Inc
   7  *
   8  * Permission is hereby granted, free of charge, to any person obtaining a copy
   9  * of this software and associated documentation files (the "Software"), to deal
  10  * in the Software without restriction, including without limitation the rights
  11  * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
  12  * copies of the Software, and to permit persons to whom the Software is
  13  * furnished to do so, subject to the following conditions:
  14  *
  15  * The above copyright notice and this permission notice shall be included in
  16  * all copies or substantial portions of the Software.
  17  *
  18  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
  19  * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
  20  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
  21  * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
  22  * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
  23  * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
  24  * THE SOFTWARE.
  25  */
  26
  27
  28 #ifndef __QEMU_VNC_TLS_H__
  29 #define __QEMU_VNC_TLS_H__
  30
  31 #include <gnutls/gnutls.h>
  32 #include <gnutls/x509.h>
  33
  34 enum {
  35     VNC_WIREMODE_CLEAR,
  36     VNC_WIREMODE_TLS,
  37 };
  38
  39 typedef struct VncDisplayTLS VncDisplayTLS;
  40 typedef struct VncStateTLS VncStateTLS;
  41
  42 /* Server state */
  43 struct VncDisplayTLS {
  44     int x509verify; /* Non-zero if server requests & validates client cert */
  45
  46     /* Paths to x509 certs/keys */
  47     char *x509cacert;
  48     char *x509cacrl;
  49     char *x509cert;
  50     char *x509key;
  51 };
  52
  53 /* Per client state */
  54 struct VncStateTLS {
  55     /* Whether data is being TLS encrypted yet */
  56     int wiremode;
  57     gnutls_session_t session;
  58 };
  59
  60 int vnc_tls_client_setup(VncState *vs, int x509Creds);
  61 void vnc_tls_client_cleanup(VncState *vs);
  62
  63 int vnc_tls_validate_certificate(VncState *vs);
  64
  65 int vnc_tls_set_x509_creds_dir(VncDisplay *vd,
  66                                const char *path);
  67
  68
  69 #endif /* __QEMU_VNC_TLS_H__ */
  70