Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/quasarapp/easyssl
This is Qt wrapper of the ssl library.
https://github.com/quasarapp/easyssl
cripto qt ssl wrapper
Last synced: about 1 month ago
JSON representation
This is Qt wrapper of the ssl library.
- Host: GitHub
- URL: https://github.com/quasarapp/easyssl
- Owner: QuasarApp
- License: gpl-3.0
- Created: 2023-03-26T16:36:32.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2023-12-31T09:09:53.000Z (12 months ago)
- Last Synced: 2024-03-18T13:21:37.779Z (9 months ago)
- Topics: cripto, qt, ssl, wrapper
- Language: C++
- Homepage: https://quasarapp.ddns.net:3031/docs/QuasarApp/easyssl/latest/index.html
- Size: 172 KB
- Stars: 2
- Watchers: 3
- Forks: 2
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
# EasySSL
This is wrapper library that make using OpenSSL library more simple.
This library contains interfaces for the signing and encryption data.
### Supported encryption algorithms:
* ECDSA
* RSA
### Supported features
* encryption
* signing
* keys creating
* asyn auth bse on the asyn encryptions methods
## Build and Include
### CMake
* cd yourRepo
* git submodule add https://github.com/QuasarApp/easyssl.git # add the repository of EasySSL into your repo like submodule
* git submodule update --init --recursive
* Include in your CMakeLists.txt file the main CMakeLists.txt file of EasySSL library
```cmake
add_subdirectory(easyssl)
```
* link the EasySSL library to your target
```cmake
target_link_libraries(yourLib PUBLIC easyssl)
```
* rebuild yuor project
### Independet of SSL build
Dependency on the ssl library greatly complicates the deployment of the final product. For fix this issue, you can build EasySSL library with static SSL library. In this case, SSL library code will be saved in your EasySell binary, and deploy of your application will be easily. The ssl code will not available for your application or other libraries, so you will not get conflicts between different major versions ssl libraries if your distribution kit has it.
Just set the **EASYSSL_STATIC_SSL** option to true.
``` bash
cmake .. -DEASYSSL_STATIC_SSL=1
```
The described case may be useful for the Qt 5.15.x, because the QNetwork 5.15 depends on the SSL v1.1 and EasySsl works with the SSL >= 3.0.
## Usage
### Encryption
```cpp
#include "easyssl/rsassl.h"
// create a publick and private keys array.
int main() {
QByteArray pub, priv;
EasySSL::RSASSL crypto;
crypto.makeKeys(pub, priv)
auto siganture = crypto.signMessage(message, priv);
crypto.checkSign(message, siganture, pub);
auto encryptedMsg = crypto.encrypt(message, pub);
auto decryptedMsg = crypto.decrypt(encryptedMsg, priv);
}
```
### Authentication
```cpp
#include
class ECDSA: public EasySSL::AuthECDSA {
public:
// AsyncKeysAuth interface
void setPrivateKey(const QByteArray &newPriv) {
_priv = newPriv;
}
QByteArray getPrivateKey() const {
return _priv;
};
private:
QByteArray _priv;
};
ECDSA edsa;
QByteArray pub, priv;
QString userID;
// make public and private keys.
edsa.makeKeys(pub, priv);
edsa.setPrivateKey(priv);
edsa.setPublicKey(pub);
// prepare an authentication object.
edsa.prepare();
edsa.setPrivateKey({});
edsa.auth(1000, &userID)
```
## Do not forget to help us make this library better...
See our main documentation about contributing to [EasySsl](https://github.com/QuasarApp/easyssl/blob/main/CONTRIBUTING.md)
Full documentation available [here](https://quasarapp.ddns.net:3031/docs/QuasarApp/easyssl/latest/index.html)