Enum IdentityKeyPair 

pub enum IdentityKeyPair {
    Ed25519 {
        private_key_encoded: [u8; 32],
        private_key: SigningKey,
        public_key: VerifyingKey,
    },
    MlDsa65 {
        private_key_encoded: [u8; 32],
        private_key: Box<SigningKey<MlDsa65>>,
        public_key: Box<VerifyingKey<MlDsa65>>,
    },
}

A cryptographic identity key-pair for signing challenges.

Variants

Ed25519

Fields

private_key_encoded: [u8; 32]

private_key: SigningKey

public_key: VerifyingKey

MlDsa65

ML-DSA-65 keys are boxed because their in-memory representation is ~108KB, which causes stack overflows on Windows when stored inline in the enum.

Fields

private_key_encoded: [u8; 32]

private_key: Box<SigningKey<MlDsa65>>

public_key: Box<VerifyingKey<MlDsa65>>

Implementations

impl IdentityKeyPair

pub fn generate() -> IdentityKeyPair

Generate a new identity key-pair using the default algorithm.

pub fn to_cose(&self) -> Vec<u8>

Serialize this key pair to COSE key format.

pub fn from_cose(cose_bytes: &[u8]) -> Result<IdentityKeyPair, ProxyError>

Deserialize a key pair from COSE key format.

pub fn identity(&self) -> Identity

Get the public identity corresponding to this key pair.

The public Identity contains only the public key and can be shared freely. It is used to verify signatures and identify clients to the proxy.

Examples

use ap_proxy_protocol::IdentityKeyPair;

let keypair = IdentityKeyPair::generate();
let public_identity = keypair.identity();

// Share the public identity with others
println!("My fingerprint: {:?}", public_identity.fingerprint());

Trait Implementations

impl Clone for IdentityKeyPair

fn clone(&self) -> IdentityKeyPair

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl From<&IdentityKeyPair> for Identity

fn from(keypair: &IdentityKeyPair) -> Identity

Converts to this type from the input type.