Qt Cryptographic Architecture
qca_publickey.h
Go to the documentation of this file.
1 /*
2  * qca_publickey.h - Qt Cryptographic Architecture
3  * Copyright (C) 2003-2007 Justin Karneges <justin@affinix.com>
4  * Copyright (C) 2004,2005 Brad Hards <bradh@frogmouth.net>
5  *
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.
10  *
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.
15  *
16  * You should have received a copy of the GNU Lesser General Public
17  * License along with this library; if not, write to the Free Software
18  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
19  * 02110-1301 USA
20  *
21  */
22 
33 #ifndef QCA_PUBLICKEY_H
34 #define QCA_PUBLICKEY_H
35 
36 #include <QObject>
37 #include "qca_core.h"
38 
39 namespace QCA {
40 
41 class PublicKey;
42 class PrivateKey;
43 class KeyGenerator;
44 class RSAPublicKey;
45 class RSAPrivateKey;
46 class DSAPublicKey;
47 class DSAPrivateKey;
48 class DHPublicKey;
49 class DHPrivateKey;
50 
55 {
60 };
61 
74 {
86 };
87 
92 {
96 };
97 
102 {
109 };
110 
118 {
122  ErrorFile
123 };
124 
134 {
145  IETF_8192
146 
147 };
148 
161 QCA_EXPORT QByteArray emsa3Encode(const QString &hashName, const QByteArray &digest, int size = -1);
162 
170 class QCA_EXPORT DLGroup
171 {
172 public:
173  DLGroup();
174 
182  DLGroup(const BigInteger &p, const BigInteger &q, const BigInteger &g);
183 
190  DLGroup(const BigInteger &p, const BigInteger &g);
191 
197  DLGroup(const DLGroup &from);
198  ~DLGroup();
199 
205  DLGroup & operator=(const DLGroup &from);
206 
213  static QList<DLGroupSet> supportedGroupSets(const QString &provider = QString());
214 
218  bool isNull() const;
219 
223  BigInteger p() const;
224 
228  BigInteger q() const;
229 
233  BigInteger g() const;
234 
235 private:
236  class Private;
237  Private *d;
238 };
239 
249 class QCA_EXPORT PKey : public Algorithm
250 {
251 public:
255  enum Type {
256  RSA,
257  DSA,
258  DH
259  };
260 
264  PKey();
265 
271  PKey(const PKey &from);
272 
273  ~PKey() override;
274 
280  PKey & operator=(const PKey &from);
281 
313  static QList<Type> supportedTypes(const QString &provider = QString());
314 
344  static QList<Type> supportedIOTypes(const QString &provider = QString());
345 
351  bool isNull() const;
352 
358  Type type() const;
359 
363  int bitSize() const;
364 
368  bool isRSA() const;
369 
373  bool isDSA() const;
374 
378  bool isDH() const;
379 
383  bool isPublic() const;
384 
388  bool isPrivate() const;
389 
394  bool canExport() const;
395 
399  bool canKeyAgree() const;
400 
408 
413 
419  bool operator==(const PKey &a) const;
420 
426  bool operator!=(const PKey &a) const;
427 
428 protected:
435  PKey(const QString &type, const QString &provider);
436 
442  void set(const PKey &k);
443 
454 
465 
476 
487 
498 
509 
510 private:
511  void assignToPublic(PKey *dest) const;
512  void assignToPrivate(PKey *dest) const;
513 
514  class Private;
515  Private *d;
516 };
517 
526 class QCA_EXPORT PublicKey : public PKey
527 {
528 public:
533 
540 
548  PublicKey(const QString &fileName);
549 
555  PublicKey(const PublicKey &from);
556 
557  ~PublicKey() override;
558 
564  PublicKey & operator=(const PublicKey &from);
565 
573 
581 
588  DHPublicKey toDH() const;
589 
595  bool canEncrypt() const;
596 
602  bool canDecrypt() const;
603 
609  bool canVerify() const;
610 
618 
626 
638 
646 
652  void update(const MemoryRegion &a);
653 
679  bool validSignature(const QByteArray &sig);
680 
694  bool verifyMessage(const MemoryRegion &a, const QByteArray &sig, SignatureAlgorithm alg, SignatureFormat format = DefaultFormat);
695 
699  QByteArray toDER() const;
700 
709  QString toPEM() const;
710 
722  bool toPEMFile(const QString &fileName) const;
723 
746  static PublicKey fromDER(const QByteArray &a, ConvertResult *result = nullptr, const QString &provider = QString());
747 
773  static PublicKey fromPEM(const QString &s, ConvertResult *result = nullptr, const QString &provider = QString());
774 
802  static PublicKey fromPEMFile(const QString &fileName, ConvertResult *result = nullptr, const QString &provider = QString());
803 
804 protected:
811  PublicKey(const QString &type, const QString &provider);
812 
813 private:
814  class Private;
815  Private *d;
816 };
817 
826 class QCA_EXPORT PrivateKey : public PKey
827 {
828 public:
833 
845  explicit PrivateKey(const QString &fileName, const SecureArray &passphrase = SecureArray());
846 
852  PrivateKey(const PrivateKey &from);
853 
854  ~PrivateKey() override;
855 
862 
867 
872 
877 
883  bool canDecrypt() const;
884 
890  bool canEncrypt() const;
891 
897  bool canSign() const;
898 
906 
918 
926 
937 
946  void update(const MemoryRegion &a);
947 
954  QByteArray signature();
955 
969 
976 
984  static QList<PBEAlgorithm> supportedPBEAlgorithms(const QString &provider = QString());
985 
996  SecureArray toDER(const SecureArray &passphrase = SecureArray(), PBEAlgorithm pbe = PBEDefault) const;
997 
1010  QString toPEM(const SecureArray &passphrase = SecureArray(), PBEAlgorithm pbe = PBEDefault) const;
1011 
1028  bool toPEMFile(const QString &fileName, const SecureArray &passphrase = SecureArray(), PBEAlgorithm pbe = PBEDefault) const;
1029 
1048  static PrivateKey fromDER(const SecureArray &a, const SecureArray &passphrase = SecureArray(), ConvertResult *result = nullptr, const QString &provider = QString());
1049 
1068  static PrivateKey fromPEM(const QString &s, const SecureArray &passphrase = SecureArray(), ConvertResult *result = nullptr, const QString &provider = QString());
1069 
1092  static PrivateKey fromPEMFile(const QString &fileName, const SecureArray &passphrase = SecureArray(), ConvertResult *result = nullptr, const QString &provider = QString());
1093 
1094 protected:
1102  PrivateKey(const QString &type, const QString &provider);
1103 
1104 private:
1105  class Private;
1106  Private *d;
1107 };
1108 
1120 class QCA_EXPORT KeyGenerator : public QObject
1121 {
1122  Q_OBJECT
1123 public:
1129  KeyGenerator(QObject *parent = nullptr);
1130 
1131  ~KeyGenerator() override;
1132 
1141  bool blockingEnabled() const;
1142 
1151  void setBlockingEnabled(bool b);
1152 
1158  bool isBusy() const;
1159 
1176  PrivateKey createRSA(int bits, int exp = 65537, const QString &provider = QString());
1177 
1193  PrivateKey createDSA(const DLGroup &domain, const QString &provider = QString());
1194 
1209  PrivateKey createDH(const DLGroup &domain, const QString &provider = QString());
1210 
1217  PrivateKey key() const;
1218 
1227  DLGroup createDLGroup(QCA::DLGroupSet set, const QString &provider = QString());
1228 
1232  DLGroup dlGroup() const;
1233 
1234 Q_SIGNALS:
1240  void finished();
1241 
1242 private:
1243  Q_DISABLE_COPY(KeyGenerator)
1244 
1245  class Private;
1246  friend class Private;
1247  Private *d;
1248 };
1249 
1258 class QCA_EXPORT RSAPublicKey : public PublicKey
1259 {
1260 public:
1265 
1274  RSAPublicKey(const BigInteger &n, const BigInteger &e, const QString &provider = QString());
1275 
1282 
1290  BigInteger n() const;
1291 
1298  BigInteger e() const;
1299 };
1300 
1309 class QCA_EXPORT RSAPrivateKey : public PrivateKey
1310 {
1311 public:
1316 
1328  RSAPrivateKey(const BigInteger &n, const BigInteger &e, const BigInteger &p, const BigInteger &q, const BigInteger &d, const QString &provider = QString());
1329 
1337  BigInteger n() const;
1338 
1345  BigInteger e() const;
1346 
1350  BigInteger p() const;
1351 
1356  BigInteger q() const;
1357 
1361  BigInteger d() const;
1362 };
1363 
1372 class QCA_EXPORT DSAPublicKey : public PublicKey
1373 {
1374 public:
1379 
1388  DSAPublicKey(const DLGroup &domain, const BigInteger &y, const QString &provider = QString());
1389 
1396 
1400  DLGroup domain() const;
1401 
1405  BigInteger y() const;
1406 };
1407 
1416 class QCA_EXPORT DSAPrivateKey : public PrivateKey
1417 {
1418 public:
1423 
1433  DSAPrivateKey(const DLGroup &domain, const BigInteger &y, const BigInteger &x, const QString &provider = QString());
1434 
1438  DLGroup domain() const;
1439 
1443  BigInteger y() const;
1444 
1448  BigInteger x() const;
1449 };
1450 
1459 class QCA_EXPORT DHPublicKey : public PublicKey
1460 {
1461 public:
1466 
1475  DHPublicKey(const DLGroup &domain, const BigInteger &y, const QString &provider = QString());
1476 
1483 
1487  DLGroup domain() const;
1488 
1492  BigInteger y() const;
1493 };
1494 
1503 class QCA_EXPORT DHPrivateKey : public PrivateKey
1504 {
1505 public:
1510 
1520  DHPrivateKey(const DLGroup &domain, const BigInteger &y, const BigInteger &x, const QString &provider = QString());
1521 
1525  DLGroup domain() const;
1526 
1530  BigInteger y() const;
1531 
1535  BigInteger x() const;
1536 };
1538 }
1539 
1540 #endif
QCA::PublicKey::verifyMessage
bool verifyMessage(const MemoryRegion &a, const QByteArray &sig, SignatureAlgorithm alg, SignatureFormat format=DefaultFormat)
Single step message verification.
QCA::DLGroup
Definition: qca_publickey.h:171
QCA::RSAPublicKey::RSAPublicKey
RSAPublicKey(const BigInteger &n, const BigInteger &e, const QString &provider=QString())
Generate an RSA public key from specified parameters.
QCA::PublicKey::toPEMFile
bool toPEMFile(const QString &fileName) const
Export the key in Privacy Enhanced Mail (PEM) to a file.
QCA::PKey::RSA
@ RSA
RSA key.
Definition: qca_publickey.h:256
QObject
QCA::KeyGenerator::dlGroup
DLGroup dlGroup() const
The current discrete logarithm group.
QCA::PublicKey::PublicKey
PublicKey()
Create an empty (null) public key.
QCA::PKey::set
void set(const PKey &k)
Set the key.
QCA::ErrorFile
@ ErrorFile
Failure because of incorrect file.
Definition: qca_publickey.h:122
QCA::PKey::toRSAPublicKey
RSAPublicKey toRSAPublicKey() const
Interpret this key as an RSAPublicKey.
QCA::EMSA3_MD5
@ EMSA3_MD5
MD5, with EMSA3 (ie PKCS#1 Version 1.5) encoding (this is the usual RSA algorithm)
Definition: qca_publickey.h:78
QCA::DHPublicKey::domain
DLGroup domain() const
The discrete logarithm group that is being used.
QCA::PKey::PKey
PKey(const PKey &from)
Standard copy constructor.
QCA::DSAPrivateKey::y
BigInteger y() const
the public random value
QCA::DLGroup::p
BigInteger p() const
Provide the p component of the group.
QCA::PrivateKey::fromPEMFile
static PrivateKey fromPEMFile(const QString &fileName, const SecureArray &passphrase=SecureArray(), ConvertResult *result=nullptr, const QString &provider=QString())
Import the key in Privacy Enhanced Mail (PEM) format from a file.
QCA::KeyGenerator::createRSA
PrivateKey createRSA(int bits, int exp=65537, const QString &provider=QString())
Generate an RSA key of the specified length.
QCA::PKey::toDSAPrivateKey
DSAPrivateKey toDSAPrivateKey() const
Interpret this key as a DSAPrivateKey.
QCA::IETF_8192
@ IETF_8192
8192-bit MODP Group ("group 18") from RFC3526 Section 7.
Definition: qca_publickey.h:145
QCA::PrivateKey::toDSA
DSAPrivateKey toDSA() const
Interpret / convert the key to a DSA key.
QCA::EMSA3_Raw
@ EMSA3_Raw
EMSA3 without computing a message digest or a DigestInfo encoding (identical to PKCS#11's CKM_RSA_PKC...
Definition: qca_publickey.h:81
QCA::PublicKey::fromPEM
static PublicKey fromPEM(const QString &s, ConvertResult *result=nullptr, const QString &provider=QString())
QCA::PrivateKey::encrypt
SecureArray encrypt(const SecureArray &a, EncryptionAlgorithm alg)
Encrypt a message using a specified algorithm.
QCA::SignatureFormat
SignatureFormat
Signature formats (DSA only)
Definition: qca_publickey.h:92
QCA::PKey::toPrivateKey
PrivateKey toPrivateKey() const
Interpret this key as a PrivateKey.
QCA::EMSA1_SHA1
@ EMSA1_SHA1
SHA1, with EMSA1 (IEEE1363-2000) encoding (this is the usual DSA algorithm - FIPS186)
Definition: qca_publickey.h:76
QCA::DLGroup::supportedGroupSets
static QList< DLGroupSet > supportedGroupSets(const QString &provider=QString())
Provide a list of the supported group sets.
QCA::DSAPrivateKey::domain
DLGroup domain() const
The discrete logarithm group that is being used.
QCA::PublicKey::fromDER
static PublicKey fromDER(const QByteArray &a, ConvertResult *result=nullptr, const QString &provider=QString())
QCA::PrivateKey
Definition: qca_publickey.h:827
QCA::DLGroup::DLGroup
DLGroup(const DLGroup &from)
Standard copy constructor.
QCA::PrivateKey::toRSA
RSAPrivateKey toRSA() const
Interpret / convert the key to an RSA key.
QCA::PrivateKey::signMessage
QByteArray signMessage(const MemoryRegion &a, SignatureAlgorithm alg, SignatureFormat format=DefaultFormat)
One step signature process.
QCA
QCA - the Qt Cryptographic Architecture.
Definition: qca_basic.h:41
QCA::PKey::bitSize
int bitSize() const
Report the number of bits in the key.
QCA::Algorithm
Definition: qca_core.h:1152
QCA::PKey::isPublic
bool isPublic() const
Test if the key is a public key.
QCA::DLGroup::DLGroup
DLGroup(const BigInteger &p, const BigInteger &q, const BigInteger &g)
Construct a discrete logarithm group from raw parameters.
QCA::PublicKey::canEncrypt
bool canEncrypt() const
Test if this key can be used for encryption.
QCA::IETF_1024
@ IETF_1024
Group 2 from RFC 2412, Section E.2.
Definition: qca_publickey.h:139
QCA::PBES2_DES_SHA1
@ PBES2_DES_SHA1
PKCS#5 v2.0 DES/CBC,SHA1.
Definition: qca_publickey.h:104
QCA::DSA_512
@ DSA_512
512 bit group, for compatibility with JCE
Definition: qca_publickey.h:135
QCA::PrivateKey::canSign
bool canSign() const
Test if this key can be used for signing.
QCA::KeyGenerator::KeyGenerator
KeyGenerator(QObject *parent=nullptr)
Create a new key generator.
QCA::PublicKey::PublicKey
PublicKey(const PrivateKey &k)
Create a public key based on a specified private key.
QCA::SymmetricKey
Definition: qca_core.h:1252
QList
QCA::PrivateKey::maximumEncryptSize
int maximumEncryptSize(EncryptionAlgorithm alg) const
The maximum message size that can be encrypted with a specified algorithm.
QCA::KeyGenerator::blockingEnabled
bool blockingEnabled() const
Test whether the key generator is set to operate in blocking mode, or not.
QCA::DLGroup::operator=
DLGroup & operator=(const DLGroup &from)
Standard assignment operator.
QCA::DSAPublicKey::DSAPublicKey
DSAPublicKey(const DLGroup &domain, const BigInteger &y, const QString &provider=QString())
Create a DSA public key.
QCA::RSAPublicKey
Definition: qca_publickey.h:1259
QCA::DHPublicKey::DHPublicKey
DHPublicKey(const DHPrivateKey &k)
Create a Diffie-Hellman public key from a specified private key.
QCA::PublicKey::toDER
QByteArray toDER() const
Export the key in Distinguished Encoding Rules (DER) format.
QCA::IETF_1536
@ IETF_1536
1536-bit MODP Group ("group 5") from RFC3526 Section 2.
Definition: qca_publickey.h:140
QCA::EMSA3_SHA224
@ EMSA3_SHA224
SHA224, with EMSA3 (ie PKCS#1 Version 1.5) encoding.
Definition: qca_publickey.h:82
QCA::PublicKey::decrypt
bool decrypt(const SecureArray &in, SecureArray *out, EncryptionAlgorithm alg)
Decrypt the message.
QCA::PublicKey::toDH
DHPublicKey toDH() const
Convenience method to convert this key to a DHPublicKey.
QCA::SignatureAlgorithm
SignatureAlgorithm
Signature algorithm variants.
Definition: qca_publickey.h:74
QCA::EME_PKCS1v15_SSL
@ EME_PKCS1v15_SSL
PKCS#1, Version 1.5 with an SSL-specific modification.
Definition: qca_publickey.h:58
QCA::PrivateKey::PrivateKey
PrivateKey(const PrivateKey &from)
Copy constructor.
QCA::PublicKey::maximumEncryptSize
int maximumEncryptSize(EncryptionAlgorithm alg) const
The maximum message size that can be encrypted with a specified algorithm.
QCA::PKey::isNull
bool isNull() const
Test if the key is null (empty)
QCA::PrivateKey::startSign
void startSign(SignatureAlgorithm alg, SignatureFormat format=DefaultFormat)
Initialise the message signature process.
QCA::PrivateKey::PrivateKey
PrivateKey()
Create an empty private key.
QCA::RSAPublicKey::RSAPublicKey
RSAPublicKey()
Generate an empty RSA public key.
QCA::EMSA3_RIPEMD160
@ EMSA3_RIPEMD160
RIPEMD160, with EMSA3 (ie PKCS#1 Version 1.5) encoding.
Definition: qca_publickey.h:80
QCA::PrivateKey::fromDER
static PrivateKey fromDER(const SecureArray &a, const SecureArray &passphrase=SecureArray(), ConvertResult *result=nullptr, const QString &provider=QString())
Import the key from Distinguished Encoding Rules (DER) format.
QCA::PKey::operator!=
bool operator!=(const PKey &a) const
test if two keys are not equal
QCA::PBES2_AES192_SHA1
@ PBES2_AES192_SHA1
PKCS#5 v2.0 AES-192/CBC,SHA1.
Definition: qca_publickey.h:107
QCA::PKey::toDHPublicKey
DHPublicKey toDHPublicKey() const
Interpret this key as an DHPublicKey.
QCA::DLGroup::isNull
bool isNull() const
Test if the group is empty.
QCA::KeyGenerator::key
PrivateKey key() const
Return the last generated key.
QCA::PKey::toDSAPublicKey
DSAPublicKey toDSAPublicKey() const
Interpret this key as an DSAPublicKey.
QCA::KeyGenerator::finished
void finished()
Emitted when the key generation is complete.
QCA::PKey::toRSAPrivateKey
RSAPrivateKey toRSAPrivateKey() const
Interpret this key as an RSAPrivateKey.
QCA::PBES2_TripleDES_SHA1
@ PBES2_TripleDES_SHA1
PKCS#5 v2.0 TripleDES/CBC,SHA1.
Definition: qca_publickey.h:105
QCA::PrivateKey::supportedPBEAlgorithms
static QList< PBEAlgorithm > supportedPBEAlgorithms(const QString &provider=QString())
List the supported Password Based Encryption Algorithms that can be used to protect the key.
QCA::EncryptionAlgorithm
EncryptionAlgorithm
Encryption algorithms.
Definition: qca_publickey.h:55
QCA::DHPrivateKey::DHPrivateKey
DHPrivateKey(const DLGroup &domain, const BigInteger &y, const BigInteger &x, const QString &provider=QString())
Create a Diffie-Hellman private key.
QCA::PBEDefault
@ PBEDefault
Use modern default (same as PBES2_TripleDES_SHA1)
Definition: qca_publickey.h:103
QCA::DSAPublicKey::domain
DLGroup domain() const
The discrete logarithm group that is being used.
QCA::PKey::canExport
bool canExport() const
Test if the key data can be exported.
QCA::PKey::toPublicKey
PublicKey toPublicKey() const
Interpret this key as a PublicKey.
QCA::PKey::toDHPrivateKey
DHPrivateKey toDHPrivateKey() const
Interpret this key as a DHPrivateKey.
QCA::DHPublicKey::y
BigInteger y() const
The public random value associated with this key.
QCA::PrivateKey::decrypt
bool decrypt(const SecureArray &in, SecureArray *out, EncryptionAlgorithm alg)
Decrypt the message.
QCA::PKey::operator=
PKey & operator=(const PKey &from)
Standard assignment operator.
QCA::KeyGenerator::createDH
PrivateKey createDH(const DLGroup &domain, const QString &provider=QString())
Generate a Diffie-Hellman key.
QCA::KeyGenerator::isBusy
bool isBusy() const
Test if the key generator is currently busy, or not.
QCA::PrivateKey::signature
QByteArray signature()
The resulting signature.
QCA::EMSA3_MD2
@ EMSA3_MD2
MD2, with EMSA3 (ie PKCS#1 Version 1.5) encoding.
Definition: qca_publickey.h:79
QCA::PrivateKey::toPEM
QString toPEM(const SecureArray &passphrase=SecureArray(), PBEAlgorithm pbe=PBEDefault) const
Export the key in Privacy Enhanced Mail (PEM) format.
QCA::PrivateKey::toPEMFile
bool toPEMFile(const QString &fileName, const SecureArray &passphrase=SecureArray(), PBEAlgorithm pbe=PBEDefault) const
Export the key in Privacy Enhanced Mail (PEM) format to a file.
QCA::PublicKey::PublicKey
PublicKey(const PublicKey &from)
Copy constructor.
QCA::PrivateKey::canDecrypt
bool canDecrypt() const
Test if this key can be used for decryption.
QCA::KeyGenerator::createDSA
PrivateKey createDSA(const DLGroup &domain, const QString &provider=QString())
Generate a DSA key.
QCA::PublicKey::canVerify
bool canVerify() const
Test if the key can be used for verifying signatures.
QCA::IETF_6144
@ IETF_6144
6144-bit MODP Group ("group 17") from RFC3526 Section 6.
Definition: qca_publickey.h:144
QCA::PublicKey::validSignature
bool validSignature(const QByteArray &sig)
QCA::SecureArray
Definition: qca_tools.h:317
QCA::DefaultFormat
@ DefaultFormat
For DSA, this is the same as IEEE_1363.
Definition: qca_publickey.h:93
QCA::PrivateKey::fromPEM
static PrivateKey fromPEM(const QString &s, const SecureArray &passphrase=SecureArray(), ConvertResult *result=nullptr, const QString &provider=QString())
Import the key from Privacy Enhanced Mail (PEM) format.
QCA::ErrorDecode
@ ErrorDecode
General failure in the decode stage.
Definition: qca_publickey.h:120
QCA::DHPublicKey::DHPublicKey
DHPublicKey(const DLGroup &domain, const BigInteger &y, const QString &provider=QString())
Create a Diffie-Hellman public key.
QCA::KeyGenerator::createDLGroup
DLGroup createDLGroup(QCA::DLGroupSet set, const QString &provider=QString())
Create a new discrete logarithm group.
QCA::KeyGenerator::setBlockingEnabled
void setBlockingEnabled(bool b)
Set whether the key generator is in blocking mode, nor not.
QCA::RSAPrivateKey::d
BigInteger d() const
The inverse of the exponent, module (p-1)(q-1)
QCA::DHPrivateKey::DHPrivateKey
DHPrivateKey()
Create an empty Diffie-Hellman private key.
QCA::PKey::canKeyAgree
bool canKeyAgree() const
Test if the key can be used for key agreement.
QCA::DHPrivateKey::domain
DLGroup domain() const
The discrete logarithm group that is being used.
QCA::BigInteger
Definition: qca_tools.h:571
QCA::IETF_4096
@ IETF_4096
4096-bit MODP Group ("group 16") from RFC3526 Section 5.
Definition: qca_publickey.h:143
QCA::DLGroup::g
BigInteger g() const
Provide the g component of the group.
QCA::PBES2_AES256_SHA1
@ PBES2_AES256_SHA1
PKCS#5 v2.0 AES-256/CBC,SHA1.
Definition: qca_publickey.h:108
QCA::RSAPrivateKey::q
BigInteger q() const
The second of the two random primes used to generate the private key.
QCA::DSAPublicKey
Definition: qca_publickey.h:1373
QCA::PKey::DSA
@ DSA
DSA key.
Definition: qca_publickey.h:257
QCA::PKey::Type
Type
Types of public key cryptography keys supported by QCA.
Definition: qca_publickey.h:255
QCA::DSA_1024
@ DSA_1024
1024 bit group, for compatibility with JCE
Definition: qca_publickey.h:137
QCA::PublicKey::toRSA
RSAPublicKey toRSA() const
Convenience method to convert this key to an RSAPublicKey.
QCA::RSAPrivateKey::p
BigInteger p() const
One of the two random primes used to generate the private key.
QCA::EMSA3_SHA384
@ EMSA3_SHA384
SHA384, with EMSA3 (ie PKCS#1 Version 1.5) encoding.
Definition: qca_publickey.h:84
QCA::RSAPublicKey::RSAPublicKey
RSAPublicKey(const RSAPrivateKey &k)
Extract the public key components from an RSA private key.
QCA::IETF_768
@ IETF_768
Group 1 from RFC 2412, Section E.1.
Definition: qca_publickey.h:138
QCA::EMSA3_SHA256
@ EMSA3_SHA256
SHA256, with EMSA3 (ie PKCS#1 Version 1.5) encoding.
Definition: qca_publickey.h:83
QCA::PublicKey::encrypt
SecureArray encrypt(const SecureArray &a, EncryptionAlgorithm alg)
Encrypt a message using a specified algorithm.
QCA::RSAPrivateKey::RSAPrivateKey
RSAPrivateKey()
Generate an empty RSA private key.
QCA::PrivateKey::PrivateKey
PrivateKey(const QString &type, const QString &provider)
Create a new private key.
QCA::PrivateKey::canEncrypt
bool canEncrypt() const
Test if this key can be used for encryption.
QCA::ConvertResult
ConvertResult
Return value from a format conversion.
Definition: qca_publickey.h:118
QCA::PublicKey::operator=
PublicKey & operator=(const PublicKey &from)
Assignment operator.
QCA::PublicKey::update
void update(const MemoryRegion &a)
Update the signature verification process with more data.
QCA::DSAPublicKey::DSAPublicKey
DSAPublicKey()
Create an empty DSA public key.
QCA::PublicKey::fromPEMFile
static PublicKey fromPEMFile(const QString &fileName, ConvertResult *result=nullptr, const QString &provider=QString())
QCA::RSAPrivateKey::n
BigInteger n() const
The public key value.
QCA::PKey::operator==
bool operator==(const PKey &a) const
test if two keys are equal
QCA::DLGroup::DLGroup
DLGroup(const BigInteger &p, const BigInteger &g)
Construct a discrete logarithm group from raw parameters.
QCA::KeyGenerator
Definition: qca_publickey.h:1121
QCA::PBEAlgorithm
PBEAlgorithm
Password-based encryption.
Definition: qca_publickey.h:102
QCA::PKey::isPrivate
bool isPrivate() const
Test if the key is a private key.
QCA::PublicKey::toDSA
DSAPublicKey toDSA() const
Convenience method to convert this key to a DSAPublicKey.
qca_core.h
QCA::PublicKey::PublicKey
PublicKey(const QString &type, const QString &provider)
Create a new key of a specified type.
QCA::SignatureUnknown
@ SignatureUnknown
Unknown signing algorithm.
Definition: qca_publickey.h:75
QCA::DSAPublicKey::DSAPublicKey
DSAPublicKey(const DSAPrivateKey &k)
Create a DSA public key from a specified private key.
QCA::EME_NO_PADDING
@ EME_NO_PADDING
Raw RSA encryption.
Definition: qca_publickey.h:59
QCA::PublicKey::canDecrypt
bool canDecrypt() const
Test if this key can be used for decryption.
QCA::RSAPrivateKey
Definition: qca_publickey.h:1310
QCA::PKey::isRSA
bool isRSA() const
Test if the key is an RSA key.
QCA::MemoryRegion
Definition: qca_tools.h:91
QCA::EME_PKCS1v15
@ EME_PKCS1v15
Block type 2 (PKCS#1, Version 1.5)
Definition: qca_publickey.h:56
QCA::IETF_3072
@ IETF_3072
3072-bit MODP Group ("group 15") from RFC3526 Section 4.
Definition: qca_publickey.h:142
QCA::EMSA3_SHA512
@ EMSA3_SHA512
SHA512, with EMSA3 (ie PKCS#1 Version 1.5) encoding.
Definition: qca_publickey.h:85
QCA::DSAPrivateKey::DSAPrivateKey
DSAPrivateKey()
Create an empty DSA private key.
QCA::DHPrivateKey::x
BigInteger x() const
The private random value associated with this key.
QCA::IETF_2048
@ IETF_2048
2048-bit MODP Group ("group 14") from RFC3526 Section 3.
Definition: qca_publickey.h:141
QCA::DSAPrivateKey
Definition: qca_publickey.h:1417
QCA::DHPublicKey
Definition: qca_publickey.h:1460
QCA::DHPrivateKey
Definition: qca_publickey.h:1504
QCA::DSAPrivateKey::DSAPrivateKey
DSAPrivateKey(const DLGroup &domain, const BigInteger &y, const BigInteger &x, const QString &provider=QString())
Create a DSA public key.
QCA::DHPublicKey::DHPublicKey
DHPublicKey()
Create an empty Diffie-Hellman public key.
QCA::PKey::supportedTypes
static QList< Type > supportedTypes(const QString &provider=QString())
QCA::DERSequence
@ DERSequence
Signature wrapped in DER formatting (OpenSSL/Java)
Definition: qca_publickey.h:95
QCA::PKey::isDH
bool isDH() const
Test if the key is a Diffie Hellman key.
QCA::PublicKey
Definition: qca_publickey.h:527
QCA::ConvertGood
@ ConvertGood
Conversion succeeded, results should be valid.
Definition: qca_publickey.h:119
QCA::PKey::supportedIOTypes
static QList< Type > supportedIOTypes(const QString &provider=QString())
QCA::PublicKey::startVerify
void startVerify(SignatureAlgorithm alg, SignatureFormat format=DefaultFormat)
Initialise the signature verification process.
QCA::PKey::PKey
PKey()
Standard constructor.
QCA::EMSA3_SHA1
@ EMSA3_SHA1
SHA1, with EMSA3 (ie PKCS#1 Version 1.5) encoding.
Definition: qca_publickey.h:77
QCA::PrivateKey::operator=
PrivateKey & operator=(const PrivateKey &from)
Assignment operator.
QCA::PrivateKey::toDER
SecureArray toDER(const SecureArray &passphrase=SecureArray(), PBEAlgorithm pbe=PBEDefault) const
Export the key in Distinguished Encoding Rules (DER) format.
QCA::PrivateKey::toDH
DHPrivateKey toDH() const
Interpret / convert the key to a Diffie-Hellman key.
QCA::DSA_768
@ DSA_768
768 bit group, for compatibility with JCE
Definition: qca_publickey.h:136
QCA::PKey
Definition: qca_publickey.h:250
QCA::ErrorPassphrase
@ ErrorPassphrase
Failure because of incorrect passphrase.
Definition: qca_publickey.h:121
QCA::PrivateKey::PrivateKey
PrivateKey(const QString &fileName, const SecureArray &passphrase=SecureArray())
Import a private key from a PEM representation in a file.
QCA::DHPrivateKey::y
BigInteger y() const
The public random value associated with this key.
QCA::DSAPublicKey::y
BigInteger y() const
The public random value associated with this key.
QCA::DSAPrivateKey::x
BigInteger x() const
the private random value
QCA::PublicKey::PublicKey
PublicKey(const QString &fileName)
Import a public key from a PEM representation in a file.
QCA::emsa3Encode
QCA_EXPORT QByteArray emsa3Encode(const QString &hashName, const QByteArray &digest, int size=-1)
Encode a hash result in EMSA3 (PKCS#1) format.
QCA::RSAPublicKey::e
BigInteger e() const
The public key exponent.
QCA::PKey::PKey
PKey(const QString &type, const QString &provider)
Create a key of the specified type.
QCA::RSAPrivateKey::RSAPrivateKey
RSAPrivateKey(const BigInteger &n, const BigInteger &e, const BigInteger &p, const BigInteger &q, const BigInteger &d, const QString &provider=QString())
Generate an RSA private key from specified parameters.
QCA::DLGroup::q
BigInteger q() const
Provide the q component of the group.
QCA::IEEE_1363
@ IEEE_1363
40-byte format from IEEE 1363 (Botan/.NET)
Definition: qca_publickey.h:94
QCA::PKey::type
Type type() const
Report the Type of key (eg RSA, DSA or Diffie Hellman)
QCA::PBES2_AES128_SHA1
@ PBES2_AES128_SHA1
PKCS#5 v2.0 AES-128/CBC,SHA1.
Definition: qca_publickey.h:106
QCA::EME_PKCS1_OAEP
@ EME_PKCS1_OAEP
Optimal asymmetric encryption padding (PKCS#1, Version 2.0)
Definition: qca_publickey.h:57
QCA::DLGroupSet
DLGroupSet
Well known discrete logarithm group sets.
Definition: qca_publickey.h:134
QCA::PrivateKey::deriveKey
SymmetricKey deriveKey(const PublicKey &theirs)
Derive a shared secret key from a public key.
QCA::PKey::isDSA
bool isDSA() const
Test if the key is a DSA key.
QCA::RSAPrivateKey::e
BigInteger e() const
The public key exponent.
QCA::PrivateKey::update
void update(const MemoryRegion &a)
Update the signature process.
QCA::RSAPublicKey::n
BigInteger n() const
The public key value.
QCA::PublicKey::toPEM
QString toPEM() const
Export the key in Privacy Enhanced Mail (PEM) format.