SSL Server Example

Demonstrates how to create an SSL socket for accepting connections. This example is *very* simple in that it will create an SSL socket for accepting a single connection. It will read a message from the client, send a reply, and exit.

Downloads:

MS Windows Visual C/C++ Libraries

Linux/CentOS C/C++ Libraries

MAC OS X C/C++ Libraries

Solaris C/C++ Libraries

C++ Builder Libraries

#include <C_CkSocket.h>
#include <C_CkCertStore.h>
#include <C_CkCert.h>

void ChilkatSample(void)
    {
    HCkSocket listenSslSocket;
    BOOL success;
    HCkCertStore certStore;
    HCkCert cert;
    long myPort;
    long backLog;
    HCkSocket clientSock;
    long maxWaitMillisec;
    const char * receivedMsg;

    listenSslSocket = CkSocket_Create();

    //  Any string automatically begins a fully-functional 30-day trial.

    success = CkSocket_UnlockComponent(listenSslSocket,"Anything for 30-day trial");
    if (success != TRUE) {
        printf("Failed to unlock component\n");
        return;
    }

    //  An SSL server needs a digital certificate.  This example loads it from a PFX file.

    //  Create an instance of a certificate store object, load a PFX file,
    //  locate the certificate we need, and use it.
    //  (a PFX file may contain more than one certificate.)
    certStore = CkCertStore_Create();
    //  The 1st argument is the filename, the 2nd arg is the
    //  PFX file's password:
    success = CkCertStore_LoadPfxFile(certStore,"chilkat.pfx","test");
    if (success != TRUE) {
        printf("%s\n",CkCertStore_lastErrorText(certStore));
        return;
    }

    //  Find the certificate to be used for SSL:

    cert = CkCertStore_FindCertBySubject(certStore,"Chilkat Software, Inc.");
    if (cert == 0 ) {
        printf("%s\n",CkCertStore_lastErrorText(certStore));
        return;
    }

    //  Use the certificate:
    success = CkSocket_InitSslServer(listenSslSocket,cert);
    if (success != TRUE) {
        printf("%s\n",CkSocket_lastErrorText(listenSslSocket));
        return;
    }

    //  Bind and listen on a port:

    myPort = 8123;
    //  Allow for a max of 5 queued connect requests.

    backLog = 5;
    success = CkSocket_BindAndListen(listenSslSocket,myPort,backLog);
    if (success != TRUE) {
        printf("%s\n",CkSocket_lastErrorText(listenSslSocket));
        return;
    }

    //  If accepting an SSL/TLS connection, the SSL handshake is part of the connection
    //  establishment process. This involves a few back-and-forth messages between the
    //  client and server to establish algorithms and a shared key to create the secure
    //  channel. The sending and receiving of these messages are governed by the
    //  MaxReadIdleMs and MaxSendIdleMs properties. If these properties are set to 0
    //  (and this is the default unless changed by your application), then the
    //  AcceptNextConnection can hang indefinitely during the SSL handshake process.
    //  Make sure these properties are set to appropriate values before calling AcceptNextConnection.

    //  Set a 10 second max for waiting to read/write.  This is for the SSL/TLS handshake establishment.
    CkSocket_putMaxReadIdleMs(listenSslSocket,10000);
    CkSocket_putMaxSendIdleMs(listenSslSocket,10000);

    //  Accept a single client connection and establish the secure SSL/TLS channel:

    maxWaitMillisec = 20000;
    clientSock = CkSocket_AcceptNextConnection(listenSslSocket,maxWaitMillisec);
    if (clientSock == 0 ) {
        printf("%s\n",CkSocket_lastErrorText(listenSslSocket));
        return;
    }

    //  The client (in this example) is going to send a "Hello Server! -EOM-"
    //  message.  Read it:

    receivedMsg = CkSocket_receiveUntilMatch(clientSock,"-EOM-");
    if (receivedMsg == 0 ) {
        printf("%s\n",CkSocket_lastErrorText(clientSock));
        return;
    }

    printf("%s\n",receivedMsg);

    //  Send a "Hello Client! -EOM-" message:
    success = CkSocket_SendString(clientSock,"Hello Client! -EOM-");
    if (success != TRUE) {
        printf("%s\n",CkSocket_lastErrorText(clientSock));
        return;
    }

    //  Close the connection with the client
    //  Wait a max of 20 seconds (20000 millsec)
    CkSocket_Close(clientSock,20000);

    CkSocket_Dispose(listenSslSocket);
    CkCertStore_Dispose(certStore);

    }