(Node.js) NTLM Client and Server Code

Demonstrates the NTLM authentication algorithm for both client and server.

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 assumes the Chilkat API to have been previously unlocked.
    // See Global Unlock Sample for sample code.

    var ntlmClient = new chilkat.Ntlm();
    var ntlmServer = new chilkat.Ntlm();

    // The NTLM protocol begins by the client sending the server
    // a Type1 message. 
    var type1Msg;
    ntlmClient.Workstation = "MyWorkstation";
    type1Msg = ntlmClient.GenType1();

    console.log("Type1 message from client to server:");
    console.log(type1Msg);

    // If the server wishes to examine the information embedded within the
    // Type1 message, it may call ParseType1. 
    // This step is not necessary, it is only for informational purposes..
    var type1Info = ntlmServer.ParseType1(type1Msg);

    console.log("---");
    console.log(type1Info);

    // The server now generates a Type2 message to be sent to the client.
    // The Type2 message requires a TargetName.  A TargetName is
    // the authentication realm in which the authenticating account
    // has membership (a domain name for domain accounts, or server name
    // for local machine accounts).
    ntlmServer.TargetName = "myAuthRealm";

    var type2Msg = ntlmServer.GenType2(type1Msg);
    if (ntlmServer.LastMethodSuccess !== true) {
        console.log(ntlmServer.LastErrorText);
        return;
    }

    console.log("Type2 message from server to client:");
    console.log(type2Msg);

    // The client may examine the information embedded in the Type2 message 
    // by calling ParseType2, which returns XML.  This is only for informational purposes
    // and is not required.
    var type2Info = ntlmClient.ParseType2(type2Msg);

    console.log("---");
    console.log(type2Info);

    // The client will now generate the final Type3 message to be sent to the server.
    // This requires the Username and Password:
    ntlmClient.UserName = "test123";
    ntlmClient.Password = "myPassword";

    var type3Msg;
    type3Msg = ntlmClient.GenType3(type2Msg);
    if (ntlmClient.LastMethodSuccess !== true) {
        console.log(ntlmClient.LastErrorText);
        return;
    }

    console.log("Type3 message from client to server:");
    console.log(type3Msg);

    // The server may verify the response by first "loading" the Type3 message.
    // This sets the various properties such as Username, Domain, Workstation,
    // and ClientChallenge to the values embedded within theType3 message.
    // The server may then use the Username to lookup the password.  
    // Looking up the password is dependent on your infrastructure.  Perhaps your
    // usernames/passwords are stored in a secure database.  If that's the case, you would
    // write code to issue a query to get the password string for the given username.
    // Once the password is obtained, set the Password property and then 
    // generate the Type3 response again.  If the server's Type3 response matches
    // the client's Type3 response, then the client's password is correct.

    var success = ntlmServer.LoadType3(type3Msg);
    if (success !== true) {
        console.log(ntlmServer.LastErrorText);
        return;
    }

    // The Username property now contains the username that was embedded within
    // the Type3 message.  It can be used to lookup the password.
    var clientUsername = ntlmServer.UserName;

    // For this example, we'll simply set the password to a literal string:
    ntlmServer.Password = "myPassword";

    // The server may generate the Type3 message again, using the client's correct
    // password:
    var expectedType3Msg = ntlmServer.GenType3(type2Msg);

    console.log("Expected Type3 Message:");
    console.log(expectedType3Msg);

    // If the Type3 message received from the client is exactly the same as the
    // expected Type3 message, then the client must've used the same password,
    // and authentication is successful

}

chilkatExample();