keygen-rs 0.11.1

Unofficial Rust SDK for integrating with the keygen.sh licensing service.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88

use dotenv::dotenv;
use keygen_rs::{
    config::{self, KeygenConfig},
    errors::Error,
    machine::MachineCheckoutOpts,
};
use std::env;

#[tokio::main]
async fn main() -> Result<(), Error> {
    dotenv().ok();

    config::set_config(KeygenConfig {
        api_url: env::var("KEYGEN_API_URL").expect("KEYGEN_API_URL must be set"),
        account: env::var("KEYGEN_ACCOUNT").expect("KEYGEN_ACCOUNT must be set"),
        product: env::var("KEYGEN_PRODUCT").expect("KEYGEN_PRODUCT must be set"),
        license_key: Some(env::var("KEYGEN_LICENSE_KEY").expect("KEYGEN_LICENSE_KEY must be set")),
        public_key: Some(env::var("KEYGEN_PUBLIC_KEY").expect("KEYGEN_PUBLIC_KEY must be set")),
        ..KeygenConfig::default()
    })?;

    let config = config::get_config().expect("Failed to get config");
    let license_key = config.license_key.clone().expect("License key required");

    let fingerprint = machine_uid::get().unwrap_or("".into());
    let license = match keygen_rs::validate(std::slice::from_ref(&fingerprint), &[]).await {
        Ok(license) => license,
        Err(Error::LicenseNotActivated { license, .. }) => *license,
        Err(e) => return Err(e),
    };

    // Get the machine for checkout
    let machine = license.machine(&fingerprint).await?;

    // Compare online vs offline entitlements access
    let online_entitlements = license.entitlements(None).await?;
    let online_count = online_entitlements.len();
    println!("Online entitlements: {online_count}");

    // Checkout machine file with included relationships
    let options = MachineCheckoutOpts::with_include(vec![
        "license.entitlements".to_string(),
        "components".to_string(),
    ]);
    let machine_file = machine.checkout(&options).await?;

    // Decrypt key for machine files is license_key + fingerprint
    let decryption_key = format!("{license_key}{fingerprint}");

    let offline_entitlements = machine_file.entitlements(&decryption_key)?;
    let offline_count = offline_entitlements.len();
    println!("Offline entitlements: {offline_count}");

    // Pure offline workflow
    let dataset = machine_file.decrypt(&decryption_key)?;

    if let Some(entitlements) = dataset.offline_entitlements() {
        println!("Available entitlements:");
        for ent in entitlements {
            println!(
                "  - {} ({})",
                ent.code,
                ent.name.as_deref().unwrap_or("No name")
            );
        }

        // Feature checking
        let required_features = vec!["premium", "advanced", "api-access"];
        for feature in required_features {
            let has_feature = entitlements.iter().any(|ent| ent.code == feature);
            println!(
                "Feature '{}': {}",
                feature,
                if has_feature { "enabled" } else { "disabled" }
            );
        }
    }

    // Show components if available
    if let Some(components) = dataset.offline_components() {
        println!("Available components:");
        for comp in components {
            println!("  - {} ({})", comp.name, comp.fingerprint);
        }
    }

    Ok(())
}