Helper class defining an encrypted DTLS endpoint. Note that multiple connections are multiplexed onto a single DTLS socket. More...

#include <DtlsEndpoint.h>

Public Types
enum	ConnectResult { Failed, Pending, Complete }

enum	HandshakeState { None, Connecting, Accepting, Complete, Failed }

Public Member Functions
ConnectResult	Connect (const DtlsSocket &socket, const IpAddress &address, UdpPacketEncodingBuffer &outDtlsData)

ConnectResult	Accept (const DtlsSocket &socket, const IpAddress &address)

bool	IsConnecting () const

ConnectResult	ProcessHandshakeData (UdpConnection &connection, const UdpPacketEncodingBuffer &dtlsData)

const uint8_t *	DecodePacket (UdpConnection &connection, const uint8_t encryptedData, int32_t encryptedSize, uint8_t outDecodedData, int32_t &outDecodedSize)

Detailed Description

Helper class defining an encrypted DTLS endpoint. Note that multiple connections are multiplexed onto a single DTLS socket.

Member Function Documentation

ConnectResult AzNetworking::DtlsEndpoint::Accept	(	const DtlsSocket &	socket,
		const IpAddress &	address
	)

Accepts a connection from the remote encrypted endpoint.

Parameters

socket	the dtls socket being used for data transmission
address	the address of the remote endpoint connecting to us

Returns: a connect result specifying whether the connection is still pending, failed, or complete

ConnectResult AzNetworking::DtlsEndpoint::Connect	(	const DtlsSocket &	socket,
		const IpAddress &	address,
		UdpPacketEncodingBuffer &	outDtlsData
	)

Opens a connection with the remote encrypted endpoint.

Parameters

socket	the dtls socket being used for data transmission
address	the address of the remote endpoint being connected to
outDtlsData	data buffer to store the dtls handshake packet

Returns: a connect result specifying whether the connection is still pending, failed, or complete

const uint8_t* AzNetworking::DtlsEndpoint::DecodePacket	(	UdpConnection &	connection,
		const uint8_t *	encryptedData,
		int32_t	encryptedSize,
		uint8_t *	outDecodedData,
		int32_t &	outDecodedSize
	)

If the endpoint has encryption enabled, this will decrypt the transmitted data and return the result.

Note: sizes have to be signed since OpenSSL often returns negative values to represent error results

Parameters

connection	the UDP connection being used for data transmission
encryptedData	the potentially encrypted data received from the socket
encryptedSize	the size of the received raw data
outDecodedData	an appropriately sized output buffer to store decrypted data
outDecodedSize	the size of the output buffer

bool AzNetworking::DtlsEndpoint::IsConnecting ( ) const

Returns whether or not the endpoint is still negotiating the dtls handshake.

ConnectResult AzNetworking::DtlsEndpoint::ProcessHandshakeData	(	UdpConnection &	connection,
		const UdpPacketEncodingBuffer &	dtlsData
	)

Attempts to complete the dtls handshake and establish an encrypted connection.

Parameters

connection	the UDP connection being used for data transmission
dtlsData	data buffer containing dtls handshake packet

Returns: a connect result specifying whether the connection is still pending, failed, or complete

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