2010-11-23 20:17:41 +00:00
|
|
|
/*
|
|
|
|
* virnettlscontext.h: TLS encryption/x509 handling
|
|
|
|
*
|
|
|
|
* Copyright (C) 2010-2011 Red Hat, Inc.
|
|
|
|
*
|
|
|
|
* This library is free software; you can redistribute it and/or
|
|
|
|
* modify it under the terms of the GNU Lesser General Public
|
|
|
|
* License as published by the Free Software Foundation; either
|
|
|
|
* version 2.1 of the License, or (at your option) any later version.
|
|
|
|
*
|
|
|
|
* This library is distributed in the hope that it will be useful,
|
|
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
|
|
|
* Lesser General Public License for more details.
|
|
|
|
*
|
|
|
|
* You should have received a copy of the GNU Lesser General Public
|
2012-07-21 10:06:23 +00:00
|
|
|
* License along with this library; If not, see
|
|
|
|
* <http://www.gnu.org/licenses/>.
|
2010-11-23 20:17:41 +00:00
|
|
|
*/
|
|
|
|
|
|
|
|
#ifndef __VIR_NET_TLS_CONTEXT_H__
|
|
|
|
# define __VIR_NET_TLS_CONTEXT_H__
|
|
|
|
|
|
|
|
# include "internal.h"
|
2012-07-11 13:35:48 +00:00
|
|
|
# include "virobject.h"
|
2010-11-23 20:17:41 +00:00
|
|
|
|
|
|
|
typedef struct _virNetTLSContext virNetTLSContext;
|
|
|
|
typedef virNetTLSContext *virNetTLSContextPtr;
|
|
|
|
|
|
|
|
typedef struct _virNetTLSSession virNetTLSSession;
|
|
|
|
typedef virNetTLSSession *virNetTLSSessionPtr;
|
|
|
|
|
|
|
|
|
2011-08-18 08:44:08 +00:00
|
|
|
void virNetTLSInit(void);
|
|
|
|
|
2010-11-23 20:17:41 +00:00
|
|
|
virNetTLSContextPtr virNetTLSContextNewServerPath(const char *pkipath,
|
|
|
|
bool tryUserPkiPath,
|
|
|
|
const char *const*x509dnWhitelist,
|
2011-07-21 10:13:11 +00:00
|
|
|
bool sanityCheckCert,
|
2010-11-23 20:17:41 +00:00
|
|
|
bool requireValidCert);
|
|
|
|
|
|
|
|
virNetTLSContextPtr virNetTLSContextNewClientPath(const char *pkipath,
|
|
|
|
bool tryUserPkiPath,
|
2011-07-21 10:13:11 +00:00
|
|
|
bool sanityCheckCert,
|
2010-11-23 20:17:41 +00:00
|
|
|
bool requireValidCert);
|
|
|
|
|
|
|
|
virNetTLSContextPtr virNetTLSContextNewServer(const char *cacert,
|
|
|
|
const char *cacrl,
|
|
|
|
const char *cert,
|
|
|
|
const char *key,
|
|
|
|
const char *const*x509dnWhitelist,
|
2011-07-21 10:13:11 +00:00
|
|
|
bool sanityCheckCert,
|
2010-11-23 20:17:41 +00:00
|
|
|
bool requireValidCert);
|
|
|
|
|
|
|
|
virNetTLSContextPtr virNetTLSContextNewClient(const char *cacert,
|
|
|
|
const char *cacrl,
|
|
|
|
const char *cert,
|
|
|
|
const char *key,
|
2011-07-21 10:13:11 +00:00
|
|
|
bool sanityCheckCert,
|
2010-11-23 20:17:41 +00:00
|
|
|
bool requireValidCert);
|
|
|
|
|
|
|
|
int virNetTLSContextCheckCertificate(virNetTLSContextPtr ctxt,
|
|
|
|
virNetTLSSessionPtr sess);
|
|
|
|
|
|
|
|
|
|
|
|
typedef ssize_t (*virNetTLSSessionWriteFunc)(const char *buf, size_t len,
|
|
|
|
void *opaque);
|
|
|
|
typedef ssize_t (*virNetTLSSessionReadFunc)(char *buf, size_t len,
|
|
|
|
void *opaque);
|
|
|
|
|
|
|
|
virNetTLSSessionPtr virNetTLSSessionNew(virNetTLSContextPtr ctxt,
|
|
|
|
const char *hostname);
|
|
|
|
|
|
|
|
void virNetTLSSessionSetIOCallbacks(virNetTLSSessionPtr sess,
|
|
|
|
virNetTLSSessionWriteFunc writeFunc,
|
|
|
|
virNetTLSSessionReadFunc readFunc,
|
|
|
|
void *opaque);
|
|
|
|
|
|
|
|
ssize_t virNetTLSSessionWrite(virNetTLSSessionPtr sess,
|
|
|
|
const char *buf, size_t len);
|
|
|
|
ssize_t virNetTLSSessionRead(virNetTLSSessionPtr sess,
|
|
|
|
char *buf, size_t len);
|
|
|
|
|
|
|
|
int virNetTLSSessionHandshake(virNetTLSSessionPtr sess);
|
|
|
|
|
|
|
|
typedef enum {
|
|
|
|
VIR_NET_TLS_HANDSHAKE_COMPLETE,
|
|
|
|
VIR_NET_TLS_HANDSHAKE_SENDING,
|
|
|
|
VIR_NET_TLS_HANDSHAKE_RECVING,
|
|
|
|
} virNetTLSSessionHandshakeStatus;
|
|
|
|
|
|
|
|
virNetTLSSessionHandshakeStatus
|
|
|
|
virNetTLSSessionGetHandshakeStatus(virNetTLSSessionPtr sess);
|
|
|
|
|
|
|
|
int virNetTLSSessionGetKeySize(virNetTLSSessionPtr sess);
|
|
|
|
|
|
|
|
#endif
|