123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460 |
- /**
- * @description MeshCentral Intel(R) AMT Interceptor
- * @author Ylian Saint-Hilaire
- * @copyright Intel Corporation 2018-2022
- * @license Apache-2.0
- * @version v0.0.3
- */
- /*xjslint node: true */
- /*xjslint plusplus: true */
- /*xjslint maxlen: 256 */
- /*jshint node: true */
- /*jshint strict: false */
- /*jshint esversion: 6 */
- 'use strict';
- const crypto = require('crypto');
- const common = require('./common.js');
- var HttpInterceptorAuthentications = {};
- //var RedirInterceptorAuthentications = {};
- // Construct a HTTP interceptor object
- module.exports.CreateHttpInterceptor = function (args) {
- var obj = {};
- // Create a random hex string of a given length
- obj.randomValueHex = function (len) { return crypto.randomBytes(Math.ceil(len / 2)).toString('hex').slice(0, len); };
- obj.args = args;
- obj.amt = { acc: '', mode: 0, count: 0, error: false }; // mode: 0:Header, 1:LengthBody, 2:ChunkedBody, 3:UntilClose
- obj.ws = { acc: '', mode: 0, count: 0, error: false, authCNonce: obj.randomValueHex(10), authCNonceCount: 1 };
- obj.blockAmtStorage = false;
- // Private method
- obj.Debug = function (msg) { console.log(msg); };
- // Process data coming from Intel AMT
- obj.processAmtData = function (data) {
- obj.amt.acc += data.toString('binary'); // Add data to accumulator
- data = '';
- var datalen = 0;
- do { datalen = data.length; data += obj.processAmtDataEx(); } while (datalen != data.length); // Process as much data as possible
- return Buffer.from(data, 'binary');
- };
- // Process data coming from AMT in the accumulator
- obj.processAmtDataEx = function () {
- var i, r, headerend;
- if (obj.amt.mode == 0) { // Header Mode
- // Decode the HTTP header
- headerend = obj.amt.acc.indexOf('\r\n\r\n');
- if (headerend < 0) return '';
- var headerlines = obj.amt.acc.substring(0, headerend).split('\r\n');
- obj.amt.acc = obj.amt.acc.substring(headerend + 4);
- obj.amt.directive = headerlines[0].split(' ');
- var headers = headerlines.slice(1);
- obj.amt.headers = {};
- obj.amt.mode = 3; // UntilClose
- for (i in headers) {
- var j = headers[i].indexOf(':');
- if (j > 0) {
- var v1 = headers[i].substring(0, j).trim().toLowerCase();
- var v2 = headers[i].substring(j + 1).trim();
- obj.amt.headers[v1] = v2;
- if (v1.toLowerCase() == 'www-authenticate') {
- HttpInterceptorAuthentications[obj.args.host + ':' + obj.args.port] = v2;
- } else if (v1.toLowerCase() == 'content-length') {
- obj.amt.count = parseInt(v2);
- if (obj.amt.count > 0) {
- obj.amt.mode = 1; // LengthBody
- } else {
- obj.amt.mode = 0; // Header
- }
- } else if (v1.toLowerCase() == 'transfer-encoding' && v2.toLowerCase() == 'chunked') {
- obj.amt.mode = 2; // ChunkedBody
- }
- }
- }
- // Reform the HTTP header
- r = obj.amt.directive.join(' ') + '\r\n';
- for (i in obj.amt.headers) { r += (i + ': ' + obj.amt.headers[i] + '\r\n'); }
- r += '\r\n';
- return r;
- } else if (obj.amt.mode == 1) { // Length Body Mode
- // Send the body of content-length size
- var rl = obj.amt.count;
- if (rl < obj.amt.acc.length) rl = obj.amt.acc.length;
- r = obj.amt.acc.substring(0, rl);
- obj.amt.acc = obj.amt.acc.substring(rl);
- obj.amt.count -= rl;
- if (obj.amt.count == 0) { obj.amt.mode = 0; }
- return r;
- } else if (obj.amt.mode == 2) { // Chunked Body Mode
- // Send data one chunk at a time
- headerend = obj.amt.acc.indexOf('\r\n');
- if (headerend < 0) return '';
- var chunksize = parseInt(obj.amt.acc.substring(0, headerend), 16);
- if ((chunksize == 0) && (obj.amt.acc.length >= headerend + 4)) {
- // Send the ending chunk (NOTE: We do not support trailing headers)
- r = obj.amt.acc.substring(0, headerend + 4);
- obj.amt.acc = obj.amt.acc.substring(headerend + 4);
- obj.amt.mode = 0;
- return r;
- } else if ((chunksize > 0) && (obj.amt.acc.length >= (headerend + 4 + chunksize))) {
- // Send a chunk
- r = obj.amt.acc.substring(0, headerend + chunksize + 4);
- obj.amt.acc = obj.amt.acc.substring(headerend + chunksize + 4);
- return r;
- }
- } else if (obj.amt.mode == 3) { // Until Close Mode
- r = obj.amt.acc;
- obj.amt.acc = '';
- return r;
- }
- return '';
- };
- // Process data coming from the Browser
- obj.processBrowserData = function (data) {
- obj.ws.acc += data.toString('binary'); // Add data to accumulator
- data = '';
- var datalen = 0;
- do { datalen = data.length; data += obj.processBrowserDataEx(); } while (datalen != data.length); // Process as much data as possible
- return Buffer.from(data, 'binary');
- };
- // Process data coming from the Browser in the accumulator
- obj.processBrowserDataEx = function () {
- var i, r, headerend;
- if (obj.ws.mode == 0) { // Header Mode
- // Decode the HTTP header
- headerend = obj.ws.acc.indexOf('\r\n\r\n');
- if (headerend < 0) return '';
- var headerlines = obj.ws.acc.substring(0, headerend).split('\r\n');
- obj.ws.acc = obj.ws.acc.substring(headerend + 4);
- obj.ws.directive = headerlines[0].split(' ');
- // If required, block access to amt-storage. This is needed when web storage is not supported on CIRA.
- if ((obj.blockAmtStorage == true) && (obj.ws.directive.length > 1) && (obj.ws.directive[1].indexOf('/amt-storage') == 0)) { obj.ws.directive[1] = obj.ws.directive[1].replace('/amt-storage', '/amt-dummy-storage'); }
- var headers = headerlines.slice(1);
- obj.ws.headers = {};
- obj.ws.mode = 3; // UntilClose
- for (i in headers) {
- var j = headers[i].indexOf(':');
- if (j > 0) {
- var v1 = headers[i].substring(0, j).trim().toLowerCase();
- var v2 = headers[i].substring(j + 1).trim();
- obj.ws.headers[v1] = v2;
- if (v1.toLowerCase() == 'www-authenticate') {
- HttpInterceptorAuthentications[obj.args.host + ':' + obj.args.port] = v2;
- } else if (v1.toLowerCase() == 'content-length') {
- obj.ws.count = parseInt(v2);
- if (obj.ws.count > 0) {
- obj.ws.mode = 1; // LengthBody
- } else {
- obj.ws.mode = 0; // Header
- }
- } else if (v1.toLowerCase() == 'transfer-encoding' && v2.toLowerCase() == 'chunked') {
- obj.ws.mode = 2; // ChunkedBody
- }
- }
- }
- // Insert authentication
- if (obj.args.user && obj.args.pass && HttpInterceptorAuthentications[obj.args.host + ':' + obj.args.port]) {
- // We have authentication data, lets use it.
- var AuthArgs = obj.GetAuthArgs(HttpInterceptorAuthentications[obj.args.host + ':' + obj.args.port]);
- // If different QOP options are proposed, always use 'auth' for now.
- AuthArgs.qop = 'auth';
- // In the future, we should support auth-int, but that will required the body of the request to be accumulated and hashed.
- /*
- if (AuthArgs.qop != null) { // If Intel AMT supports auth-int, use it.
- var qopList = AuthArgs.qop.split(',');
- for (var i in qopList) { qopList[i] = qopList[i].trim(); }
- if (qopList.indexOf('auth-int') >= 0) { AuthArgs.qop = 'auth-int'; } else { AuthArgs.qop = 'auth'; }
- }
- */
- var hash = obj.ComputeDigesthash(obj.args.user, obj.args.pass, AuthArgs.realm, obj.ws.directive[0], obj.ws.directive[1], AuthArgs.qop, AuthArgs.nonce, obj.ws.authCNonceCount, obj.ws.authCNonce);
- var authstr = 'Digest username="' + obj.args.user + '",realm="' + AuthArgs.realm + '",nonce="' + AuthArgs.nonce + '",uri="' + obj.ws.directive[1] + '",qop=' + AuthArgs.qop + ',nc=' + obj.ws.authCNonceCount + ',cnonce="' + obj.ws.authCNonce + '",response="' + hash + '"';
- if (AuthArgs.opaque) { authstr += (',opaque="' + AuthArgs.opaque + '"'); }
- obj.ws.headers.authorization = authstr;
- obj.ws.authCNonceCount++;
- } else {
- // We don't have authentication, clear it out of the header if needed.
- if (obj.ws.headers.authorization) { delete obj.ws.headers.authorization; }
- }
- // Reform the HTTP header
- r = obj.ws.directive.join(' ') + '\r\n';
- for (i in obj.ws.headers) { r += (i + ': ' + obj.ws.headers[i] + '\r\n'); }
- r += '\r\n';
- return r;
- } else if (obj.ws.mode == 1) { // Length Body Mode
- // Send the body of content-length size
- var rl = obj.ws.count;
- if (rl < obj.ws.acc.length) rl = obj.ws.acc.length;
- r = obj.ws.acc.substring(0, rl);
- obj.ws.acc = obj.ws.acc.substring(rl);
- obj.ws.count -= rl;
- if (obj.ws.count == 0) { obj.ws.mode = 0; }
- return r;
- } else if (obj.amt.mode == 2) { // Chunked Body Mode
- // Send data one chunk at a time
- headerend = obj.amt.acc.indexOf('\r\n');
- if (headerend < 0) return '';
- var chunksize = parseInt(obj.amt.acc.substring(0, headerend), 16);
- if (isNaN(chunksize)) { // TODO: Check this path
- // Chunk is not in this batch, move one
- r = obj.amt.acc.substring(0, headerend + 2);
- obj.amt.acc = obj.amt.acc.substring(headerend + 2);
- // Peek if we next is the end of chunked transfer
- headerend = obj.amt.acc.indexOf('\r\n');
- if (headerend > 0) {
- chunksize = parseInt(obj.amt.acc.substring(0, headerend), 16);
- if (chunksize == 0) { obj.amt.mode = 0; }
- }
- return r;
- } else if (chunksize == 0 && obj.amt.acc.length >= headerend + 4) {
- // Send the ending chunk (NOTE: We do not support trailing headers)
- r = obj.amt.acc.substring(0, headerend + 4);
- obj.amt.acc = obj.amt.acc.substring(headerend + 4);
- obj.amt.mode = 0;
- return r;
- } else if (chunksize > 0 && obj.amt.acc.length >= headerend + 4) {
- // Send a chunk
- r = obj.amt.acc.substring(0, headerend + chunksize + 4);
- obj.amt.acc = obj.amt.acc.substring(headerend + chunksize + 4);
- return r;
- }
- } else if (obj.ws.mode == 3) { // Until Close Mode
- r = obj.ws.acc;
- obj.ws.acc = '';
- return r;
- }
- return '';
- };
- // Parse authentication values from the HTTP header
- obj.GetAuthArgs = function (authheader) {
- var authargs = {};
- var authargsstr = authheader.substring(7).split(',');
- for (var j in authargsstr) {
- var argstr = authargsstr[j];
- var i = argstr.indexOf('=');
- var k = argstr.substring(0, i).trim().toLowerCase();
- var v = argstr.substring(i + 1).trim();
- if (v.substring(0, 1) == '\"') { v = v.substring(1, v.length - 1); }
- if (i > 0) authargs[k] = v;
- }
- return authargs;
- };
- // Compute the MD5 digest hash for a set of values
- obj.ComputeDigesthash = function (username, password, realm, method, path, qop, nonce, nc, cnonce) {
- var ha1 = crypto.createHash('md5').update(username + ':' + realm + ':' + password).digest('hex');
- var ha2 = crypto.createHash('md5').update(method + ':' + path).digest('hex');
- return crypto.createHash('md5').update(ha1 + ':' + nonce + ':' + nc + ':' + cnonce + ':' + qop + ':' + ha2).digest('hex');
- };
- return obj;
- };
- // Construct a redirection interceptor object
- module.exports.CreateRedirInterceptor = function (args) {
- var obj = {};
- // Create a random hex string of a given length
- obj.randomValueHex = function (len) { return crypto.randomBytes(Math.ceil(len / 2)).toString('hex').slice(0, len); };
- obj.args = args;
- obj.amt = { acc: '', mode: 0, count: 0, error: false, direct: false };
- obj.ws = { acc: '', mode: 0, count: 0, error: false, direct: false, authCNonce: obj.randomValueHex(10), authCNonceCount: 1 };
- obj.RedirectCommands = { StartRedirectionSession: 0x10, StartRedirectionSessionReply: 0x11, EndRedirectionSession: 0x12, AuthenticateSession: 0x13, AuthenticateSessionReply: 0x14 };
- obj.StartRedirectionSessionReplyStatus = { SUCCESS: 0, TYPE_UNKNOWN: 1, BUSY: 2, UNSUPPORTED: 3, ERROR: 0xFF };
- obj.AuthenticationStatus = { SUCCESS: 0, FALIURE: 1, NOTSUPPORTED: 2 };
- obj.AuthenticationType = { QUERY: 0, USERPASS: 1, KERBEROS: 2, BADDIGEST: 3, DIGEST: 4 };
- // Private method
- obj.Debug = function (msg) { console.log(msg); };
- // Process data coming from Intel AMT
- obj.processAmtData = function (data) {
- if ((obj.amt.direct == true) && (obj.amt.acc == '')) { return data; } // Interceptor fast path
- obj.amt.acc += data.toString('binary'); // Add data to accumulator
- data = '';
- var datalen = 0;
- do { datalen = data.length; data += obj.processAmtDataEx(); } while (datalen != data.length); // Process as much data as possible
- return Buffer.from(data, 'binary');
- };
- // Process data coming from AMT in the accumulator
- obj.processAmtDataEx = function () {
- var r;
- if (obj.amt.acc.length == 0) return '';
- if (obj.amt.direct == true) {
- var data = obj.amt.acc;
- obj.amt.acc = '';
- return data;
- } else {
- //console.log(obj.amt.acc.charCodeAt(0));
- switch (obj.amt.acc.charCodeAt(0)) {
- case obj.RedirectCommands.StartRedirectionSessionReply: {
- if (obj.amt.acc.length < 4) return '';
- if (obj.amt.acc.charCodeAt(1) == obj.StartRedirectionSessionReplyStatus.SUCCESS) {
- if (obj.amt.acc.length < 13) return '';
- var oemlen = obj.amt.acc.charCodeAt(12);
- if (obj.amt.acc.length < 13 + oemlen) return '';
- r = obj.amt.acc.substring(0, 13 + oemlen);
- obj.amt.acc = obj.amt.acc.substring(13 + oemlen);
- return r;
- }
- break;
- }
- case obj.RedirectCommands.AuthenticateSessionReply: {
- if (obj.amt.acc.length < 9) return '';
- var l = common.ReadIntX(obj.amt.acc, 5);
- if (obj.amt.acc.length < 9 + l) return '';
- var authstatus = obj.amt.acc.charCodeAt(1);
- var authType = obj.amt.acc.charCodeAt(4);
- if ((authType == obj.AuthenticationType.DIGEST) && (authstatus == obj.AuthenticationStatus.FALIURE)) {
- // Grab and keep all authentication parameters
- var realmlen = obj.amt.acc.charCodeAt(9);
- obj.amt.digestRealm = obj.amt.acc.substring(10, 10 + realmlen);
- var noncelen = obj.amt.acc.charCodeAt(10 + realmlen);
- obj.amt.digestNonce = obj.amt.acc.substring(11 + realmlen, 11 + realmlen + noncelen);
- var qoplen = obj.amt.acc.charCodeAt(11 + realmlen + noncelen);
- obj.amt.digestQOP = obj.amt.acc.substring(12 + realmlen + noncelen, 12 + realmlen + noncelen + qoplen);
- }
- else if (authType != obj.AuthenticationType.QUERY && authstatus == obj.AuthenticationStatus.SUCCESS) {
- // Intel AMT relayed that authentication was successful, go to direct relay mode in both directions.
- obj.ws.direct = true;
- obj.amt.direct = true;
- }
- r = obj.amt.acc.substring(0, 9 + l);
- obj.amt.acc = obj.amt.acc.substring(9 + l);
- return r;
- }
- default: {
- obj.amt.error = true;
- return '';
- }
- }
- }
- return '';
- };
- // Process data coming from the Browser
- obj.processBrowserData = function (data) {
- if ((obj.ws.direct == true) && (obj.ws.acc == '')) { return data; } // Interceptor fast path
- obj.ws.acc += data.toString('binary'); // Add data to accumulator
- data = '';
- var datalen = 0;
- do { datalen = data.length; data += obj.processBrowserDataEx(); } while (datalen != data.length); // Process as much data as possible
- return Buffer.from(data, 'binary');
- };
- // Process data coming from the Browser in the accumulator
- obj.processBrowserDataEx = function () {
- var r;
- if (obj.ws.acc.length == 0) return '';
- if (obj.ws.direct == true) {
- var data = obj.ws.acc;
- obj.ws.acc = '';
- return data;
- } else {
- switch (obj.ws.acc.charCodeAt(0)) {
- case obj.RedirectCommands.StartRedirectionSession: {
- if (obj.ws.acc.length < 8) return '';
- r = obj.ws.acc.substring(0, 8);
- obj.ws.acc = obj.ws.acc.substring(8);
- return r;
- }
- case obj.RedirectCommands.EndRedirectionSession: {
- if (obj.ws.acc.length < 4) return '';
- r = obj.ws.acc.substring(0, 4);
- obj.ws.acc = obj.ws.acc.substring(4);
- return r;
- }
- case obj.RedirectCommands.AuthenticateSession: {
- if (obj.ws.acc.length < 9) return '';
- var l = common.ReadIntX(obj.ws.acc, 5);
- if (obj.ws.acc.length < 9 + l) return '';
- var authType = obj.ws.acc.charCodeAt(4);
- if (authType == obj.AuthenticationType.DIGEST && obj.args.user && obj.args.pass) {
- var authurl = '/RedirectionService';
- if (obj.amt.digestRealm) {
- // Replace this authentication digest with a server created one
- // We have everything we need to authenticate
- var nc = '0'+ (10000000 + obj.ws.authCNonceCount).toString().substring(1);// set NC at least 8 bytes
- obj.ws.authCNonceCount++;
- var digest = obj.ComputeDigesthash(obj.args.user, obj.args.pass, obj.amt.digestRealm, 'POST', authurl, obj.amt.digestQOP, obj.amt.digestNonce, nc, obj.ws.authCNonce);
- // Replace this authentication digest with a server created one
- // We have everything we need to authenticate
- r = String.fromCharCode(0x13, 0x00, 0x00, 0x00, 0x04);
- r += common.IntToStrX(obj.args.user.length + obj.amt.digestRealm.length + obj.amt.digestNonce.length + authurl.length + obj.ws.authCNonce.length + nc.toString().length + digest.length + obj.amt.digestQOP.length + 8);
- r += String.fromCharCode(obj.args.user.length); // Username Length
- r += obj.args.user; // Username
- r += String.fromCharCode(obj.amt.digestRealm.length); // Realm Length
- r += obj.amt.digestRealm; // Realm
- r += String.fromCharCode(obj.amt.digestNonce.length); // Nonce Length
- r += obj.amt.digestNonce; // Nonce
- r += String.fromCharCode(authurl.length); // Authentication URL "/RedirectionService" Length
- r += authurl; // Authentication URL
- r += String.fromCharCode(obj.ws.authCNonce.length); // CNonce Length
- r += obj.ws.authCNonce; // CNonce
- r += String.fromCharCode(nc.toString().length); // NonceCount Length
- r += nc.toString(); // NonceCount
- r += String.fromCharCode(digest.length); // Response Length
- r += digest; // Response
- r += String.fromCharCode(obj.amt.digestQOP.length); // QOP Length
- r += obj.amt.digestQOP; // QOP
- obj.ws.acc = obj.ws.acc.substring(9 + l); // Don't relay the original message
- return r;
- } else {
- // Replace this authentication digest with a server created one
- // Since we don't have authentication parameters, fill them in with blanks to get an error back what that info.
- r = String.fromCharCode(0x13, 0x00, 0x00, 0x00, 0x04);
- r += common.IntToStrX(obj.args.user.length + authurl.length + 8);
- r += String.fromCharCode(obj.args.user.length);
- r += obj.args.user;
- r += String.fromCharCode(0x00, 0x00, authurl.length);
- r += authurl;
- r += String.fromCharCode(0x00, 0x00, 0x00, 0x00);
- obj.ws.acc = obj.ws.acc.substring(9 + l); // Don't relay the original message
- return r;
- }
- }
- r = obj.ws.acc.substring(0, 9 + l);
- obj.ws.acc = obj.ws.acc.substring(9 + l);
- return r;
- }
- default: {
- obj.ws.error = true;
- }
- }
- }
- return '';
- };
- // Compute the MD5 digest hash for a set of values
- obj.ComputeDigesthash = function (username, password, realm, method, path, qop, nonce, nc, cnonce) {
- var ha1 = crypto.createHash('md5').update(username + ':' + realm + ':' + password).digest('hex');
- var ha2 = crypto.createHash('md5').update(method + ':' + path).digest('hex');
- return crypto.createHash('md5').update(ha1 + ':' + nonce + ':' + nc + ':' + cnonce + ':' + qop + ':' + ha2).digest('hex');
- };
- return obj;
- };
|