uselesskey 0.5.1

Deterministic cryptographic key and certificate fixtures for Rust tests. Seed-stable, cached, scanner-safe.
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
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103

//! Adapter example: uselesskey + rustls for TLS setup.
//!
//! Demonstrates converting uselesskey X.509 fixtures into rustls types
//! for building TLS server and client configurations.
//!
//! Run with: cargo run -p uselesskey --example adapter_rustls --features x509

#[cfg(feature = "x509")]
fn main() {
    use uselesskey::{ChainSpec, Factory, Seed, X509FactoryExt, X509Spec};
    use uselesskey_rustls::{
        RustlsCertExt, RustlsChainExt, RustlsClientConfigExt, RustlsPrivateKeyExt,
        RustlsServerConfigExt,
    };

    let fx = Factory::deterministic(Seed::from_env_value("rustls-demo").unwrap());

    // =========================================================================
    // 1. Self-signed certificate → rustls types
    // =========================================================================
    println!("=== Self-Signed → rustls Types ===\n");

    let cert = fx.x509_self_signed("localhost", X509Spec::self_signed("localhost"));

    // Convert to rustls-pki-types.
    let cert_der = cert.certificate_der_rustls();
    let key_der = cert.private_key_der_rustls();

    println!("  CertificateDer : {} bytes", cert_der.as_ref().len());
    println!("  PrivateKeyDer  : {} bytes", key_der.secret_der().len());

    // =========================================================================
    // 2. Certificate chain → rustls types
    // =========================================================================
    println!("\n=== Chain → rustls Types ===\n");

    let chain = fx.x509_chain(
        "api-service",
        ChainSpec::new("api.example.com")
            .with_sans(vec!["localhost".to_string(), "127.0.0.1".to_string()]),
    );

    // chain_der_rustls() returns leaf + intermediate (what a TLS server presents).
    let chain_certs = chain.chain_der_rustls();
    println!(
        "  Chain certs (leaf + intermediate) : {} certs",
        chain_certs.len()
    );
    for (i, c) in chain_certs.iter().enumerate() {
        println!("    cert[{i}] : {} bytes", c.as_ref().len());
    }

    // root_certificate_der_rustls() returns the root CA for the trust store.
    let root = chain.root_certificate_der_rustls();
    println!("  Root CA cert : {} bytes", root.as_ref().len());

    // Private key for the leaf certificate.
    let chain_key = chain.private_key_der_rustls();
    println!(
        "  Leaf private key : {} bytes",
        chain_key.secret_der().len()
    );

    // =========================================================================
    // 3. Build a rustls ServerConfig (one-liner)
    // =========================================================================
    println!("\n=== rustls ServerConfig ===\n");

    let server_config = chain.server_config_rustls();
    println!("  ServerConfig created : ✓");
    println!(
        "  ALPN protocols       : {:?}",
        server_config.alpn_protocols
    );

    // Also works with self-signed certs.
    let self_signed_config = cert.server_config_rustls();
    println!("  Self-signed config   : ✓");
    println!(
        "  ALPN protocols       : {:?}",
        self_signed_config.alpn_protocols
    );

    // =========================================================================
    // 4. Build a rustls ClientConfig (trusts the chain's root CA)
    // =========================================================================
    println!("\n=== rustls ClientConfig ===\n");

    let client_config = chain.client_config_rustls();
    println!("  ClientConfig created : ✓");
    println!(
        "  ALPN protocols       : {:?}",
        client_config.alpn_protocols
    );

    println!("\n=== All rustls adapter examples passed ===");
}

#[cfg(not(feature = "x509"))]
fn main() {
    eprintln!("Enable 'x509' feature:");
    eprintln!("  cargo run -p uselesskey --example adapter_rustls --features x509");
}