[][src]Crate itsdangerous

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.

Signers

  • Signer, a signer that signs/unsigns arbitrary values.
  • TimestampSigner, a signer that signs/unsigns arbitrary values attaching a signed timestamp so you know when the value was signed.

Basic Example

use std::time::Duration;
use itsdangerous::{default_builder, Signer};

// 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!");

Modules

algorithm
key_derivation

Structs

InvalidSeperator

Error that occurs when trying to construct a Seperator with a char is in the base64 url-safe alphabet.

Seperator

A seperator character that can be used in crate::SignerBuilder::with_seperator.

SignerBuilder
TimestampExpired
UnsignedValue

Represents a value + timestamp that has been successfully unsigned by TimestampSigner::unsign.

Enums

BadSignature

Errors that can occur while unsigning a "signed value".

BadTimedSignature

Errors that can occur while unsigning a "signed value" using the timed signer.

PayloadError

Traits

AsSigner
IntoTimestampSigner
Signer

A signer can sign and unsign bytes, validating the signature provided.

TimestampSigner

A TimestampSigner wraps an inner Signer, giving it the ability to dish out signatures with timestamps.

Functions

default_builder

Constructs a default signer builder, using the [sha1] digest, hmac, and the django concat key derivation.