Struct RsaSpec 

pub struct RsaSpec {
    pub bits: usize,
    pub exponent: u32,
}

Specification for RSA key generation.

This struct defines the parameters for generating RSA keypairs.

Examples

use uselesskey_rsa::RsaSpec;

// Common preset for JWT RS256 signing
let spec = RsaSpec::rs256();
assert_eq!(spec.bits, 2048);
assert_eq!(spec.exponent, 65537);

// Custom bit size (exponent defaults to 65537)
let spec = RsaSpec::new(4096);
assert_eq!(spec.bits, 4096);

Fields

bits: usize

RSA modulus size in bits. Must be at least 1024.

exponent: u32

Public exponent. Currently only 65537 is supported.

Implementations

impl RsaSpec

pub fn rs256() -> Self

Spec suitable for RS256 JWT signing in most ecosystems.

Returns a spec with 2048 bits and exponent 65537.

Examples

use uselesskey_rsa::RsaSpec;

let spec = RsaSpec::rs256();
assert_eq!(spec.bits, 2048);
assert_eq!(spec.exponent, 65537);

pub fn new(bits: usize) -> Self

Create a spec with custom bit size and default exponent (65537).

Panics

The factory will panic if bits < 1024.

Examples

use uselesskey_rsa::RsaSpec;

let spec = RsaSpec::new(4096);
assert_eq!(spec.bits, 4096);
assert_eq!(spec.exponent, 65537);

pub fn stable_bytes(&self) -> [u8; 8]

Stable encoding for cache keys / deterministic derivation.

If you change this, bump the derivation version in uselesskey-core.

Examples

use uselesskey_rsa::RsaSpec;

let spec = RsaSpec::rs256();
let bytes = spec.stable_bytes();
assert_eq!(bytes.len(), 8);

Trait Implementations

impl Clone for RsaSpec

fn clone(&self) -> RsaSpec

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RsaSpec

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

Formats the value using the given formatter.

impl Hash for RsaSpec

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for RsaSpec

fn eq(&self, other: &RsaSpec) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Copy for RsaSpec

impl Eq for RsaSpec

impl StructuralPartialEq for RsaSpec