Struct wow_srp::client::SrpClientChallenge

pub struct SrpClientChallenge { /* private fields */ }

Available on crate features srp-default-math or srp-fast-math only.

First step of the client connection. Next is SrpClient.

The client proof and public key must be sent to the server in the CMD_AUTH_LOGON_PROOF_Client packet before the server proof is available.

All arrays are little endian.

The CRC check also present in the same network packet is out of scope for this crate.

Implementations

impl SrpClientChallenge

pub fn new( username: NormalizedString, password: NormalizedString, generator: u8, large_safe_prime: [u8; 32], server_public_key: PublicKey, salt: [u8; 32] ) -> SrpClientChallenge

Takes the server supplied variables and computes the next step.

The generator and large safe prime are not checked for validity.

All arrays are little endian.

Panics

Panics on the extremely unlikely chance that the generated public key is invalid. See PublicKey for details on validity.

There are only two invalid states for the randomly generated server public key:

• All zeros.
• Exactly the same as the large safe prime.

This is 2 out of 2^256 possible states. The chances of this occurring naturally are very slim. It is significantly more likely that the RNG of the system has been compromised in which case authentication is not possible.

pub const fn client_proof(&self) -> &[u8; 20]

Called M in RFC2945, called M1 in other literature. M2 is the argument passed to SrpClientChallenge::verify_server_proof.

pub const fn client_public_key(&self) -> &[u8; 32]

Called A in RFC2945. Also sometimes referred to as a, although this is the abbreviation of the private key. If the lowercase version appears in a packet table it is referring to the public key.

pub fn verify_server_proof( self, server_proof: [u8; 20] ) -> Result<SrpClient, MatchProofsError>

Verifies that the server knows the same password as was initially used in SrpClientChallenge::new.

Errors

This should very rarely return an error unless something weird is going on with the server, ther server deliberately sends an incorrect value, or the packet has been read incorrectly.

Trait Implementations

impl Clone for SrpClientChallenge

fn clone(&self) -> SrpClientChallenge

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for SrpClientChallenge

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

Formats the value using the given formatter.

impl Hash for SrpClientChallenge

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 Ord for SrpClientChallenge

fn cmp(&self, other: &SrpClientChallenge) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized + PartialOrd,

Restrict a value to a certain interval.

impl PartialEq for SrpClientChallenge

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

This method tests for self and other values to be equal, and is used by ==.

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

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

impl PartialOrd for SrpClientChallenge

fn partial_cmp(&self, other: &SrpClientChallenge) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

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

This method tests less than (for self and other) and is used by the < operator.

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

This method tests less than or equal to (for self and other) and is used by the <= operator.

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

This method tests greater than (for self and other) and is used by the > operator.

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

This method tests greater than or equal to (for self and other) and is used by the >= operator.

impl Eq for SrpClientChallenge

impl StructuralPartialEq for SrpClientChallenge