Struct sputnik::security::Key

pub struct Key(pub [u8; 32]);

A convenience wrapper around HMAC.

This code was adapted from the cookie crate which does not make the sign and verify functions public forcing the use of CookieJars, which are akward to work with without a high-level framework.

Implementations

impl Key

pub fn try_generate() -> Option<Key>

Attempts to generate signing/encryption keys from a secure, random source. Keys are generated nondeterministically. If randomness cannot be retrieved from the underlying operating system, returns None.

pub fn from(key: &[u8]) -> Key

Creates a new Key from a 32 byte cryptographically random string.

pub fn sign(&self, value: &str) -> String

Signs the value providing integrity and authenticity.

pub fn verify(&self, value: &str) -> Result<String, String>

Extracts the value from a string signed with Key::sign. Fails if the string is malformed or the signature doesn't match.