Cryptolens Rust Client
## Contents
- [Contents](#contents)
- [About](#about)
- [Installation](#installation)
- [Usage](#usage)
- [Example](#example)
- [Basic usage example](#basic-usage-example)
- [Offline validation example:](#offline-validation-example)
- [Contributions](#contributions)
- [License](#license)
## About
This crate provides helper functions for managing and verifying license keys using Cryptolens. It simplifies the process of key activations, validations, and also offers utilities for handling RSA keys for digital signatures.
**Why I make this crate?**
In the official Cryptolens GitHub repository, there is an existing cryptolens-rust crate, but its last update was 5 years ago (2019), and it appears that some of its functionality may no longer be working correctly. Since there were no up-to-date alternatives available for using Cryptolens with Rust, I created this crate to provide a maintained and functioning solution for the Rust community.
**04/23/2024 Updated 0.2.0 add offline validation function and example**
## Installation
Add this to your `Cargo.toml`:
```toml
[dependencies]
cryptolens_yc = "0.2.0"
```
## Usage
To start using the `cryptolens_yc` crate, you need to include it in your Rust project and use the provided functions to activate and validate license keys.
### Example
#### Basic usage example
Here is a basic example demonstrating how to activate a license key and verify its signature:
```rust
use cryptolens_yc::{key_activate, KeyActivateArguments};
let public_key = "...AQAB";
let product_id = "3646";
let key = "MPDWY-PQAOW-FKSCH-SGAAU";
let token = "WyI0NjUiLCJBWTBGTlQwZm9WV0FyVnZzMEV1Mm9LOHJmRDZ1SjF0Vk52WTU0VzB2Il0=";
let license_key = key_activate(
token,
KeyActivateArguments {
ProductId: product_id.parse().unwrap(),
Key: key.to_string(),
MachineCode: "289jf2afs3".to_string(),
..Default::default()
},
).unwrap();
match license_key.has_valid_signature(public_key) {
Ok(valid) => assert_eq!(valid, true),
Err(e) => panic!("Error: {}", e),
}
```
This example shows how to activate a license and check if the returned license has a valid signature with the given public RSA key.
#### Offline validation example:
```rust
// get the license key from above code ...
// save the license key to a file
let path = "cached_license_key";
save_license_key_to_file(&license_key, path)?;
// you can also load the license key from a file
let loaded_license_key = cryptolens_yc::load_license_key_from_file(path)?;
// validate the loaded license key
match loaded_license_key.has_valid_signature(public_key) {
Ok(valid) => assert_eq!(valid, true),
Err(e) => panic!("Error: {}", e),
}
```
## Contributions
Contributions are welcome! Please fork the repository and open a pull request with your changes.
## License
This project is under license from MIT. For more details, see the [LICENSE](LICENSE) file.
Back to top