Struct HmacSecret 

pub struct HmacSecret { /* private fields */ }

An HMAC secret fixture.

Created via HmacFactoryExt::hmac(). Provides access to raw secret bytes and JWK output (with the jwk feature).

Examples

use uselesskey_core::Factory;
use uselesskey_hmac::{HmacFactoryExt, HmacSpec};

let fx = Factory::random();
let secret = fx.hmac("jwt-signing", HmacSpec::hs256());

assert_eq!(secret.secret_bytes().len(), 32);

Implementations

impl HmacSecret

pub fn secret_bytes(&self) -> &[u8]

Access raw secret bytes.

Examples

let fx = Factory::deterministic(Seed::from_env_value("test-seed").unwrap());
let secret = fx.hmac("jwt-signing", HmacSpec::hs256());
assert_eq!(secret.secret_bytes().len(), 32);

let secret512 = fx.hmac("jwt-signing", HmacSpec::hs512());
assert_eq!(secret512.secret_bytes().len(), 64);

pub fn kid(&self) -> String

A stable key identifier derived from the secret bytes (base64url blake3 hash prefix).

Examples

let fx = Factory::random();
let secret = fx.hmac("jwt", HmacSpec::hs256());
let kid = secret.kid();
assert!(!kid.is_empty());

pub fn jwk(&self) -> PrivateJwk

HMAC secret as an octet JWK (kty=oct).

Requires the jwk feature.

Examples

let fx = Factory::random();
let secret = fx.hmac("jwt", HmacSpec::hs256());
let jwk = secret.jwk();
let val = jwk.to_value();
assert_eq!(val["kty"], "oct");
assert_eq!(val["alg"], "HS256");

pub fn jwks(&self) -> Jwks

JWKS containing this HMAC secret as an octet key.

Requires the jwk feature.

Examples

let fx = Factory::random();
let secret = fx.hmac("jwt", HmacSpec::hs256());
let jwks = secret.jwks();
let val = jwks.to_value();
assert!(val["keys"].is_array());

Trait Implementations

impl Clone for HmacSecret

fn clone(&self) -> HmacSecret

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for HmacSecret

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.