discord / itsdangerous-rs

A rust port of itsdangerous!

itsdangerous-rs

A rust re-implementation of the Python library itsdangerous.

Essentially, this crate provides various helpers to pass data to untrusted environments and get it back safe and sound. Data is cryptographically signed to ensure that it has not been tampered with.

Basic Usage

Add this to your Cargo.toml:

[dependencies]
itsdangerous = "0.3"

Next, get to signing some dangerous strings:

use itsdangerous::{default_builder, Signer};

fn main() {
    // Create a signer using the default builder, and an arbitrary secret key.
    let signer = default_builder("secret key").build();

    // Sign an arbitrary string, and send it somewhere dangerous.
    let signed = signer.sign("hello world!");

    // Unsign the string and validate that it hasn't been tampered with.
    let unsigned = signer.unsign(&signed).expect("Signature was not valid");
    assert_eq!(unsigned, "hello world!");
}

For more in-depth examples, check out the documentation!

License

Licensed under the MIT license.