Il s'agit d'une implémentation de fichier d'en-tête uniquement d'un client/serveur C++ avec ou sans SSL/TLS/DTLS. L'implémentation utilise OpenSSL et l'API BSD pour implémenter les interfaces socket sous-jacentes.
La compilation a été testée avec :
Classe de socket de base pour les méthodes de classe API BSD.
// default constructor - no socket created because type is unknown
Socket ();
Socket::initSocket (domain, type, protocol); // creates socket
// create socket from previously created file descriptor
Socket ( int );
// create socket of the given type - NOTE: This returns a Socket class type that is not a Tcp or Udp socket class
Socket (domain, type, protocol);
Créez un objet serveur TCP pour accepter les connexions TCP.
// default no IP/port bound but TCP socket created
TcpServer ();
// TCP socket created, IP/port bound, but not listening
TcpServer ( const uint16_t port, const std::string& ipAddr = " 0.0.0.0 " );
// TCP socket created, IP/port bound, and listening for clients
TcpServer ( const std::string& ipAddr, const uint16_t port, const int backlog);
Créez un objet client TCP pour vous connecter à un serveur TCP connu.
// default TCP socket created but no server connection
TcpClient ();
// create TcpClient with given TCP socket file descriptor
TcpClient ( const int filedescriptor);
// TcpClient connected to a TcpServer IP/port
TcpClient ( const std::string& ipAddr, const uint16_t port);
Créez un serveur SSL TCP pour accepter les clients SSL TCP.
// Create a SSL TCP Server not bound to IP/port
SecureTcpServer ( const std::string& keyFile, const std::string& certFile);
// Create a SSL TCP Server bound to a given port and IP or default IP
SecureTcpServer ( const std::string& keyFile, const std::string& certFile, const uint16_t port, const std::string& ipAddr = " 0.0.0.0 " );
Créez un client SSL TCP pour vous connecter aux serveurs SSL TCP.
// create a SSL TCP client with a given SSL context - used with SecureTcpServer::accept return
SecureTcpClient ( const int filedescriptor, SSL_CTX *sslctx);
// create a SSL TCP client connected to a SSL TCP server
SecureTcpClient ( const std::string& ipAddr, const uint16_t port);
// Client
// Connect to TCP server on IP 127.0.0.1 and port 54321
TcpClient client ( " 127.0.0.1 " , 54321 );
Créez un objet serveur UDP pour accepter les connexions UDP.
// default no IP/port bound but UDP socket created
UdpServer ();
// UDP server socket created, IP/port bound
UdpServer ( const uint16_t port, const std::string &ipAddr = " 0.0.0.0 " );
Créez un objet client UDP pour vous connecter à un serveur UDP connu.
// default UDP socket created but no server connection
UdpClient ();
// UdpClient connected to a UdpServer IP/port
UdpClient ( const std::string& ipAddr, const uint16_t port) noexcept ( false )
Créez un serveur SSL UDP pour accepter les clients SSL UDP.
// Create a SSL UDP Server not bound to IP/port
SecureUdpServer ( const std::string& keyFile, const std::string& certFile);
// Create a SSL UDP Server bound to a given port and IP or default IP
SecureUdpServer ( const std::string& keyFile, const std::string& certFile, const uint16_t port, const std::string& ipAddr = " 0.0.0.0 " );
Créez un client SSL UDP pour vous connecter aux serveurs SSL UDP.
// Create a SSL UDP Client not attempting to connect to a SSL UDP Server (need to call SecureUdpClient::connect(IP, port) to connect)
SecureUdpClient ( const std::string& keyFile, const std::string& certFile);
// create a SSL UDP client connected to a given SSL UDP server waiting in a SecureUdpServer::accept call on the given IP and port
SecureUdpClient ( const std::string& ipAddr, const uint16_t port, const std::string& keyFile, const std::string& certFile);
Ne partagez aucun des objets socket entre les threads, sauf si vous fournissez votre propre sécurité de thread lors des appels d'envoi/lecture et d'acceptation.
Utilisez le fichier cppsocket.hpp
dans votre arborescence source et incluez-le dans le fichier qui doit l'utiliser.
Tests unitaires exécutés avec ctest :
ctest -C debug
Toutes les contributions sont très appréciées.