Struct Challenge 

pub struct Challenge(/* private fields */);

A cryptographic challenge issued by the proxy server for authentication.

The server sends a random challenge to newly connected clients. Clients must sign this challenge with their private key to prove their identity without revealing the private key itself.

Protocol Flow

1. Client connects via WebSocket
2. Server generates and sends Challenge
3. Client signs challenge using IdentityKeyPair
4. Client sends ChallengeResponse with signature
5. Server verifies signature to authenticate client

Examples

Server-side challenge generation:

use ap_proxy_protocol::Challenge;

let challenge = Challenge::new();
// Send to client for signing

Client-side challenge signing:

use ap_proxy_protocol::{Challenge, IdentityKeyPair};

let keypair = IdentityKeyPair::generate();
let response = challenge.sign(&keypair);
// Send response back to server

Implementations

impl Challenge

pub fn new() -> Challenge

Generate a new random challenge using cryptographically secure randomness.

Each challenge is 32 bytes of random data, providing sufficient entropy to prevent replay attacks and ensure uniqueness.

Examples

use ap_proxy_protocol::Challenge;

let challenge = Challenge::new();
// Each call produces a different random challenge
assert_ne!(format!("{:?}", challenge), format!("{:?}", Challenge::new()));

pub fn sign(&self, identity: &IdentityKeyPair) -> ChallengeResponse

Sign this challenge using the provided identity key-pair.

Examples

use ap_proxy_protocol::{Challenge, IdentityKeyPair};

let keypair = IdentityKeyPair::generate();
let challenge = Challenge::new();
let response = challenge.sign(&keypair);

// Verify the signature
let identity = keypair.identity();
assert!(response.verify(&challenge, &identity));

Trait Implementations

impl Clone for Challenge

fn clone(&self) -> Challenge

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Challenge

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

Formats the value using the given formatter.

impl Default for Challenge

fn default() -> Challenge

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for Challenge

fn deserialize<__D>( __deserializer: __D, ) -> Result<Challenge, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for Challenge

fn serialize<__S>( &self, __serializer: __S, ) -> Result<<__S as Serializer>::Ok, <__S as Serializer>::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.