SSLNetworkConnectionInterface Class Reference

#include <network_ip_ssl.h>

Inheritance diagram for SSLNetworkConnectionInterface:

Detailed Description

This class handles SSL encrypted network connections.

Public Member Functions

MAXON_METHOD Result< void > Init (const String &authority, const NetworkConnectionRef &wrapConnection, SSLSOCKETTYPE type, SSLPROTOCOLVERSION protocolVersion, SSLCERTREQUIREMENTS certRequire, const Url &keyFile, const Url &certificateFile, const Url &caCertsFile, Bool useClientCertOverride)
 
MAXON_METHOD Result< void > DoHandShake ()
 
MAXON_METHOD Result< UrlGetDefaultCaCertsFile () const
 
MAXON_METHOD Result< StringGetCipherName ()
 

Private Member Functions

 MAXON_INTERFACE (SSLNetworkConnectionInterface, MAXON_REFERENCE_NORMAL, "net.maxon.interface.sslnetworkconnection")
 

Member Function Documentation

◆ MAXON_INTERFACE()

MAXON_INTERFACE ( SSLNetworkConnectionInterface  ,
MAXON_REFERENCE_NORMAL  ,
"net.maxon.interface.sslnetworkconnection"   
)
private

◆ Init()

MAXON_METHOD Result<void> Init ( const String authority,
const NetworkConnectionRef &  wrapConnection,
SSLSOCKETTYPE  type,
SSLPROTOCOLVERSION  protocolVersion,
SSLCERTREQUIREMENTS  certRequire,
const Url keyFile,
const Url certificateFile,
const Url caCertsFile,
Bool  useClientCertOverride 
)

Initializes the object. This connection wraps a basic NetworkConnectionRef into an SSL connection.

Parameters
[in]authorityServer Name/Authority. This name will be used to compare it against the certificate common name when SSLCERTREQUIREMENTS::VERIFY_AUTHORITY is set.
[in]wrapConnectionWraps a basic ip connection into an SSL layer.
[in]typeSelect if the connection is a server or client connection.
[in]protocolVersionChoose the SSL encryption type.
[in]certRequireOption to select if certificates are required or not.
[in]keyFileTODO: (Anybody) not implemented yet.
[in]certificateFileTODO: (Anybody) not implemented yet.
[in]caCertsFileUrl to a file with trusted ca root certificates to verify the server certificate. You can use SSLNetworkConnectionInterface::GetDefaultCaCertsFile() to get the applications default ca file.
[in]useClientCertOverrideTODO: (Anybody) describe.
Returns
OK on success.

◆ DoHandShake()

MAXON_METHOD Result<void> DoHandShake ( )

Executes the handshake with the server.

Returns
OK on success.

◆ GetDefaultCaCertsFile()

MAXON_METHOD Result<Url> GetDefaultCaCertsFile ( ) const

Returns the default ca certification file with trusted root certificates.

Returns
Returns the url with the application default trusted ca root certificates.

◆ GetCipherName()

MAXON_METHOD Result<String> GetCipherName ( )

Returns the name of the cipher being.

Returns
Returns the name after the handshake succeeded.