#hybrid #tink #public-key

tink-hybrid

Hybrid encryption functionality for Rust port of Google's Tink cryptography library

3 releases

0.2.5 Mar 14, 2023
0.2.4 Mar 25, 2022
0.2.3 Jan 3, 2022

#1933 in Cryptography

Download history 19/week @ 2024-03-16 87/week @ 2024-03-23 60/week @ 2024-03-30 84/week @ 2024-04-06 13/week @ 2024-04-13 31/week @ 2024-04-20 28/week @ 2024-04-27 45/week @ 2024-05-04 104/week @ 2024-05-11 60/week @ 2024-05-18 47/week @ 2024-05-25 25/week @ 2024-06-01 63/week @ 2024-06-08 63/week @ 2024-06-15 48/week @ 2024-06-22 81/week @ 2024-06-29

259 downloads per month
Used in rinkey

Apache-2.0

310KB
5K SLoC

Tink-Rust: Hybrid Encryption

Docs MSRV

This crate provides hybrid encryption functionality, as described in the upstream Tink documentation.

Usage

fn main() -> Result<(), Box<dyn Error>> {
    tink_hybrid::init();
    let kh_priv = tink_core::keyset::Handle::new(
        &tink_hybrid::ecies_hkdf_aes128_ctr_hmac_sha256_key_template(),
    )?;

    // NOTE: save the private keyset to a safe location. DO NOT hardcode it in source code.
    // Consider encrypting it with a remote key in Cloud KMS, AWS KMS or HashiCorp Vault.  See
    // https://github.com/google/tink/blob/master/docs/GOLANG-HOWTO.md#storing-and-loading-existing-keysets.

    let kh_pub = kh_priv.public()?;

    // NOTE: share the public keyset with the sender.

    let enc = tink_hybrid::new_encrypt(&kh_pub)?;

    let msg = b"this data needs to be encrypted";
    let encryption_context = b"encryption context";
    let ct = enc.encrypt(msg, encryption_context)?;

    let dec = tink_hybrid::new_decrypt(&kh_priv)?;

    let pt = dec.decrypt(&ct, encryption_context)?;
    assert_eq!(msg[..], pt);

    println!("Ciphertext: {}\n", hex::encode(&ct));
    println!("Original  plaintext: {}\n", String::from_utf8_lossy(msg));
    println!("Decrypted plaintext: {}\n", String::from_utf8_lossy(&pt));
    Ok(())
}

License

Apache License, Version 2.0

Disclaimer

This is not an officially supported Google product.

Dependencies

~4.5–6.5MB
~126K SLoC