Client side handler for using X25519 with a password-authenticated key exchange. More...

#include <network_crypto_internal.h>

Inheritance diagram for X25519PAKEClientHandler:

Public Member Functions
	X25519PAKEClientHandler (const X25519SecretKey &secret_key, std::shared_ptr< NetworkAuthenticationPasswordRequestHandler > handler)
	Create the handler with the given password handler. More...

virtual RequestResult	ReceiveRequest (struct Packet &p) override
	Read a request from the server. More...

virtual bool	SendResponse (struct Packet &p) override
	Create the response to send to the server. More...

virtual std::string_view	GetName () const override
	Get the name of the handler for debug messages. More...

virtual NetworkAuthenticationMethod	GetAuthenticationMethod () const override
	Get the method this handler is providing functionality for. More...

virtual bool	ReceiveEnableEncryption (struct Packet &p) override
	Read the request to enable encryption from the server. More...

virtual std::unique_ptr< NetworkEncryptionHandler >	CreateClientToServerEncryptionHandler () const override
	Create a NetworkEncryptionHandler to encrypt or decrypt messages from the client to the server. More...

virtual std::unique_ptr< NetworkEncryptionHandler >	CreateServerToClientEncryptionHandler () const override
	Create a NetworkEncryptionHandler to encrypt or decrypt messages from the server to the client. More...

Private Attributes
std::shared_ptr< NetworkAuthenticationPasswordRequestHandler >	handler

Additional Inherited Members
Public Types inherited from NetworkAuthenticationClientHandler
enum	RequestResult { AWAIT_USER_INPUT, READY_FOR_RESPONSE, INVALID }
	The processing result of receiving a request. More...

Static Public Member Functions inherited from NetworkAuthenticationClientHandler
static void	EnsureValidSecretKeyAndUpdatePublicKey (std::string &secret_key, std::string &public_key)
	Ensures that the given secret key is valid, and when not overwrite it with a valid secret key. More...

static std::unique_ptr< NetworkAuthenticationClientHandler >	Create (std::shared_ptr< NetworkAuthenticationPasswordRequestHandler > password_handler, std::string &secret_key, std::string &public_key)
	Create a NetworkAuthenticationClientHandler. More...

Protected Types inherited from NetworkAuthenticationClientHandler
enum	RequestResult { AWAIT_USER_INPUT, READY_FOR_RESPONSE, INVALID }
	The processing result of receiving a request. More...

Protected Member Functions inherited from X25519AuthenticationHandler
	X25519AuthenticationHandler (const X25519SecretKey &secret_key)
	Create the handler, and generate the public keys accordingly. More...

void	SendRequest (struct Packet &p)

bool	ReceiveRequest (struct Packet &p)
	Read the key exchange data from a `Packet` that came from the server,. More...

bool	SendResponse (struct Packet &p, std::string_view derived_key_extra_payload)
	Perform the key exchange, and when that is correct fill the `Packet` with the appropriate data. More...

NetworkAuthenticationServerHandler::ResponseResult	ReceiveResponse (struct Packet &p, std::string_view derived_key_extra_payload)
	Read the key exchange data from a `Packet` that came from the client, and check whether the client passes the key exchange successfully. More...

std::string	GetPeerPublicKey () const
	Get the public key the peer provided for the key exchange. More...

void	SendEnableEncryption (struct Packet &p) const
	Send the initial nonce for the encrypted connection. More...

bool	ReceiveEnableEncryption (struct Packet &p)
	Receive the initial nonce for the encrypted connection. More...

std::unique_ptr< NetworkEncryptionHandler >	CreateClientToServerEncryptionHandler () const

std::unique_ptr< NetworkEncryptionHandler >	CreateServerToClientEncryptionHandler () const

Static Protected Member Functions inherited from NetworkAuthenticationClientHandler
static void	EnsureValidSecretKeyAndUpdatePublicKey (std::string &secret_key, std::string &public_key)
	Ensures that the given secret key is valid, and when not overwrite it with a valid secret key. More...

static std::unique_ptr< NetworkAuthenticationClientHandler >	Create (std::shared_ptr< NetworkAuthenticationPasswordRequestHandler > password_handler, std::string &secret_key, std::string &public_key)
	Create a NetworkAuthenticationClientHandler. More...

Detailed Description

Client side handler for using X25519 with a password-authenticated key exchange.

This follows the method described in X25519AuthenticationHandler, were the password is the extra payload.

Definition at line 185 of file network_crypto_internal.h.

Constructor & Destructor Documentation

◆ X25519PAKEClientHandler()

X25519PAKEClientHandler::X25519PAKEClientHandler	(	const X25519SecretKey &	secret_key,
		std::shared_ptr< NetworkAuthenticationPasswordRequestHandler >	handler
	)