(Node.js) Socket Convert Existing TCP Connection to SSL/TLS

Demonstrates the Chilkat Socket ConvertToSsl method.

Install Chilkat for Node.js and Electron using npm at Chilkat npm packages for Node.js Chilkat npm packages for Electron on Windows, Linux, MacOSX, and ARM

var os = require('os');
if (os.platform() == 'win32') {  
    if (os.arch() == 'ia32') {
        var chilkat = require('@chilkat/ck-node21-win-ia32');
    } else {
        var chilkat = require('@chilkat/ck-node21-win64'); 
    }
} else if (os.platform() == 'linux') {
    if (os.arch() == 'arm') {
        var chilkat = require('@chilkat/ck-node21-arm');
    } else if (os.arch() == 'x86') {
        var chilkat = require('@chilkat/ck-node21-linux32');
    } else {
        var chilkat = require('@chilkat/ck-node21-linux64');
    }
} else if (os.platform() == 'darwin') {
    if (os.arch() == 'arm64') {
        var chilkat = require('@chilkat/ck-node21-mac-m1');
    } else {
        var chilkat = require('@chilkat/ck-node21-macosx');
    }
}

function chilkatExample() {

    // This example requires the Chilkat API to have been previously unlocked.
    // See Global Unlock Sample for sample code.

    var sock = new chilkat.Socket();

    // --------------------------------------------------------------------
    // This example uses the public TCP/TLS echo service at https://tcpbin.com/
    // --------------------------------------------------------------------

    // The echo server at tcpbin.com expects to receive TCP connections on port 4242, and TLS connections on port 4243.
    // We could simply connect to port 4243 using TLS like this.
    // However, further below, this example shows how to initially make a TCP connection, and then convert the connection to TLS.
    var useTls = true;
    var port = 4243;
    var maxWaitMs = 5000;
    var success = sock.Connect("tcpbin.com",port,useTls,maxWaitMs);
    if (success == false) {
        console.log(sock.LastErrorText);
        return;
    }

    // OK, we have a TLS connection.
    // Note: The server chooses the TLS protocol version. 
    // We can see the version of the TLS connection that was established:
    console.log("TLS version: " + sock.TlsVersion);

    sock.Close(maxWaitMs);

    // ---------------------------------------------------------------------
    // Now we'll do the same, except first we connect to port 4243 using TCP,
    // and then convert the connection to TLS.
    // 
    // This may seem pointless, and it is for the case w/ this server.  However, there could be situations
    // where you're interacting with a server of some kind where there is a need to convert to/from TLS.
    // (This is common internal to many protocols, such as SMTP, IMAP, FTP, etc., and it is often called "explicit" SSL/TLS)

    // Connect again, except this time useTls is false, so we only have a simple TCP connection after this call.
    useTls = false;
    success = sock.Connect("tcpbin.com",port,useTls,maxWaitMs);
    if (success == false) {
        console.log(sock.LastErrorText);
        return;
    }

    // Convert the existing TCP connection to TLS.
    // (The method name uses "SSL" because long ago, at the time of initial development, TLS 1.0 did not yet exist.)
    success = sock.ConvertToSsl();
    if (success == false) {
        console.log(sock.LastErrorText);
        return;
    }

    // OK, we now have a TLS connection.
    // Again, we can see the TLS version:
    console.log("TLS version: " + sock.TlsVersion);

    sock.Close(maxWaitMs);

}

chilkatExample();