2
* qcaprovider.h - QCA Plugin API
3
* Copyright (C) 2003 Justin Karneges
5
* This library is free software; you can redistribute it and/or
6
* modify it under the terms of the GNU Lesser General Public
7
* License as published by the Free Software Foundation; either
8
* version 2.1 of the License, or (at your option) any later version.
10
* This library is distributed in the hope that it will be useful,
11
* but WITHOUT ANY WARRANTY; without even the implied warranty of
12
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
13
* Lesser General Public License for more details.
15
* You should have received a copy of the GNU Lesser General Public
16
* License along with this library; if not, write to the Free Software
17
* Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
28
#include<qhostaddress.h>
31
#define QCA_PLUGIN_VERSION 1
37
virtual ~QCAProvider() {}
39
virtual void init()=0;
40
virtual int qcaVersion() const=0;
41
virtual int capabilities() const=0;
42
virtual void *context(int cap)=0;
48
virtual ~QCA_HashContext() {}
50
virtual QCA_HashContext *clone()=0;
51
virtual void reset()=0;
52
virtual void update(const char *in, unsigned int len)=0;
53
virtual void final(QByteArray *out)=0;
56
class QCA_CipherContext
59
virtual ~QCA_CipherContext() {}
61
virtual QCA_CipherContext *clone()=0;
62
virtual int keySize()=0;
63
virtual int blockSize()=0;
64
virtual bool generateKey(char *out, int keysize=-1)=0;
65
virtual bool generateIV(char *out)=0;
67
virtual bool setup(int dir, int mode, const char *key, int keysize, const char *iv, bool pad)=0;
68
virtual bool update(const char *in, unsigned int len)=0;
69
virtual bool final(QByteArray *out)=0;
72
class QCA_RSAKeyContext
75
virtual ~QCA_RSAKeyContext() {}
77
virtual QCA_RSAKeyContext *clone() const=0;
78
virtual bool isNull() const=0;
79
virtual bool havePublic() const=0;
80
virtual bool havePrivate() const=0;
81
virtual bool createFromDER(const char *in, unsigned int len)=0;
82
virtual bool createFromPEM(const char *in, unsigned int len)=0;
83
virtual bool createFromNative(void *in)=0;
84
virtual bool generate(unsigned int bits)=0;
85
virtual bool toDER(QByteArray *out, bool publicOnly)=0;
86
virtual bool toPEM(QByteArray *out, bool publicOnly)=0;
88
virtual bool encrypt(const QByteArray &in, QByteArray *out, bool oaep)=0;
89
virtual bool decrypt(const QByteArray &in, QByteArray *out, bool oaep)=0;
92
struct QCA_CertProperty
101
virtual ~QCA_CertContext() {}
103
virtual QCA_CertContext *clone() const=0;
104
virtual bool isNull() const=0;
105
virtual bool createFromDER(const char *in, unsigned int len)=0;
106
virtual bool createFromPEM(const char *in, unsigned int len)=0;
107
virtual bool toDER(QByteArray *out)=0;
108
virtual bool toPEM(QByteArray *out)=0;
110
virtual QString serialNumber() const=0;
111
virtual QString subjectString() const=0;
112
virtual QString issuerString() const=0;
113
virtual QValueList<QCA_CertProperty> subject() const=0;
114
virtual QValueList<QCA_CertProperty> issuer() const=0;
115
virtual QDateTime notBefore() const=0;
116
virtual QDateTime notAfter() const=0;
117
virtual bool matchesAddress(const QString &realHost) const=0;
123
enum Result { Success, Error, Continue };
124
virtual ~QCA_TLSContext() {}
126
virtual void reset()=0;
127
virtual bool startClient(const QPtrList<QCA_CertContext> &store, const QCA_CertContext &cert, const QCA_RSAKeyContext &key)=0;
128
virtual bool startServer(const QPtrList<QCA_CertContext> &store, const QCA_CertContext &cert, const QCA_RSAKeyContext &key)=0;
130
virtual int handshake(const QByteArray &in, QByteArray *out)=0;
131
virtual int shutdown(const QByteArray &in, QByteArray *out)=0;
132
virtual bool encode(const QByteArray &plain, QByteArray *to_net, int *encoded)=0;
133
virtual bool decode(const QByteArray &from_net, QByteArray *plain, QByteArray *to_net)=0;
134
virtual bool eof() const=0;
135
virtual QByteArray unprocessed()=0;
137
virtual QCA_CertContext *peerCertificate() const=0;
138
virtual int validityResult() const=0;
141
struct QCA_SASLHostPort
147
struct QCA_SASLNeedParams
149
bool user, authzid, pass, realm;
152
class QCA_SASLContext
155
enum Result { Success, Error, NeedParams, AuthCheck, Continue };
156
virtual ~QCA_SASLContext() {}
159
virtual void reset()=0;
160
virtual void setCoreProps(const QString &service, const QString &host, QCA_SASLHostPort *local, QCA_SASLHostPort *remote)=0;
161
virtual void setSecurityProps(bool noPlain, bool noActive, bool noDict, bool noAnon, bool reqForward, bool reqCreds, bool reqMutual, int ssfMin, int ssfMax, const QString &_ext_authid, int _ext_ssf)=0;
162
virtual int security() const=0;
163
virtual int errorCond() const=0;
166
virtual bool clientStart(const QStringList &mechlist)=0;
167
virtual int clientFirstStep(bool allowClientSendFirst)=0;
168
virtual bool serverStart(const QString &realm, QStringList *mechlist, const QString &name)=0;
169
virtual int serverFirstStep(const QString &mech, const QByteArray *in)=0;
172
virtual QCA_SASLNeedParams clientParamsNeeded() const=0;
173
virtual void setClientParams(const QString *user, const QString *authzid, const QString *pass, const QString *realm)=0;
174
virtual QString username() const=0;
175
virtual QString authzid() const=0;
178
virtual int nextStep(const QByteArray &in)=0;
179
virtual int tryAgain()=0;
182
virtual QString mech() const=0;
183
virtual const QByteArray *clientInit() const=0;
184
virtual QByteArray result() const=0;
187
virtual bool encode(const QByteArray &in, QByteArray *out)=0;
188
virtual bool decode(const QByteArray &in, QByteArray *out)=0;