authenticates a server connection. More...

#include <classic_greeting_forwarder.h>

Inheritance diagram for ServerFirstAuthenticator:

Public Types
enum class	Stage { ClientGreeting , ClientGreetingStartTls , ClientGreetingFull , TlsForwardInit , TlsForward , TlsConnectInit , TlsConnect , ClientGreetingAfterTls , InitialResponse , FinalResponse , AuthOk , AuthError , FetchUserAttrs , FetchUserAttrsDone , Error , Ok }
	stages of the handshake flow. More...

Public Types inherited from BasicProcessor
enum class	Result { Again , RecvFromClient , SendToClient , RecvFromServer , RecvFromBoth , SendToServer , SendableToServer , Suspend , Done , Void }

Public Member Functions
	ServerFirstAuthenticator (MysqlRoutingClassicConnectionBase *conn, std::function< void(const classic_protocol::message::server::Error &)> on_error)

stdx::expected< Result, std::error_code >	process () override

void	stage (Stage stage)

Stage	stage () const

void	failed (const std::optional< classic_protocol::message::server::Error > &err)

std::optional< classic_protocol::message::server::Error >	failed () const

Public Member Functions inherited from Processor
	BasicProcessor (MysqlRoutingClassicConnectionBase *conn)

Public Member Functions inherited from BasicProcessor
	BasicProcessor (MysqlRoutingClassicConnectionBase *conn)

virtual	~BasicProcessor ()=default

const MysqlRoutingClassicConnectionBase *	connection () const

MysqlRoutingClassicConnectionBase *	connection ()

Private Member Functions
stdx::expected< Result, std::error_code >	client_greeting ()

stdx::expected< Result, std::error_code >	client_greeting_start_tls ()

stdx::expected< Result, std::error_code >	client_greeting_full ()

stdx::expected< Result, std::error_code >	tls_forward_init ()

stdx::expected< Result, std::error_code >	tls_forward ()

stdx::expected< Result, std::error_code >	tls_connect_init ()

stdx::expected< Result, std::error_code >	tls_connect ()

stdx::expected< Result, std::error_code >	client_greeting_after_tls ()

stdx::expected< Result, std::error_code >	initial_response ()

stdx::expected< Result, std::error_code >	final_response ()

stdx::expected< Result, std::error_code >	auth_error ()
	router<-server: auth error. More...

stdx::expected< Result, std::error_code >	auth_ok ()
	server-side: auth is ok. More...

stdx::expected< Result, std::error_code >	fetch_user_attrs ()

stdx::expected< Result, std::error_code >	fetch_user_attrs_done ()

void	client_greeting_server_adjust_caps (ClassicProtocolState &rc_protocol, ClassicProtocolState &st_protocol)

Private Attributes
size_t	client_last_recv_buf_size_ {}

size_t	client_last_send_buf_size_ {}

size_t	server_last_recv_buf_size_ {}

size_t	server_last_send_buf_size_ {}

std::optional< classic_protocol::message::server::Error >	failed_

RouterRequireFetcher::Result	required_connection_attributes_fetcher_result_

Stage	stage_ {Stage::ClientGreeting}

std::function< void(const classic_protocol::message::server::Error &err)>	on_error_

Additional Inherited Members
Static Public Attributes inherited from ForwardingProcessor
static constexpr const std::chrono::milliseconds	kConnectRetryInterval
	interval between connect-retries. More...

Protected Member Functions inherited from ForwardingProcessor
stdx::expected< Result, std::error_code >	forward_server_to_client (bool noflush=false)
	forward the current packet from the server-side to the client-side. More...

stdx::expected< Result, std::error_code >	forward_client_to_server (bool noflush=false)
	forward the current packet from the client-side to the server-side. More...

stdx::expected< Processor::Result, std::error_code >	skip_or_inject_end_of_columns (bool no_flush=false)
	adjust the end-of-columns packet. More...

stdx::expected< bool, std::error_code >	pool_server_connection ()
	move the server connection to the pool. More...

stdx::expected< Processor::Result, std::error_code >	socket_reconnect_start (TraceEvent *parent_event)
	reconnect a socket. More...

stdx::expected< Processor::Result, std::error_code >	mysql_reconnect_start (TraceEvent *parent_event)
	reconnect a mysql classic connection. More...

stdx::expected< Result, std::error_code >	recv_server_failed_and_check_client_socket (std::error_code ec)
	handle error-code of a failed receive() from the server-socket and check the status of the client socket. More...

stdx::expected< Processor::Result, std::error_code >	reconnect_send_error_msg (Channel &src_channel, ClassicProtocolState &src_protocol)
	send a Error msg based on the reconnect_error(). More...

template<class Proto >
stdx::expected< Processor::Result, std::error_code >	reconnect_send_error_msg (TlsSwitchableConnection< Proto > &conn)

void	reconnect_error (classic_protocol::message::server::Error err)
	set the reconnect error. More...

classic_protocol::message::server::Error	reconnect_error () const
	get the reconnect error. More...

Protected Member Functions inherited from Processor
stdx::expected< Result, std::error_code >	send_server_failed (std::error_code ec)

stdx::expected< Result, std::error_code >	recv_server_failed (std::error_code ec)

stdx::expected< Result, std::error_code >	send_client_failed (std::error_code ec)

stdx::expected< Result, std::error_code >	recv_client_failed (std::error_code ec)

stdx::expected< Result, std::error_code >	server_socket_failed (std::error_code ec)

stdx::expected< Result, std::error_code >	client_socket_failed (std::error_code ec)

stdx::expected< void, std::error_code >	discard_current_msg (Channel &src_channel, ClassicProtocolState &src_protocol)
	discard to current message. More...

template<class Proto >
stdx::expected< void, std::error_code >	discard_current_msg (TlsSwitchableConnection< Proto > &conn)

void	trace (Tracer::Event e)

Tracer &	tracer ()

TraceEvent *	trace_span (TraceEvent *parent_span, const std::string_view &prefix)
	start a span. More...

void	trace_span_end (TraceEvent *event, TraceEvent::StatusCode status_code=TraceEvent::StatusCode::kUnset)
	end a span and set a status-code. More...

TraceEvent *	trace_command (const std::string_view &prefix)
	start a command span. More...

TraceEvent *	trace_connect_and_forward_command (TraceEvent *parent_span)
	start a connect-and-forward span. More...

TraceEvent *	trace_connect (TraceEvent *parent_span)
	start a connect span. More...

void	trace_set_connection_attributes (TraceEvent *ev)
	start a connect span. More...

TraceEvent *	trace_forward_command (TraceEvent *parent_span)
	start a forward span. More...

void	trace_command_end (TraceEvent *event, TraceEvent::StatusCode status_code=TraceEvent::StatusCode::kUnset)
	end a command span and set a status-code. More...

Static Protected Member Functions inherited from ForwardingProcessor
template<class T >
static bool	message_can_be_forwarded_as_is (ClassicProtocolState &src_protocol, ClassicProtocolState &dst_protocol, const T &msg)
	check of the capabilities of the source and the destination are the same for this message. More...

static bool	connect_error_is_transient (const classic_protocol::message::server::Error &err)
	check if the error is a transient error. More...

Static Protected Member Functions inherited from Processor
static void	log_fatal_error_code (const char *msg, std::error_code ec)
	log a message with error-code as error. More...

Detailed Description

authenticates a server connection.

Assumes the server

sent a server::greeting already
expects to receive a client::greeting

Member Enumeration Documentation

◆ Stage

enum class ServerFirstAuthenticator::Stage

strong

stages of the handshake flow.

Enumerator
ClientGreeting
ClientGreetingStartTls
ClientGreetingFull
TlsForwardInit
TlsForward
TlsConnectInit
TlsConnect
ClientGreetingAfterTls
InitialResponse
FinalResponse
AuthOk
AuthError
FetchUserAttrs
FetchUserAttrsDone
Error
Ok

Constructor & Destructor Documentation

◆ ServerFirstAuthenticator()

ServerFirstAuthenticator::ServerFirstAuthenticator	(	MysqlRoutingClassicConnectionBase *	conn,
		std::function< void(const classic_protocol::message::server::Error &)>	on_error
	)

inline

Member Function Documentation

◆ auth_error()

stdx::expected< Processor::Result, std::error_code > ServerFirstAuthenticator::auth_error ( )

private

router<-server: auth error.

◆ auth_ok()

stdx::expected< Processor::Result, std::error_code > ServerFirstAuthenticator::auth_ok ( )

private

server-side: auth is ok.

◆ client_greeting()

stdx::expected< Processor::Result, std::error_code > ServerFirstAuthenticator::client_greeting ( )

private

◆ client_greeting_after_tls()

stdx::expected< Processor::Result, std::error_code > ServerFirstAuthenticator::client_greeting_after_tls ( )

private

◆ client_greeting_full()

stdx::expected< Processor::Result, std::error_code > ServerFirstAuthenticator::client_greeting_full ( )

private

◆ client_greeting_server_adjust_caps()

void ServerFirstAuthenticator::client_greeting_server_adjust_caps	(	ClassicProtocolState &	rc_protocol,
		ClassicProtocolState &	st_protocol
	)

private

◆ client_greeting_start_tls()

stdx::expected< Processor::Result, std::error_code > ServerFirstAuthenticator::client_greeting_start_tls ( )

private

◆ failed() [1/2]

std::optional< classic_protocol::message::server::Error > ServerFirstAuthenticator::failed ( ) const

inline

◆ failed() [2/2]

void ServerFirstAuthenticator::failed ( const std::optional< classic_protocol::message::server::Error > & err )

inline

◆ fetch_user_attrs()

stdx::expected< Processor::Result, std::error_code > ServerFirstAuthenticator::fetch_user_attrs ( )

private

◆ fetch_user_attrs_done()

stdx::expected< Processor::Result, std::error_code > ServerFirstAuthenticator::fetch_user_attrs_done ( )

private

◆ final_response()

stdx::expected< Processor::Result, std::error_code > ServerFirstAuthenticator::final_response ( )

private

◆ initial_response()

stdx::expected< Processor::Result, std::error_code > ServerFirstAuthenticator::initial_response ( )

private

◆ process()

stdx::expected< Processor::Result, std::error_code > ServerFirstAuthenticator::process ( )

overridevirtual

Implements BasicProcessor.

◆ stage() [1/2]

Stage ServerFirstAuthenticator::stage ( ) const

inline

◆ stage() [2/2]

void ServerFirstAuthenticator::stage ( Stage stage )

inline

◆ tls_connect()

stdx::expected< Processor::Result, std::error_code > ServerFirstAuthenticator::tls_connect ( )

private

◆ tls_connect_init()

stdx::expected< Processor::Result, std::error_code > ServerFirstAuthenticator::tls_connect_init ( )

private

◆ tls_forward()

stdx::expected< Processor::Result, std::error_code > ServerFirstAuthenticator::tls_forward ( )

private

◆ tls_forward_init()

stdx::expected< Processor::Result, std::error_code > ServerFirstAuthenticator::tls_forward_init ( )

private

Member Data Documentation

◆ client_last_recv_buf_size_

size_t ServerFirstAuthenticator::client_last_recv_buf_size_ {}

private

◆ client_last_send_buf_size_

size_t ServerFirstAuthenticator::client_last_send_buf_size_ {}

private

◆ failed_

std::optional<classic_protocol::message::server::Error> ServerFirstAuthenticator::failed_

private

◆ on_error_

std::function<void(const classic_protocol::message::server::Error &err)> ServerFirstAuthenticator::on_error_

private

◆ required_connection_attributes_fetcher_result_

RouterRequireFetcher::Result ServerFirstAuthenticator::required_connection_attributes_fetcher_result_

private

◆ server_last_recv_buf_size_

size_t ServerFirstAuthenticator::server_last_recv_buf_size_ {}

private

◆ server_last_send_buf_size_

size_t ServerFirstAuthenticator::server_last_send_buf_size_ {}

private

◆ stage_

Stage ServerFirstAuthenticator::stage_ {Stage::ClientGreeting}

private

The documentation for this class was generated from the following files:

router/src/routing/src/classic_greeting_forwarder.h
router/src/routing/src/classic_greeting_forwarder.cc

Public Types

Public Member Functions

Private Member Functions

Private Attributes

Additional Inherited Members

Detailed Description

Member Enumeration Documentation

◆ Stage

Constructor & Destructor Documentation

◆ ServerFirstAuthenticator()

Member Function Documentation

◆ auth_error()

◆ auth_ok()

◆ client_greeting()

◆ client_greeting_after_tls()

◆ client_greeting_full()

◆ client_greeting_server_adjust_caps()

◆ client_greeting_start_tls()

◆ failed() [1/2]

◆ failed() [2/2]

◆ fetch_user_attrs()

◆ fetch_user_attrs_done()

◆ final_response()

◆ initial_response()

◆ process()

◆ stage() [1/2]

◆ stage() [2/2]

◆ tls_connect()

◆ tls_connect_init()

◆ tls_forward()

◆ tls_forward_init()

Member Data Documentation

◆ client_last_recv_buf_size_

◆ client_last_send_buf_size_

◆ failed_

◆ on_error_

◆ required_connection_attributes_fetcher_result_

◆ server_last_recv_buf_size_

◆ server_last_send_buf_size_

◆ stage_