mirror of
https://github.com/Ylianst/MeshCentral.git
synced 2024-12-26 23:25:53 -05:00
1384 lines
79 KiB
JavaScript
1384 lines
79 KiB
JavaScript
/**
|
|
* @description MeshCentral Intel AMT manager
|
|
* @author Ylian Saint-Hilaire
|
|
* @copyright Intel Corporation 2018-2020
|
|
* @license Apache-2.0
|
|
* @version v0.0.1
|
|
*/
|
|
|
|
/*jslint node: true */
|
|
/*jshint node: true */
|
|
/*jshint strict:false */
|
|
/*jshint -W097 */
|
|
/*jshint esversion: 6 */
|
|
'use strict';
|
|
|
|
module.exports.CreateAmtManager = function(parent) {
|
|
var obj = {};
|
|
obj.parent = parent;
|
|
obj.amtDevices = {}; // Nodeid --> [ dev ]
|
|
obj.activeLocalConnections = {}; // Host --> dev
|
|
obj.amtAdminAccounts = {}; // DomainId -> [ { user, pass } ]
|
|
obj.rootCertBase64 = obj.parent.certificates.root.cert.split('-----BEGIN CERTIFICATE-----').join('').split('-----END CERTIFICATE-----').join('').split('\r').join('').split('\n').join('')
|
|
obj.rootCertCN = obj.parent.certificateOperations.forge.pki.certificateFromPem(obj.parent.certificates.root.cert).subject.getField('CN').value;
|
|
|
|
// WSMAN stack
|
|
const CreateWsmanComm = require('./amt/amt-wsman-comm');
|
|
const WsmanStackCreateService = require('./amt/amt-wsman');
|
|
const AmtStackCreateService = require('./amt/amt');
|
|
const ConnectionTypeStrings = { 0: "CIRA", 1: "Relay", 2: "LMS", 3: "Local" };
|
|
|
|
// Load the Intel AMT admin accounts credentials for each domain
|
|
if ((parent.config != null) && (parent.config.domains != null)) {
|
|
for (var domainid in parent.config.domains) {
|
|
var domain = parent.config.domains[domainid];
|
|
if ((typeof domain.amtmanager == 'object') && (Array.isArray(domain.amtmanager.amtadminaccount) == true)) {
|
|
for (var i in domain.amtmanager.amtadminaccount) {
|
|
var c = domain.amtmanager.amtadminaccount[i], c2 = { user: 'admin' };
|
|
if (typeof c.user == 'string') { c2.user = c.user; }
|
|
if (typeof c.pass == 'string') {
|
|
c2.pass = c.pass;
|
|
if (obj.amtAdminAccounts[domainid] == null) { obj.amtAdminAccounts[domainid] = []; }
|
|
obj.amtAdminAccounts[domainid].push(c2);
|
|
}
|
|
}
|
|
}
|
|
|
|
}
|
|
}
|
|
|
|
// Check if an Intel AMT device is being managed
|
|
function isAmtDeviceValid(dev) {
|
|
var devices = obj.amtDevices[dev.nodeid];
|
|
if (devices == null) return false;
|
|
return (devices.indexOf(dev) >= 0)
|
|
}
|
|
|
|
// Add an Intel AMT managed device
|
|
function addAmtDevice(dev) {
|
|
var devices = obj.amtDevices[dev.nodeid];
|
|
if (devices == null) { obj.amtDevices[dev.nodeid] = [dev]; return true; }
|
|
if (devices.indexOf(dev) >= 0) { return false; } // This device is already in the list
|
|
devices.push(dev); // Add the device to the list
|
|
return true;
|
|
}
|
|
|
|
// Remove an Intel AMT managed device
|
|
function removeAmtDevice(dev) {
|
|
// Find the device in the list
|
|
var devices = obj.amtDevices[dev.nodeid];
|
|
if (devices == null) return false;
|
|
var i = devices.indexOf(dev);
|
|
if (i == -1) return false;
|
|
|
|
// Remove from task limiter if needed
|
|
if (dev.taskid != null) { obj.parent.taskLimiter.completed(dev.taskid); delete dev.taskLimiter; }
|
|
|
|
// Clean up this device
|
|
if (dev.amtstack != null) { dev.amtstack.wsman.comm.FailAllError = 999; delete dev.amtstack; } // Disconnect any active connections.
|
|
if (dev.polltimer != null) { clearInterval(dev.polltimer); delete dev.polltimer; }
|
|
|
|
// Remove the device from the list
|
|
devices.splice(i, 1);
|
|
if (devices.length == 0) { delete obj.amtDevices[dev.nodeid]; } else { obj.amtDevices[dev.nodeid] = devices; }
|
|
|
|
// Notify connection closure if this is a LMS connection
|
|
if (dev.connType == 2) { dev.controlMsg({ action: "close" }); }
|
|
return true;
|
|
}
|
|
|
|
// Remove all Intel AMT devices for a given nodeid
|
|
function removeDevice(nodeid) {
|
|
// Find the devices in the list
|
|
var devices = obj.amtDevices[nodeid];
|
|
if (devices == null) return false;
|
|
|
|
for (var i in devices) {
|
|
var dev = devices[i];
|
|
|
|
// Remove from task limiter if needed
|
|
if (dev.taskid != null) { obj.parent.taskLimiter.completed(dev.taskid); delete dev.taskLimiter; }
|
|
|
|
// Clean up this device
|
|
if (dev.amtstack != null) { dev.amtstack.wsman.comm.FailAllError = 999; delete dev.amtstack; } // Disconnect any active connections.
|
|
if (dev.polltimer != null) { clearInterval(dev.polltimer); delete dev.polltimer; }
|
|
}
|
|
|
|
// Remove all devices
|
|
delete obj.amtDevices[nodeid];
|
|
return true;
|
|
}
|
|
|
|
// Start Intel AMT management
|
|
obj.startAmtManagement = function (nodeid, connType, connection) {
|
|
//if (connType == 3) return; // DEBUG
|
|
var devices = obj.amtDevices[nodeid], dev = null;
|
|
if (devices != null) { for (var i in devices) { if ((devices[i].mpsConnection == connection) || (devices[i].host == connection)) { dev = devices[i]; } } }
|
|
if (dev != null) return false; // We are already managing this device on this connection
|
|
dev = { nodeid: nodeid, connType: connType, domainid: nodeid.split('/')[1] };
|
|
if (typeof connection == 'string') { dev.host = connection; }
|
|
if (typeof connection == 'object') { dev.mpsConnection = connection; }
|
|
dev.consoleMsg = function deviceConsoleMsg(msg) { if (typeof deviceConsoleMsg.conn == 'object') { deviceConsoleMsg.conn.ControlMsg({ action: 'console', msg: msg }); } }
|
|
dev.consoleMsg.conn = connection;
|
|
dev.consoleMsg.dev = dev;
|
|
dev.controlMsg = function deviceControlMsg(msg) { if (typeof deviceControlMsg.conn == 'object') { deviceControlMsg.conn.ControlMsg(msg); } }
|
|
dev.controlMsg.conn = connection;
|
|
parent.debug('amt', "Start Management", nodeid, connType);
|
|
addAmtDevice(dev);
|
|
|
|
// Start the device manager the task limiter so not to flood the server. Low priority task
|
|
obj.parent.taskLimiter.launch(function (dev, taskid, taskLimiterQueue) {
|
|
if (isAmtDeviceValid(dev)) {
|
|
// Start managing this device
|
|
dev.taskid = taskid;
|
|
fetchIntelAmtInformation(dev);
|
|
} else {
|
|
// Device is not valid anymore, do nothing
|
|
obj.parent.taskLimiter.completed(taskid);
|
|
}
|
|
}, dev, 2);
|
|
}
|
|
|
|
// Stop Intel AMT management
|
|
obj.stopAmtManagement = function (nodeid, connType, connection) {
|
|
var devices = obj.amtDevices[nodeid], dev = null;
|
|
if (devices != null) { for (var i in devices) { if ((devices[i].mpsConnection == connection) || (devices[i].host == connection)) { dev = devices[i]; } } }
|
|
if (dev == null) return false; // We are not managing this device on this connection
|
|
parent.debug('amt', "Stop Management", nodeid, connType);
|
|
return removeAmtDevice(dev);
|
|
}
|
|
|
|
// Get a string status of the managed devices
|
|
obj.getStatusString = function () {
|
|
var r = '';
|
|
for (var nodeid in obj.amtDevices) {
|
|
var devices = obj.amtDevices[nodeid];
|
|
r += devices[0].nodeid + ', ' + devices[0].name + '\r\n';
|
|
for (var i in devices) {
|
|
var dev = devices[i];
|
|
var items = [];
|
|
if (dev.state == 1) { items.push('Connected'); } else { items.push('Trying'); }
|
|
items.push(ConnectionTypeStrings[dev.connType]);
|
|
if (dev.connType == 3) { items.push(dev.host); }
|
|
if (dev.polltimer != null) { items.push('Polling Power'); }
|
|
r += ' ' + items.join(', ') + '\r\n';
|
|
}
|
|
}
|
|
if (r == '') { r = "No managed Intel AMT devices"; }
|
|
return r;
|
|
}
|
|
|
|
// Subscribe to server events
|
|
parent.AddEventDispatch(['*'], obj);
|
|
|
|
// Handle server events
|
|
// Make sure to only manage devices with connections to this server. In a multi-server setup, we don't want multiple managers talking to the same device.
|
|
obj.HandleEvent = function (source, event, ids, id) {
|
|
switch (event.action) {
|
|
case 'removenode': { // React to node being removed
|
|
removeDevice(event.nodeid);
|
|
break;
|
|
}
|
|
case 'wakedevices': { // React to node wakeup command, perform Intel AMT wake if possible
|
|
if (Array.isArray(event.nodeids)) { for (var i in event.nodeids) { performPowerAction(event.nodeids[i], 2); } }
|
|
break;
|
|
}
|
|
case 'changenode': { // React to changes in a device
|
|
var devices = obj.amtDevices[event.nodeid];
|
|
if (devices = null) break; // We are not managing this device
|
|
if (event.amtchange === 1) {
|
|
// TODO
|
|
} else {
|
|
/*
|
|
var dev = obj.amtDevices[event.nodeid];
|
|
if (dev != null) {
|
|
var amtchange = 0;
|
|
if (dev.name != event.node.name) { dev.name = event.node.name; }
|
|
if (dev.host != event.node.host) {
|
|
dev.host = event.node.host;
|
|
// The host has changed, if we are connected to this device locally, we need to reset.
|
|
if ((dev.conn & 4) != 0) { removeDevice(dev.nodeid); return; } // We are going to wait for the AMT scanned to find this device again.
|
|
}
|
|
}
|
|
*/
|
|
}
|
|
break;
|
|
}
|
|
}
|
|
}
|
|
|
|
|
|
//
|
|
// Intel AMT Connection Setup
|
|
//
|
|
|
|
// Update information about a device
|
|
function fetchIntelAmtInformation(dev) {
|
|
parent.db.Get(dev.nodeid, function (err, nodes) {
|
|
if ((nodes == null) || (nodes.length != 1)) { removeAmtDevice(dev); return; }
|
|
const node = nodes[0];
|
|
if ((node.intelamt == null) || (node.meshid == null)) { removeAmtDevice(dev); return; }
|
|
const mesh = parent.webserver.meshes[node.meshid];
|
|
if (mesh == null) { removeAmtDevice(dev); return; }
|
|
if (dev == null) { return; }
|
|
dev.name = node.name;
|
|
//if (node.host) { dev.host = node.host.toLowerCase(); }
|
|
dev.meshid = node.meshid;
|
|
dev.intelamt = node.intelamt;
|
|
dev.consoleMsg("Attempting Intel AMT connection...");
|
|
attemptInitialContact(dev);
|
|
});
|
|
}
|
|
|
|
// Attempt to perform initial contact with Intel AMT
|
|
function attemptInitialContact(dev) {
|
|
parent.debug('amt', "Attempt Initial Contact", dev.name, dev.connType);
|
|
|
|
if ((dev.connType == 2) && (dev.mpsConnection != null) && (dev.mpsConnection.tag != null) && (dev.mpsConnection.tag.meiState != null) && (dev.mpsConnection.tag.meiState.ProvisioningState !== 2)) {
|
|
// This Intel AMT device is not activated, we need to work on activating it.
|
|
activateIntelAmt(dev);
|
|
return;
|
|
}
|
|
|
|
if ((dev.acctry == null) && ((typeof dev.intelamt.user != 'string') || (typeof dev.intelamt.pass != 'string'))) {
|
|
if ((obj.amtAdminAccounts[dev.domainid] != null) && (obj.amtAdminAccounts[dev.domainid].length > 0)) { dev.acctry = 0; } else { removeAmtDevice(dev); return; }
|
|
}
|
|
|
|
switch (dev.connType) {
|
|
case 0: // CIRA
|
|
// Handle the case where the Intel AMT CIRA is connected (connType 0)
|
|
// In this connection type, we look at the port bindings to see if we need to do TLS or not.
|
|
|
|
// Check to see if CIRA is connected on this server.
|
|
var ciraconn = dev.mpsConnection;
|
|
if ((ciraconn == null) || (ciraconn.tag == null) || (ciraconn.tag.boundPorts == null)) { removeAmtDevice(dev); return; } // CIRA connection is not on this server, no need to deal with this device anymore.
|
|
|
|
// See what user/pass to try.
|
|
var user = null, pass = null;
|
|
if (dev.acctry == null) { user = dev.intelamt.user; pass = dev.intelamt.pass; } else { user = obj.amtAdminAccounts[dev.domainid][dev.acctry].user; pass = obj.amtAdminAccounts[dev.domainid][dev.acctry].pass; }
|
|
|
|
// See if we need to perform TLS or not. We prefer not to do TLS within CIRA.
|
|
var dotls = -1;
|
|
if (ciraconn.tag.boundPorts.indexOf('16992')) { dotls = 0; }
|
|
else if (ciraconn.tag.boundPorts.indexOf('16993')) { dotls = 1; }
|
|
if (dotls == -1) { removeAmtDevice(dev); return; } // The Intel AMT ports are not open, not a device we can deal with.
|
|
|
|
// Connect now
|
|
parent.debug('amt', 'CIRA-Connect', (dotls == 1) ? "TLS" : "NoTLS", dev.name, user, pass);
|
|
var comm;
|
|
if (dotls == 1) {
|
|
comm = CreateWsmanComm(dev.nodeid, 16993, user, pass, 1, null, ciraconn); // Perform TLS
|
|
comm.xtlsFingerprint = 0; // Perform no certificate checking
|
|
} else {
|
|
comm = CreateWsmanComm(dev.nodeid, 16992, user, pass, 0, null, ciraconn); // No TLS
|
|
}
|
|
var wsstack = WsmanStackCreateService(comm);
|
|
dev.amtstack = AmtStackCreateService(wsstack);
|
|
dev.amtstack.dev = dev;
|
|
dev.amtstack.BatchEnum(null, ['*AMT_GeneralSettings', '*IPS_HostBasedSetupService'], attemptLocalConnectResponse);
|
|
break;
|
|
case 1:
|
|
case 2:
|
|
// Handle the case where the Intel AMT relay or LMS is connected (connType 1 or 2)
|
|
// Check to see if CIRA is connected on this server.
|
|
var ciraconn = dev.mpsConnection;
|
|
if ((ciraconn == null) || (ciraconn.tag == null) || (ciraconn.tag.boundPorts == null)) { removeAmtDevice(dev); return; } // Relay connection not valid
|
|
|
|
// See what user/pass to try.
|
|
var user = null, pass = null;
|
|
if (dev.acctry == null) { user = dev.intelamt.user; pass = dev.intelamt.pass; } else { user = obj.amtAdminAccounts[dev.domainid][dev.acctry].user; pass = obj.amtAdminAccounts[dev.domainid][dev.acctry].pass; }
|
|
|
|
// Connect now
|
|
var comm;
|
|
dev.tlsfail = true; // DEBUG!!!!!!!
|
|
if (dev.tlsfail !== true) {
|
|
parent.debug('amt', 'Relay-Connect', "TLS", dev.name, user, pass);
|
|
comm = CreateWsmanComm(dev.nodeid, 16993, user, pass, 1, null, ciraconn); // Perform TLS
|
|
comm.xtlsFingerprint = 0; // Perform no certificate checking
|
|
} else {
|
|
parent.debug('amt', 'Relay-Connect', "NoTLS", dev.name, user, pass);
|
|
comm = CreateWsmanComm(dev.nodeid, 16992, user, pass, 0, null, ciraconn); // No TLS
|
|
}
|
|
var wsstack = WsmanStackCreateService(comm);
|
|
dev.amtstack = AmtStackCreateService(wsstack);
|
|
dev.amtstack.dev = dev;
|
|
dev.amtstack.BatchEnum(null, ['*AMT_GeneralSettings', '*IPS_HostBasedSetupService'], attemptLocalConnectResponse);
|
|
break;
|
|
case 3:
|
|
// Handle the case where the Intel AMT local scanner found the device (connType 3)
|
|
parent.debug('amt', "Attempt Initial Local Contact", dev.name, dev.connType, dev.host);
|
|
if (typeof dev.host != 'string') { removeAmtDevice(dev); return; } // Local connection not valid
|
|
|
|
// Since we don't allow two or more connections to the same host, check if a pending connection is active.
|
|
if (obj.activeLocalConnections[dev.host] != null) {
|
|
// Active connection, hold and try later.
|
|
var tryAgainFunc = function tryAgainFunc() { if (obj.amtDevices[tryAgainFunc.dev.nodeid] != null) { attemptInitialContact(tryAgainFunc.dev); } }
|
|
tryAgainFunc.dev = dev;
|
|
setTimeout(tryAgainFunc, 5000);
|
|
} else {
|
|
// No active connections, see what user/pass to try.
|
|
var user = null, pass = null;
|
|
if (dev.acctry == null) { user = dev.intelamt.user; pass = dev.intelamt.pass; } else { user = obj.amtAdminAccounts[dev.domainid][dev.acctry].user; pass = obj.amtAdminAccounts[dev.domainid][dev.acctry].pass; }
|
|
|
|
// Connect now
|
|
var comm;
|
|
if (dev.tlsfail !== true) {
|
|
parent.debug('amt', 'Direct-Connect', "TLS", dev.name, dev.host, user, pass);
|
|
comm = CreateWsmanComm(dev.host, 16993, user, pass, 1); // Always try with TLS first
|
|
comm.xtlsFingerprint = 0; // Perform no certificate checking
|
|
} else {
|
|
parent.debug('amt', 'Direct-Connect', "NoTLS", dev.name, dev.host, user, pass);
|
|
comm = CreateWsmanComm(dev.host, 16992, user, pass, 0); // Try without TLS
|
|
}
|
|
var wsstack = WsmanStackCreateService(comm);
|
|
dev.amtstack = AmtStackCreateService(wsstack);
|
|
dev.amtstack.dev = dev;
|
|
obj.activeLocalConnections[dev.host] = dev;
|
|
dev.amtstack.BatchEnum(null, ['*AMT_GeneralSettings', '*IPS_HostBasedSetupService'], attemptLocalConnectResponse);
|
|
dev.conntype = 1; // LOCAL
|
|
}
|
|
break;
|
|
}
|
|
}
|
|
|
|
function attemptLocalConnectResponse(stack, name, responses, status) {
|
|
const dev = stack.dev;
|
|
parent.debug('amt', "Initial Contact Response", dev.name, status);
|
|
|
|
// If this is a local connection device, release active connection to this host.
|
|
if (dev.connType == 3) { delete obj.activeLocalConnections[dev.host]; }
|
|
|
|
// Check if the device still exists
|
|
if (isAmtDeviceValid(dev) == false) return; // Device no longer exists, ignore this request.
|
|
|
|
// Check the response
|
|
if ((status == 200) && (responses['AMT_GeneralSettings'] != null) && (responses['IPS_HostBasedSetupService'] != null) && (responses['IPS_HostBasedSetupService'].response != null) && (responses['IPS_HostBasedSetupService'].response != null) && (stack.wsman.comm.digestRealm == responses['AMT_GeneralSettings'].response.DigestRealm)) {
|
|
// Everything looks good
|
|
dev.consoleMsg(stack.wsman.comm.xtls ? "Intel AMT connected with TLS." : "Intel AMT connected.");
|
|
dev.state = 1;
|
|
if (dev.aquired == null) { dev.aquired = {}; }
|
|
dev.aquired.controlMode = responses['IPS_HostBasedSetupService'].response.CurrentControlMode; // 1 = CCM, 2 = ACM
|
|
var verSplit = stack.wsman.comm.amtVersion.split('.');
|
|
if (verSplit.length >= 3) { dev.aquired.version = verSplit[0] + '.' + verSplit[1] + '.' + verSplit[2]; dev.aquired.majorver = parseInt(verSplit[0]); dev.aquired.minorver = parseInt(verSplit[1]); }
|
|
dev.aquired.realm = stack.wsman.comm.digestRealm;
|
|
dev.aquired.user = stack.wsman.comm.user;
|
|
dev.aquired.pass = stack.wsman.comm.pass;
|
|
dev.aquired.lastContact = Date.now();
|
|
if ((dev.connType == 1) || (dev.connType == 3)) { dev.aquired.tls = stack.wsman.comm.xtls; } // Only set the TLS state if in relay or local mode. When using CIRA, this is auto-detected.
|
|
if (stack.wsman.comm.xtls == 1) { dev.aquired.hash = stack.wsman.comm.xtlsCertificate.fingerprint.split(':').join('').toLowerCase(); } else { delete dev.aquired.hash; }
|
|
UpdateDevice(dev);
|
|
|
|
// Perform Intel AMT clock sync
|
|
attemptSyncClock(dev, function () {
|
|
// Check Intel AMT TLS state
|
|
attemptTlsSync(dev, function () {
|
|
// Check Intel AMT root certificate state
|
|
attemptRootCertSync(dev, function () {
|
|
// Check Intel AMT CIRA settings
|
|
attemptCiraSync(dev, function () {
|
|
// See if we need to get hardware inventory
|
|
attemptFetchHardwareInventory(dev, function () {
|
|
dev.consoleMsg('Done.');
|
|
|
|
// Remove from task limiter if needed
|
|
if (dev.taskid != null) { obj.parent.taskLimiter.completed(dev.taskid); delete dev.taskLimiter; }
|
|
|
|
if (dev.connType != 2) {
|
|
// Start power polling if not connected to LMS
|
|
var ppfunc = function powerPoleFunction() { fetchPowerState(powerPoleFunction.dev); }
|
|
ppfunc.dev = dev;
|
|
dev.polltimer = new setTimeout(ppfunc, 290000); // Poll for power state every 4 minutes 50 seconds.
|
|
fetchPowerState(dev);
|
|
} else {
|
|
// For LMS connections, close now.
|
|
dev.controlMsg({ action: 'close' });
|
|
}
|
|
});
|
|
});
|
|
});
|
|
});
|
|
});
|
|
} else {
|
|
// We got a bad response
|
|
if ((dev.conntype == 1) && (dev.tlsfail !== true) && (status == 408)) {
|
|
// TLS error on a local connection, try again without TLS
|
|
dev.tlsfail = true; attemptInitialContact(dev); return;
|
|
} else if (status == 401) {
|
|
// Authentication error, see if we can use alternative credentials
|
|
if ((dev.acctry == null) && (obj.amtAdminAccounts[dev.domainid] != null) && (obj.amtAdminAccounts[dev.domainid].length > 0)) { dev.acctry = 0; attemptInitialContact(dev); return; }
|
|
if ((dev.acctry != null) && (obj.amtAdminAccounts[dev.domainid] != null) && (obj.amtAdminAccounts[dev.domainid].length > (dev.acctry + 1))) { dev.acctry++; attemptInitialContact(dev); return; }
|
|
|
|
// We are unable to authenticate to this device, clear Intel AMT credentials.
|
|
dev.consoleMsg("Unable to connect.");
|
|
ClearDeviceCredentials(dev);
|
|
}
|
|
//console.log(dev.nodeid, dev.name, dev.host, status, 'Bad response');
|
|
removeAmtDevice(dev);
|
|
}
|
|
}
|
|
|
|
|
|
//
|
|
// Intel AMT Database Update
|
|
//
|
|
|
|
// Change the current core information string and event it
|
|
function UpdateDevice(dev) {
|
|
if (isAmtDeviceValid(dev) == false) return; // Device no longer exists, ignore this request.
|
|
|
|
// Check that the mesh exists
|
|
const mesh = parent.webserver.meshes[dev.meshid];
|
|
if (mesh == null) { removeAmtDevice(dev); return false; }
|
|
|
|
// Get the node and change it if needed
|
|
parent.db.Get(dev.nodeid, function (err, nodes) {
|
|
if ((nodes == null) || (nodes.length != 1)) { return false; }
|
|
const device = nodes[0];
|
|
var changes = [], change = 0, log = 0;
|
|
var domain = parent.config.domains[device.domain];
|
|
if (domain == null) { return false; }
|
|
|
|
// Check if anything changes
|
|
if (device.intelamt == null) { device.intelamt = {}; }
|
|
if (dev.aquired.version && (typeof dev.aquired.version == 'string') && (dev.aquired.version != device.intelamt.ver)) { change = 1; log = 1; device.intelamt.ver = dev.aquired.version; changes.push('AMT version'); }
|
|
if (dev.aquired.user && (typeof dev.aquired.user == 'string') && (dev.aquired.user != device.intelamt.user)) { change = 1; log = 1; device.intelamt.user = dev.aquired.user; changes.push('AMT user'); }
|
|
if (dev.aquired.pass && (typeof dev.aquired.pass == 'string') && (dev.aquired.pass != device.intelamt.pass)) { change = 1; log = 1; device.intelamt.pass = dev.aquired.pass; changes.push('AMT pass'); }
|
|
if (dev.aquired.realm && (typeof dev.aquired.realm == 'string') && (dev.aquired.realm != device.intelamt.realm)) { change = 1; log = 1; device.intelamt.realm = dev.aquired.realm; changes.push('AMT realm'); }
|
|
if (dev.aquired.hash && (typeof dev.aquired.hash == 'string') && (dev.aquired.hash != device.intelamt.hash)) { change = 1; log = 1; device.intelamt.hash = dev.aquired.hash; changes.push('AMT hash'); }
|
|
if (dev.aquired.tls && (typeof dev.aquired.tls == 'number') && (dev.aquired.tls != device.intelamt.tls)) { change = 1; log = 1; device.intelamt.tls = dev.aquired.tls; changes.push('AMT TLS'); }
|
|
if (device.intelamt.state != 2) { change = 1; log = 1; device.intelamt.state = 2; changes.push('AMT state'); }
|
|
|
|
// Update Intel AMT flags if needed
|
|
// dev.aquired.controlMode // 1 = CCM, 2 = ACM
|
|
// (node.intelamt.flags & 2) == CCM, (node.intelamt.flags & 4) == ACM
|
|
var flags = 0;
|
|
if (typeof device.intelamt.flags == 'number') { flags = device.intelamt.flags; }
|
|
if (dev.aquired.controlMode == 1) { if ((flags & 4) != 0) { flags -= 4; } if ((flags & 2) == 0) { flags += 2; } } // CCM
|
|
if (dev.aquired.controlMode == 2) { if ((flags & 4) == 0) { flags += 4; } if ((flags & 2) != 0) { flags -= 2; } } // ACM
|
|
if (device.intelamt.flags != flags) { change = 1; log = 1; device.intelamt.flags = flags; changes.push('AMT flags'); }
|
|
|
|
// If there are changes, event the new device
|
|
if (change == 1) {
|
|
// Save to the database
|
|
parent.db.Set(device);
|
|
|
|
// Event the node change
|
|
var event = { etype: 'node', action: 'changenode', nodeid: device._id, domain: domain.id, node: parent.webserver.CloneSafeNode(device) };
|
|
if (changes.length > 0) { event.msg = 'Changed device ' + device.name + ' from group ' + mesh.name + ': ' + changes.join(', '); }
|
|
if ((log == 0) || ((obj.agentInfo) && (obj.agentInfo.capabilities) && (obj.agentInfo.capabilities & 0x20)) || (changes.length == 0)) { event.nolog = 1; } // If this is a temporary device, don't log changes
|
|
if (parent.db.changeStream) { event.noact = 1; } // If DB change stream is active, don't use this event to change the node. Another event will come.
|
|
parent.DispatchEvent(parent.webserver.CreateMeshDispatchTargets(device.meshid, [device._id]), obj, event);
|
|
}
|
|
|
|
});
|
|
}
|
|
|
|
// Change the current core information string and event it
|
|
function ClearDeviceCredentials(dev) {
|
|
if (isAmtDeviceValid(dev) == false) return; // Device no longer exists, ignore this request.
|
|
|
|
// Check that the mesh exists
|
|
const mesh = parent.webserver.meshes[dev.meshid];
|
|
if (mesh == null) { removeAmtDevice(dev); return; }
|
|
|
|
// Get the node and change it if needed
|
|
parent.db.Get(dev.nodeid, function (err, nodes) {
|
|
if ((nodes == null) || (nodes.length != 1)) return;
|
|
const device = nodes[0];
|
|
var changes = [], change = 0, log = 0;
|
|
var domain = parent.config.domains[device.domain];
|
|
if (domain == null) return;
|
|
|
|
// Check if anything changes
|
|
if (device.intelamt == null) return;
|
|
if (device.intelamt.user != null) { change = 1; log = 1; delete device.intelamt.user; changes.push('AMT user'); }
|
|
if (device.intelamt.pass != null) { change = 1; log = 1; delete device.intelamt.pass; changes.push('AMT pass'); }
|
|
|
|
// If there are changes, event the new device
|
|
if (change == 1) {
|
|
// Save to the database
|
|
parent.db.Set(device);
|
|
|
|
// Event the node change
|
|
var event = { etype: 'node', action: 'changenode', nodeid: device._id, domain: domain.id, node: parent.webserver.CloneSafeNode(device) };
|
|
if (changes.length > 0) { event.msg = 'Changed device ' + device.name + ' from group ' + mesh.name + ': ' + changes.join(', '); }
|
|
if ((log == 0) || ((obj.agentInfo) && (obj.agentInfo.capabilities) && (obj.agentInfo.capabilities & 0x20)) || (changes.length == 0)) { event.nolog = 1; } // If this is a temporary device, don't log changes
|
|
if (parent.db.changeStream) { event.noact = 1; } // If DB change stream is active, don't use this event to change the node. Another event will come.
|
|
parent.DispatchEvent(parent.webserver.CreateMeshDispatchTargets(device.meshid, [device._id]), obj, event);
|
|
}
|
|
});
|
|
}
|
|
|
|
|
|
//
|
|
// Intel AMT Power State
|
|
//
|
|
|
|
// Get the current power state of a device
|
|
function fetchPowerState(dev) {
|
|
if (isAmtDeviceValid(dev) == false) return;
|
|
|
|
// Check if the agent is connected
|
|
var constate = parent.GetConnectivityState(dev.nodeid);
|
|
if ((constate == null) || (constate.connectivity & 1)) return; // If there is no connectivity or the agent is connected, skip trying to poll power state.
|
|
|
|
// Fetch the power state
|
|
dev.amtstack.BatchEnum(null, ['CIM_ServiceAvailableToElement'], function (stack, name, responses, status) {
|
|
const dev = stack.dev;
|
|
if (obj.amtDevices[dev.nodeid] == null) return; // Device no longer exists, ignore this response.
|
|
|
|
if ((status != 200) || (responses['CIM_ServiceAvailableToElement'] == null) || (responses['CIM_ServiceAvailableToElement'].responses == null) || (responses['CIM_ServiceAvailableToElement'].responses.length < 1)) return; // If the polling fails, just skip it.
|
|
var powerstate = responses['CIM_ServiceAvailableToElement'].responses[0].PowerState;
|
|
if ((powerstate == 2) && (dev.aquired.majorver > 9)) {
|
|
// Device is powered on and Intel AMT 10+, poll the OS power state.
|
|
dev.amtstack.Get('IPS_PowerManagementService', function (stack, name, response, status) {
|
|
const dev = stack.dev;
|
|
if (obj.amtDevices[dev.nodeid] == null) return; // Device no longer exists, ignore this response.
|
|
if (status != 200) return;
|
|
|
|
// Convert the OS power state
|
|
var meshPowerState = -1;
|
|
if (response.Body.OSPowerSavingState == 2) { meshPowerState = 1; } // Fully powered (S0);
|
|
else if (response.Body.OSPowerSavingState == 3) { meshPowerState = 2; } // Modern standby (We are going to call this S1);
|
|
|
|
// Set OS power state
|
|
if (meshPowerState >= 0) { parent.SetConnectivityState(dev.meshid, dev.nodeid, Date.now(), 4, meshPowerState); }
|
|
});
|
|
} else {
|
|
// Convert the power state
|
|
// AMT power: 1 = Other, 2 = On, 3 = Sleep-Light, 4 = Sleep-Deep, 5 = Power Cycle (Off-Soft), 6 = Off-Hard, 7 = Hibernate (Off-Soft), 8 = Off-Soft, 9 = Power Cycle (Off-Hard), 10 = Master Bus Reset, 11 = Diagnostic Interrupt (NMI), 12 = Off-Soft Graceful, 13 = Off-Hard Graceful, 14 = Master Bus Reset Graceful, 15 = Power Cycle (Off- oft Graceful), 16 = Power Cycle (Off - Hard Graceful), 17 = Diagnostic Interrupt (INIT)
|
|
// Mesh power: 0 = Unknown, 1 = S0 power on, 2 = S1 Sleep, 3 = S2 Sleep, 4 = S3 Sleep, 5 = S4 Hibernate, 6 = S5 Soft-Off, 7 = Present
|
|
var meshPowerState = -1, powerConversionTable = [-1, -1, 1, 2, 3, 6, 6, 5, 6];
|
|
if (powerstate < powerConversionTable.length) { meshPowerState = powerConversionTable[powerstate]; } else { powerstate = 6; }
|
|
|
|
// Set power state
|
|
if (meshPowerState >= 0) { parent.SetConnectivityState(dev.meshid, dev.nodeid, Date.now(), 4, meshPowerState); }
|
|
}
|
|
});
|
|
}
|
|
|
|
// Perform a power action: 2 = Power up, 5 = Power cycle, 8 = Power down, 10 = Reset
|
|
function performPowerAction(nodeid, action) {
|
|
var devices = obj.amtDevices[nodeid];
|
|
if (devices == null) return;
|
|
for (var i in devices) {
|
|
var dev = devices[i];
|
|
if (dev.amtstack != null) {
|
|
// TODO: Check if the device passed initial connection
|
|
try { dev.amtstack.RequestPowerStateChange(action, performPowerActionResponse); } catch (ex) { }
|
|
}
|
|
}
|
|
}
|
|
|
|
// Response to Intel AMT power action
|
|
function performPowerActionResponse(stack, name, responses, status) {
|
|
//console.log('performPowerActionResponse', status);
|
|
}
|
|
|
|
|
|
//
|
|
// Intel AMT Clock Syncronization
|
|
//
|
|
|
|
// Attempt to sync the Intel AMT clock if needed, call func back when done.
|
|
// Care should be take not to have many pending WSMAN called when performing clock sync.
|
|
function attemptSyncClock(dev, func) {
|
|
if (isAmtDeviceValid(dev) == false) return; // Device no longer exists, ignore this request.
|
|
dev.taskCount = 1;
|
|
dev.taskCompleted = func;
|
|
dev.amtstack.AMT_TimeSynchronizationService_GetLowAccuracyTimeSynch(attemptSyncClockEx);
|
|
}
|
|
|
|
// Intel AMT clock query response
|
|
function attemptSyncClockEx(stack, name, response, status) {
|
|
const dev = stack.dev;
|
|
if (isAmtDeviceValid(dev) == false) return; // Device no longer exists, ignore this request.
|
|
if (status != 200) { dev.consoleMsg("Failed to get clock (" + status + ")."); removeAmtDevice(dev); return; }
|
|
|
|
// Compute how much drift between Intel AMT and our clock.
|
|
var t = new Date(), now = new Date();
|
|
t.setTime(response.Body['Ta0'] * 1000);
|
|
if (Math.abs(t - now) > 10000) { // If the Intel AMT clock is more than 10 seconds off, set it.
|
|
dev.consoleMsg("Performing clock sync.");
|
|
var Tm1 = Math.round(now.getTime() / 1000);
|
|
dev.amtstack.AMT_TimeSynchronizationService_SetHighAccuracyTimeSynch(response.Body['Ta0'], Tm1, Tm1, attemptSyncClockSet);
|
|
} else {
|
|
// Clock is fine, we are done.
|
|
dev.consoleMsg("Clock ok.");
|
|
devTaskCompleted(dev)
|
|
}
|
|
}
|
|
|
|
// Intel AMT clock set response
|
|
function attemptSyncClockSet(stack, name, responses, status) {
|
|
const dev = stack.dev;
|
|
if (isAmtDeviceValid(dev) == false) return; // Device no longer exists, ignore this request.
|
|
if (status != 200) { dev.consoleMsg("Failed to sync clock (" + status + ")."); removeAmtDevice(dev); }
|
|
devTaskCompleted(dev)
|
|
}
|
|
|
|
|
|
//
|
|
// Intel AMT TLS setup
|
|
//
|
|
|
|
// Check if Intel AMT TLS state is correct
|
|
function attemptTlsSync(dev, func) {
|
|
if (isAmtDeviceValid(dev) == false) return; // Device no longer exists, ignore this request.
|
|
|
|
// Fetch Intel AMT setup policy
|
|
// mesh.amt.type: 0 = No Policy, 1 = Deactivate CCM, 2 = Manage in CCM, 3 = Manage in ACM
|
|
// mesh.amt.cirasetup: 0 = No Change, 1 = Remove CIRA, 2 = Setup CIRA
|
|
const mesh = parent.webserver.meshes[dev.meshid];
|
|
if (mesh == null) { dev.consoleMsg("Unable to find device group."); removeAmtDevice(dev); return; }
|
|
var amtPolicy = 0, ciraPolicy = 0;
|
|
if (mesh.amt != null) { if (mesh.amt.type) { amtPolicy = mesh.amt.type; } if (mesh.amt.cirasetup) { ciraPolicy = mesh.amt.cirasetup; } }
|
|
if (amtPolicy < 2) { ciraPolicy = 0; }
|
|
dev.policy = { amtPolicy: amtPolicy, ciraPolicy: ciraPolicy }
|
|
|
|
if (amtPolicy < 2) {
|
|
// No policy or deactivation, do nothing.
|
|
dev.consoleMsg("No server policy for Intel AMT");
|
|
func();
|
|
} else {
|
|
// Manage in CCM or ACM
|
|
dev.taskCount = 1;
|
|
dev.taskCompleted = func;
|
|
// TODO: We only deal with certificates starting with Intel AMT 6 and beyond
|
|
dev.amtstack.BatchEnum(null, ['AMT_PublicKeyCertificate', 'AMT_PublicPrivateKeyPair', 'AMT_TLSSettingData', 'AMT_TLSCredentialContext'], attemptTlsSyncEx);
|
|
}
|
|
}
|
|
|
|
function attemptTlsSyncEx(stack, name, responses, status) {
|
|
const dev = stack.dev;
|
|
if (isAmtDeviceValid(dev) == false) return; // Device no longer exists, ignore this request.
|
|
if (status != 200) { dev.consoleMsg("Failed to get security information (" + status + ")."); removeAmtDevice(dev); return; }
|
|
|
|
// Setup the certificates
|
|
dev.policy.certPrivateKeys = responses['AMT_PublicPrivateKeyPair'].responses;
|
|
dev.policy.tlsSettings = responses['AMT_TLSSettingData'].responses;
|
|
dev.policy.tlsCredentialContext = responses['AMT_TLSCredentialContext'].responses;
|
|
var xxCertificates = responses['AMT_PublicKeyCertificate'].responses;
|
|
for (var i in xxCertificates) {
|
|
xxCertificates[i].TrustedRootCertficate = (xxCertificates[i]['TrustedRootCertficate'] == true);
|
|
xxCertificates[i].X509CertificateBin = Buffer.from(xxCertificates[i]['X509Certificate'], 'base64').toString('binary');
|
|
xxCertificates[i].XIssuer = parseCertName(xxCertificates[i]['Issuer']);
|
|
xxCertificates[i].XSubject = parseCertName(xxCertificates[i]['Subject']);
|
|
}
|
|
amtcert_linkCertPrivateKey(xxCertificates, dev.policy.certPrivateKeys);
|
|
dev.policy.certificates = xxCertificates;
|
|
|
|
// Find the current TLS certificate & MeshCentral root certificate
|
|
var xxTlsCurrentCert = null;
|
|
if (dev.policy.tlsCredentialContext.length > 0) {
|
|
var certInstanceId = dev.policy.tlsCredentialContext[0]['ElementInContext']['ReferenceParameters']['SelectorSet']['Selector']['Value'];
|
|
for (var i in dev.policy.certificates) { if (dev.policy.certificates[i]['InstanceID'] == certInstanceId) { xxTlsCurrentCert = i; } }
|
|
}
|
|
|
|
// This is a managed device and TLS is not enabled, turn it on.
|
|
if (xxTlsCurrentCert == null) {
|
|
// Start by generating a key pair
|
|
dev.amtstack.AMT_PublicKeyManagementService_GenerateKeyPair(0, 2048, function (stack, name, responses, status) {
|
|
const dev = stack.dev;
|
|
if (isAmtDeviceValid(dev) == false) return; // Device no longer exists, ignore this request.
|
|
if (status != 200) { dev.consoleMsg("Failed to generate a key pair (" + status + ")."); removeAmtDevice(dev); return; }
|
|
|
|
// Check that we get a key pair reference
|
|
var x = null;
|
|
try { x = responses.Body['KeyPair']['ReferenceParameters']['SelectorSet']['Selector']['Value']; } catch (ex) { }
|
|
if (x == null) { dev.consoleMsg("Unable to get key pair reference."); removeAmtDevice(dev); return; }
|
|
|
|
// Get the new key pair
|
|
dev.amtstack.Enum('AMT_PublicPrivateKeyPair', function (stack, name, responses, status, tag) {
|
|
const dev = stack.dev;
|
|
if (isAmtDeviceValid(dev) == false) return; // Device no longer exists, ignore this request.
|
|
if (status != 200) { dev.consoleMsg("Failed to get a key pair list (" + status + ")."); removeAmtDevice(dev); return; }
|
|
|
|
// Get the new DER key
|
|
var DERKey = null;
|
|
for (var i in responses) { if (responses[i]['InstanceID'] == tag) { DERKey = responses[i]['DERKey']; } }
|
|
|
|
// Get certificate values
|
|
const commonName = 'IntelAMT-' + Buffer.from(parent.crypto.randomBytes(6), 'binary').toString('hex');
|
|
const domain = parent.config.domains[dev.domainid];
|
|
var serverName = 'MeshCentral';
|
|
if ((domain != null) && (domain.title != null)) { serverName = domain.title; }
|
|
const certattributes = { 'CN': commonName, 'O': serverName, 'ST': serverName, 'C': serverName };
|
|
const issuerattributes = { 'CN': obj.rootCertCN };
|
|
const xxCaPrivateKey = obj.parent.certificates.root.key;
|
|
|
|
// Set the extended key usages
|
|
var extKeyUsage = { name: 'extKeyUsage', serverAuth: true, clientAuth: true }
|
|
|
|
// Sign the key pair using the CA certifiate
|
|
const cert = amtcert_createCertificate(certattributes, xxCaPrivateKey, DERKey, issuerattributes, extKeyUsage);
|
|
if (cert == null) { dev.consoleMsg("Failed to sign the TLS certificate."); removeAmtDevice(dev); return; }
|
|
|
|
// Place the resulting signed certificate back into AMT
|
|
var pem = obj.parent.certificateOperations.forge.pki.certificateToPem(cert).replace(/(\r\n|\n|\r)/gm, '');
|
|
|
|
// Set the certificate finderprint (SHA1)
|
|
var md = obj.parent.certificateOperations.forge.md.sha1.create();
|
|
md.update(obj.parent.certificateOperations.forge.asn1.toDer(obj.parent.certificateOperations.forge.pki.certificateToAsn1(cert)).getBytes());
|
|
dev.aquired.xhash = md.digest().toHex();
|
|
|
|
dev.amtstack.AMT_PublicKeyManagementService_AddCertificate(pem.substring(27, pem.length - 25), function (stack, name, responses, status) {
|
|
const dev = stack.dev;
|
|
if (isAmtDeviceValid(dev) == false) return; // Device no longer exists, ignore this request.
|
|
if (status != 200) { dev.consoleMsg("Failed to add TLS certificate (" + status + ")."); removeAmtDevice(dev); return; }
|
|
var certInstanceId = responses.Body['CreatedCertificate']['ReferenceParameters']['SelectorSet']['Selector']['Value'];
|
|
|
|
// Set the TLS certificate
|
|
dev.setTlsSecurityPendingCalls = 3;
|
|
if (dev.policy.tlsCredentialContext.length > 0) {
|
|
// Modify the current context
|
|
var newTLSCredentialContext = Clone(dev.policy.tlsCredentialContext[0]);
|
|
newTLSCredentialContext['ElementInContext']['ReferenceParameters']['SelectorSet']['Selector']['Value'] = certInstanceId;
|
|
dev.amtstack.Put('AMT_TLSCredentialContext', newTLSCredentialContext, amtSwitchToTls, 0, 1);
|
|
} else {
|
|
// Add a new security context
|
|
dev.amtstack.Create('AMT_TLSCredentialContext', {
|
|
'ElementInContext': '<a:Address>/wsman</a:Address><a:ReferenceParameters><w:ResourceURI>' + dev.amtstack.CompleteName('AMT_PublicKeyCertificate') + '</w:ResourceURI><w:SelectorSet><w:Selector Name="InstanceID">' + certInstanceId + '</w:Selector></w:SelectorSet></a:ReferenceParameters>',
|
|
'ElementProvidingContext': '<a:Address>/wsman</a:Address><a:ReferenceParameters><w:ResourceURI>' + dev.amtstack.CompleteName('AMT_TLSProtocolEndpointCollection') + '</w:ResourceURI><w:SelectorSet><w:Selector Name="ElementName">TLSProtocolEndpointInstances Collection</w:Selector></w:SelectorSet></a:ReferenceParameters>'
|
|
}, amtSwitchToTls);
|
|
}
|
|
|
|
// Figure out what index is local & remote
|
|
var localNdx = ((dev.policy.tlsSettings[0]['InstanceID'] == 'Intel(r) AMT LMS TLS Settings')) ? 0 : 1, remoteNdx = (1 - localNdx);
|
|
|
|
// Remote TLS settings
|
|
var xxTlsSettings2 = Clone(dev.policy.tlsSettings);
|
|
xxTlsSettings2[remoteNdx]['Enabled'] = true;
|
|
xxTlsSettings2[remoteNdx]['MutualAuthentication'] = false;
|
|
xxTlsSettings2[remoteNdx]['AcceptNonSecureConnections'] = true;
|
|
delete xxTlsSettings2[remoteNdx]['TrustedCN'];
|
|
|
|
// Local TLS settings
|
|
xxTlsSettings2[localNdx]['Enabled'] = true;
|
|
delete xxTlsSettings2[localNdx]['TrustedCN'];
|
|
|
|
// Update TLS settings
|
|
dev.amtstack.Put('AMT_TLSSettingData', xxTlsSettings2[0], amtSwitchToTls, 0, 1, xxTlsSettings2[0]);
|
|
dev.amtstack.Put('AMT_TLSSettingData', xxTlsSettings2[1], amtSwitchToTls, 0, 1, xxTlsSettings2[1]);
|
|
});
|
|
|
|
}, responses.Body['KeyPair']['ReferenceParameters']['SelectorSet']['Selector']['Value']);
|
|
});
|
|
} else {
|
|
// TLS is setup
|
|
devTaskCompleted(dev);
|
|
}
|
|
}
|
|
|
|
function amtSwitchToTls(stack, name, responses, status) {
|
|
const dev = stack.dev;
|
|
if (isAmtDeviceValid(dev) == false) return; // Device no longer exists, ignore this request.
|
|
if (status != 200) { dev.consoleMsg("Failed setup TLS (" + status + ")."); removeAmtDevice(dev); return; }
|
|
|
|
// Check if all the calls are done & perform a commit
|
|
if ((--dev.setTlsSecurityPendingCalls) == 0) {
|
|
dev.amtstack.AMT_SetupAndConfigurationService_CommitChanges(null, function (stack, name, responses, status) {
|
|
const dev = stack.dev;
|
|
if (isAmtDeviceValid(dev) == false) return; // Device no longer exists, ignore this request.
|
|
if (status != 200) { dev.consoleMsg("Failed perform commit (" + status + ")."); removeAmtDevice(dev); return; }
|
|
dev.consoleMsg("Enabled TLS");
|
|
|
|
// Update device in the database
|
|
dev.aquired.tls = 1;
|
|
dev.aquired.hash = dev.aquired.xhash;
|
|
delete dev.aquired.xhash;
|
|
UpdateDevice(dev);
|
|
|
|
// TODO: Switch our communications to TLS (Restart our management of this node)
|
|
devTaskCompleted(dev);
|
|
});
|
|
}
|
|
}
|
|
|
|
|
|
//
|
|
// Intel AMT Server Root Certificate
|
|
//
|
|
|
|
// Check if Intel AMT has the server root certificate
|
|
function attemptRootCertSync(dev, func) {
|
|
if (isAmtDeviceValid(dev) == false) return; // Device no longer exists, ignore this request.
|
|
if ((dev.connType != 2) || (dev.policy.ciraPolicy != 2)) { func(); return; } // Server root certificate does not need to be present is CIRA is not needed
|
|
|
|
// Find the current TLS certificate & MeshCentral root certificate
|
|
var xxMeshCentralRoot = null;
|
|
if (dev.policy.tlsCredentialContext.length > 0) {
|
|
for (var i in dev.policy.certificates) { if (dev.policy.certificates[i]['X509Certificate'] == obj.rootCertBase64) { xxMeshCentralRoot = i; } }
|
|
}
|
|
|
|
// If the server root certificate is not present and we need to configure CIRA, add it
|
|
if (xxMeshCentralRoot == null) {
|
|
dev.taskCount = 1;
|
|
dev.taskCompleted = func;
|
|
dev.amtstack.AMT_PublicKeyManagementService_AddTrustedRootCertificate(obj.rootCertBase64, function (stack, name, responses, status) {
|
|
const dev = stack.dev;
|
|
if (isAmtDeviceValid(dev) == false) return; // Device no longer exists, ignore this request.
|
|
if (status != 200) { dev.consoleMsg("Failed to add server root certificate (" + status + ")."); removeAmtDevice(dev); return; }
|
|
dev.consoleMsg("Added server root certificate.");
|
|
devTaskCompleted(dev);
|
|
});
|
|
} else { func(); }
|
|
}
|
|
|
|
|
|
//
|
|
// Intel AMT CIRA Setup
|
|
//
|
|
|
|
// Check if Intel AMT has the server root certificate
|
|
function attemptCiraSync(dev, func) {
|
|
if (isAmtDeviceValid(dev) == false) return; // Device no longer exists, ignore this request.
|
|
if ((dev.connType != 2) || ((dev.policy.ciraPolicy != 1) && (dev.policy.ciraPolicy != 2))) { func(); return; } // Only setup CIRA when LMS connection is used and a CIRA policy is enabled.
|
|
|
|
// Get current CIRA settings
|
|
// TODO: We only deal with remote access starting with Intel AMT 6 and beyond
|
|
dev.taskCount = 1;
|
|
dev.taskCompleted = func;
|
|
var requests = ['*AMT_EnvironmentDetectionSettingData', 'AMT_ManagementPresenceRemoteSAP', 'AMT_RemoteAccessCredentialContext', 'AMT_RemoteAccessPolicyAppliesToMPS', 'AMT_RemoteAccessPolicyRule', '*AMT_UserInitiatedConnectionService', 'AMT_MPSUsernamePassword'];
|
|
if (dev.aquired.majorver > 11) { requests.push('*IPS_HTTPProxyService', 'IPS_HTTPProxyAccessPoint'); }
|
|
dev.amtstack.BatchEnum(null, requests, function (stack, name, responses, status) {
|
|
const dev = stack.dev;
|
|
if (isAmtDeviceValid(dev) == false) return; // Device no longer exists, ignore this request.
|
|
//dev.consoleMsg("Added server root certificate.");
|
|
|
|
if ((dev.aquired.majorver > 11) && (status == 400)) {
|
|
// Check if only the HTTP proxy objects failed
|
|
status = 200;
|
|
if (responses['IPS_HTTPProxyAccessPoint'].status == 400) { delete responses['IPS_HTTPProxyAccessPoint']; }
|
|
if (responses['IPS_HTTPProxyService'].status == 400) { delete responses['IPS_HTTPProxyService']; }
|
|
for (var i in responses) { if (responses[i].status != 200) { status = responses[i].status; } }
|
|
}
|
|
if (status != 200) { dev.consoleMsg("Failed get CIRA state (" + status + ")."); removeAmtDevice(dev); return; }
|
|
if ((responses['AMT_UserInitiatedConnectionService'] == null) || (responses['AMT_UserInitiatedConnectionService'].response == null)) { dev.consoleMsg("Invalid CIRA state."); removeAmtDevice(dev); return; }
|
|
|
|
dev.cira = {};
|
|
dev.cira.xxRemoteAccess = responses;
|
|
dev.cira.xxEnvironementDetection = responses['AMT_EnvironmentDetectionSettingData'].response;
|
|
dev.cira.xxEnvironementDetection['DetectionStrings'] = MakeToArray(dev.cira.xxEnvironementDetection['DetectionStrings']);
|
|
dev.cira.xxCiraServers = responses['AMT_ManagementPresenceRemoteSAP'].responses;
|
|
dev.cira.xxUserInitiatedCira = responses['AMT_UserInitiatedConnectionService'].response;
|
|
dev.cira.xxRemoteAccessCredentiaLinks = responses['AMT_RemoteAccessCredentialContext'].responses;
|
|
dev.cira.xxMPSUserPass = responses['AMT_MPSUsernamePassword'].responses;
|
|
|
|
// Set CIRA initiation to BIOS & OS enabled
|
|
if (dev.cira.xxUserInitiatedCira['EnabledState'] != 32771) { // 32768: "Disabled", 32769: "BIOS enabled", 32770: "OS enable", 32771: "BIOS & OS enabled"
|
|
dev.amtstack.AMT_UserInitiatedConnectionService_RequestStateChange(32771, null, function (stack, name, responses, status) { }); // This is not a critical call.
|
|
}
|
|
|
|
// Figure out policies attached to servers. Create a policy type to server table.
|
|
dev.cira.xxPolicies = { 'User': [], 'Alert': [], 'Periodic': [] };
|
|
for (var i in responses['AMT_RemoteAccessPolicyAppliesToMPS'].responses) {
|
|
var policy = responses['AMT_RemoteAccessPolicyAppliesToMPS'].responses[i];
|
|
var server = Clone(getItem(dev.cira.xxCiraServers, 'Name', getItem(policy['ManagedElement']['ReferenceParameters']['SelectorSet']['Selector'], '@Name', 'Name')['Value']));
|
|
server.MpsType = policy['MpsType']; // MpsType was added in Intel AMT 11.6
|
|
var ptype = (getItem(policy['PolicySet']['ReferenceParameters']['SelectorSet']['Selector'], '@Name', 'PolicyRuleName')['Value']).split(' ')[0];
|
|
dev.cira.xxPolicies[ptype].push(server);
|
|
}
|
|
|
|
// Fetch the server's CIRA settings
|
|
dev.cira.mpsPresent = null;
|
|
dev.cira.mpsPolicy = false;
|
|
if (dev.policy.ciraPolicy == 2) {
|
|
dev.cira.meshidx = dev.meshid.split('/')[2].replace(/\@/g, 'X').replace(/\$/g, 'X').substring(0, 16);
|
|
dev.cira.mpsName = parent.webserver.certificates.AmtMpsName;
|
|
var serverNameSplit = dev.cira.mpsName.split('.');
|
|
dev.cira.mpsPort = ((parent.args.mpsaliasport != null) ? parent.args.mpsaliasport : parent.args.mpsport);
|
|
dev.cira.mpsAddressFormat = 201; // 201 = FQDN, 3 = IPv4
|
|
if ((serverNameSplit.length == 4) && (parseInt(serverNameSplit[0]) == serverNameSplit[0]) && (parseInt(serverNameSplit[1]) == serverNameSplit[1]) && (parseInt(serverNameSplit[2]) == serverNameSplit[2]) && (parseInt(serverNameSplit[3]) == serverNameSplit[3])) { dev.cira.mpsAddressFormat = 3; }
|
|
|
|
// Check if our server is already present
|
|
if (dev.cira.xxCiraServers.length > 0) {
|
|
for (var i = 0; i < dev.cira.xxCiraServers.length; i++) {
|
|
var mpsServer = dev.cira.xxCiraServers[i];
|
|
if ((mpsServer.AccessInfo == dev.cira.mpsName) && (mpsServer.Port == dev.cira.mpsPort) && (mpsServer.InfoFormat == dev.cira.mpsAddressFormat)) { dev.cira.mpsPresent = mpsServer['Name']; }
|
|
}
|
|
}
|
|
|
|
// Check if our server is already present
|
|
if (dev.cira.xxPolicies['Periodic'].length > 0) {
|
|
var mpsServer = dev.cira.xxPolicies['Periodic'][0];
|
|
if ((mpsServer.AccessInfo == dev.cira.mpsName) && (mpsServer.Port == dev.cira.mpsPort) && (mpsServer.InfoFormat == dev.cira.mpsAddressFormat)) { dev.cira.mpsPolicy = true; }
|
|
}
|
|
}
|
|
|
|
// Remove all MPS policies that are not ours
|
|
if ((dev.cira.xxPolicies['User Initiated'] != null) && (dev.cira.xxPolicies['User Initiated'].length > 0)) { dev.consoleMsg("Removing CIRA user trigger."); dev.amtstack.Delete('AMT_RemoteAccessPolicyRule', { 'PolicyRuleName': 'User Initiated' }, function (stack, name, responses, status) { }); }
|
|
if ((dev.cira.xxPolicies['Alert'] != null) && (dev.cira.xxPolicies['Alert'].length > 0)) { dev.consoleMsg("Removing CIRA alert trigger."); dev.amtstack.Delete('AMT_RemoteAccessPolicyRule', { 'PolicyRuleName': 'Alert' }, function (stack, name, responses, status) { }); }
|
|
if ((dev.cira.xxPolicies['Periodic'] != null) && (dev.cira.xxPolicies['Periodic'].length > 0) && (dev.cira.mpsPolicy == false)) { dev.consoleMsg("Removing CIRA periodic trigger."); dev.amtstack.Delete('AMT_RemoteAccessPolicyRule', { 'PolicyRuleName': 'Periodic' }, function (stack, name, responses, status) { }); }
|
|
|
|
// Remove all MPS servers that are not ours
|
|
if (dev.cira.xxCiraServers.length > 0) {
|
|
for (var i = 0; i < dev.cira.xxCiraServers.length; i++) {
|
|
var mpsServer = dev.cira.xxCiraServers[i];
|
|
if ((mpsServer.AccessInfo != dev.cira.mpsName) || (mpsServer.Port != dev.cira.mpsPort) || (mpsServer.InfoFormat != dev.cira.mpsAddressFormat)) {
|
|
dev.consoleMsg("Removing MPS server.");
|
|
dev.amtstack.Delete('AMT_ManagementPresenceRemoteSAP', { 'Name': mpsServer['Name'] }, function (stack, name, responses, status) { });
|
|
}
|
|
}
|
|
}
|
|
|
|
// If we need to setup CIRA, start by checking the MPS server
|
|
if (dev.policy.ciraPolicy == 2) { addMpsServer(dev); } else { checkEnvironmentDetection(dev); }
|
|
});
|
|
}
|
|
|
|
function addMpsServer(dev) {
|
|
// Add the MPS server if not present
|
|
if (dev.cira.mpsPresent == null) {
|
|
dev.amtstack.AMT_RemoteAccessService_AddMpServer(dev.cira.mpsName, dev.cira.mpsAddressFormat, dev.cira.mpsPort, 2, null, dev.cira.meshidx, 'P@ssw0rd', dev.cira.mpsName, function (stack, name, response, status) {
|
|
const dev = stack.dev;
|
|
if (isAmtDeviceValid(dev) == false) return; // Device no longer exists, ignore this request.
|
|
if (status != 200) { dev.consoleMsg("Failed to create new MPS server (" + status + ")."); removeAmtDevice(dev); return; }
|
|
dev.cira.mpsPresent = getItem(response.Body.MpServer.ReferenceParameters.SelectorSet.Selector, '@Name', 'Name').Value;
|
|
dev.consoleMsg("Created new MPS server.");
|
|
addMpsPolicy(dev);
|
|
});
|
|
} else {
|
|
// MPS server is present, check MPS trigger policy
|
|
addMpsPolicy(dev);
|
|
}
|
|
}
|
|
|
|
function addMpsPolicy(dev) {
|
|
if (dev.cira.mpsPolicy == false) {
|
|
var cilaSupport = ((dev.aquired.majorver > 11) || ((dev.aquired.majorver == 11) && (dev.aquired.minorver >= 6)));
|
|
var trigger = 2; // 1 = Alert, 2 = Periodic
|
|
|
|
// Setup extended data
|
|
var extendedData = null;
|
|
if (trigger == 2) {
|
|
var timertype = 0; // 0 = Periodic, 1 = Time of day
|
|
var exdata = IntToStr(10); // Interval trigger, 10 seconds
|
|
extendedData = Buffer.from(IntToStr(timertype) + exdata, 'binary').toString('base64');
|
|
}
|
|
|
|
// Create the MPS server references
|
|
var server1 = '<Address xmlns="http://schemas.xmlsoap.org/ws/2004/08/addressing">http://schemas.xmlsoap.org/ws/2004/08/addressing/role/anonymous</Address><ReferenceParameters xmlns="http://schemas.xmlsoap.org/ws/2004/08/addressing"><ResourceURI xmlns="http://schemas.dmtf.org/wbem/wsman/1/wsman.xsd">http://intel.com/wbem/wscim/1/amt-schema/1/AMT_ManagementPresenceRemoteSAP</ResourceURI><SelectorSet xmlns="http://schemas.dmtf.org/wbem/wsman/1/wsman.xsd"><Selector Name="Name">' + dev.cira.mpsPresent + '</Selector></SelectorSet></ReferenceParameters>';
|
|
var server2 = null;
|
|
|
|
// Put the CIRA/CILA servers in the right bins.
|
|
var ciraServers = [], cilaServers = [];
|
|
if (server1) { ciraServers.push(server1); if (server2) { ciraServers.push(server2); } }
|
|
|
|
// Go ahead and create the new CIRA/CILA policy.
|
|
dev.amtstack.AMT_RemoteAccessService_AddRemoteAccessPolicyRule(trigger, 0, extendedData, ciraServers, cilaServers, function (stack, name, responses, status) {
|
|
const dev = stack.dev;
|
|
if (isAmtDeviceValid(dev) == false) return; // Device no longer exists, ignore this request.
|
|
if (status != 200) { dev.consoleMsg("Failed to create new MPS policy (" + status + ")."); removeAmtDevice(dev); return; }
|
|
dev.consoleMsg("Created new MPS policy.");
|
|
checkEnvironmentDetection(dev);
|
|
});
|
|
} else {
|
|
checkEnvironmentDetection(dev);
|
|
}
|
|
}
|
|
|
|
function checkEnvironmentDetection(dev) {
|
|
var changes = false;
|
|
var editEnvironmentDetectionTmp = [];
|
|
var domains = dev.cira.xxEnvironementDetection['DetectionStrings'];
|
|
if (domains == null) { domains = []; }
|
|
|
|
if (dev.policy.ciraPolicy == 2) {
|
|
// Check that we have a random environment detection
|
|
if (domains.length == 0) { editEnvironmentDetectionTmp = [ Buffer.from(parent.crypto.randomBytes(6), 'binary').toString('hex') ]; changes = true; }
|
|
} else if (dev.policy.ciraPolicy == 1) {
|
|
// Check environment detection is clear
|
|
if (domains.length != 0) { editEnvironmentDetectionTmp = []; changes = true; }
|
|
}
|
|
|
|
if (changes == true) {
|
|
var t = Clone(dev.cira.xxEnvironementDetection);
|
|
t['DetectionStrings'] = editEnvironmentDetectionTmp;
|
|
dev.cira.envclear = (editEnvironmentDetectionTmp.length == 0);
|
|
dev.amtstack.Put('AMT_EnvironmentDetectionSettingData', t, function (stack, name, responses, status) {
|
|
const dev = stack.dev;
|
|
if (isAmtDeviceValid(dev) == false) return; // Device no longer exists, ignore this request.
|
|
if (status != 200) { dev.consoleMsg("Failed to set environement detection (" + status + ")."); removeAmtDevice(dev); return; }
|
|
if (dev.cira.envclear) { dev.consoleMsg("Environment detection cleared."); } else { dev.consoleMsg("Environment detection set."); }
|
|
devTaskCompleted(dev);
|
|
}, 0, 1);
|
|
} else {
|
|
devTaskCompleted(dev);
|
|
}
|
|
}
|
|
|
|
//
|
|
// Intel AMT Hardware Inventory and Networking
|
|
//
|
|
|
|
function attemptFetchHardwareInventory(dev, func) {
|
|
if (isAmtDeviceValid(dev) == false) return; // Device no longer exists, ignore this request.
|
|
const mesh = parent.webserver.meshes[dev.meshid];
|
|
if (mesh == null) { removeAmtDevice(dev); return; }
|
|
if (mesh.mtype == 1) { // If this is a Intel AMT only device group, pull the hardware inventory and network information for this device
|
|
dev.consoleMsg("Fetching hardware inventory.");
|
|
dev.taskCount = 2;
|
|
dev.taskCompleted = func;
|
|
dev.amtstack.BatchEnum('', ['*CIM_ComputerSystemPackage', 'CIM_SystemPackaging', '*CIM_Chassis', 'CIM_Chip', '*CIM_Card', '*CIM_BIOSElement', 'CIM_Processor', 'CIM_PhysicalMemory', 'CIM_MediaAccessDevice', 'CIM_PhysicalPackage'], attemptFetchHardwareInventoryResponse);
|
|
dev.amtstack.BatchEnum('', ['AMT_EthernetPortSettings'], attemptFetchNetworkResponse);
|
|
} else {
|
|
if (func) { func(); }
|
|
}
|
|
}
|
|
|
|
function attemptFetchNetworkResponse(stack, name, responses, status) {
|
|
const dev = stack.dev;
|
|
if (isAmtDeviceValid(dev) == false) return; // Device no longer exists, ignore this request.
|
|
if (status != 200) { devTaskCompleted(dev); return; }
|
|
|
|
//console.log(JSON.stringify(responses, null, 2));
|
|
if ((responses['AMT_EthernetPortSettings'] == null) || (responses['AMT_EthernetPortSettings'].responses == null)) { devTaskCompleted(dev); return; }
|
|
|
|
// Find the wired and wireless interfaces
|
|
var wired = null, wireless = null;
|
|
for (var i in responses['AMT_EthernetPortSettings'].responses) {
|
|
var netif = responses['AMT_EthernetPortSettings'].responses[i];
|
|
if ((netif.MACAddress != null) && (netif.MACAddress != '00-00-00-00-00-00')) {
|
|
if (netif.WLANLinkProtectionLevel != null) { wireless = netif; } else { wired = netif; }
|
|
}
|
|
}
|
|
if ((wired == null) && (wireless == null)) { devTaskCompleted(dev); return; }
|
|
|
|
// Sent by the agent to update agent network interface information
|
|
var net = { netif2: {} };
|
|
|
|
if (wired != null) {
|
|
var x = {};
|
|
x.family = 'IPv4';
|
|
x.type = 'ethernet';
|
|
x.address = wired.IPAddress;
|
|
x.netmask = wired.SubnetMask;
|
|
x.mac = wired.MACAddress.split('-').join(':').toUpperCase();
|
|
x.gateway = wired.DefaultGateway;
|
|
net.netif2['Ethernet'] = [ x ];
|
|
}
|
|
|
|
if (wireless != null) {
|
|
var x = {};
|
|
x.family = 'IPv4';
|
|
x.type = 'wireless';
|
|
x.address = wireless.IPAddress;
|
|
x.netmask = wireless.SubnetMask;
|
|
x.mac = wireless.MACAddress.split('-').join(':').toUpperCase();
|
|
x.gateway = wireless.DefaultGateway;
|
|
net.netif2['Wireless'] = [ x ];
|
|
}
|
|
|
|
net.updateTime = Date.now();
|
|
net._id = 'if' + dev.nodeid;
|
|
net.type = 'ifinfo';
|
|
parent.db.Set(net);
|
|
|
|
// Event the node interface information change
|
|
parent.DispatchEvent(parent.webserver.CreateMeshDispatchTargets(dev.meshid, [dev.nodeid]), obj, { action: 'ifchange', nodeid: dev.nodeid, domain: dev.nodeid.split('/')[1], nolog: 1 });
|
|
|
|
devTaskCompleted(dev);
|
|
}
|
|
|
|
|
|
/*
|
|
// http://www.dmtf.org/sites/default/files/standards/documents/DSP0134_2.7.1.pdf
|
|
const DMTFCPUStatus = ["Unknown", "Enabled", "Disabled by User", "Disabled By BIOS (POST Error)", "Idle", "Other"];
|
|
const DMTFMemType = ["Unknown", "Other", "DRAM", "Synchronous DRAM", "Cache DRAM", "EDO", "EDRAM", "VRAM", "SRAM", "RAM", "ROM", "Flash", "EEPROM", "FEPROM", "EPROM", "CDRAM", "3DRAM", "SDRAM", "SGRAM", "RDRAM", "DDR", "DDR-2", "BRAM", "FB-DIMM", "DDR3", "FBD2", "DDR4", "LPDDR", "LPDDR2", "LPDDR3", "LPDDR4"];
|
|
const DMTFMemFormFactor = ['', "Other", "Unknown", "SIMM", "SIP", "Chip", "DIP", "ZIP", "Proprietary Card", "DIMM", "TSOP", "Row of chips", "RIMM", "SODIMM", "SRIMM", "FB-DIM"];
|
|
const DMTFProcFamilly = { // Page 46 of DMTF document
|
|
191: "Intel® Core™ 2 Duo Processor",
|
|
192: "Intel® Core™ 2 Solo processor",
|
|
193: "Intel® Core™ 2 Extreme processor",
|
|
194: "Intel® Core™ 2 Quad processor",
|
|
195: "Intel® Core™ 2 Extreme mobile processor",
|
|
196: "Intel® Core™ 2 Duo mobile processor",
|
|
197: "Intel® Core™ 2 Solo mobile processor",
|
|
198: "Intel® Core™ i7 processor",
|
|
199: "Dual-Core Intel® Celeron® processor"
|
|
};
|
|
*/
|
|
|
|
function attemptFetchHardwareInventoryResponse(stack, name, responses, status) {
|
|
const dev = stack.dev;
|
|
if (isAmtDeviceValid(dev) == false) return; // Device no longer exists, ignore this request.
|
|
if (status != 200) { devTaskCompleted(dev); return; }
|
|
|
|
// Extract basic data
|
|
var hw = {}
|
|
hw.PlatformGUID = responses['CIM_ComputerSystemPackage'].response.PlatformGUID;
|
|
hw.Chassis = responses['CIM_Chassis'].response;
|
|
hw.Chips = responses['CIM_Chip'].responses;
|
|
hw.Card = responses['CIM_Card'].response;
|
|
hw.Bios = responses['CIM_BIOSElement'].response;
|
|
hw.Processors = responses['CIM_Processor'].responses;
|
|
hw.PhysicalMemory = responses['CIM_PhysicalMemory'].responses;
|
|
hw.MediaAccessDevice = responses['CIM_MediaAccessDevice'].responses;
|
|
hw.PhysicalPackage = responses['CIM_PhysicalPackage'].responses;
|
|
|
|
// Convert the hardware data into the same structure as we get from Windows
|
|
var hw2 = { hardware: { windows: {}, identifiers: {} } };
|
|
hw2.hardware.identifiers.product_uuid = guidToStr(hw.PlatformGUID);
|
|
if ((hw.PhysicalMemory != null) && (hw.PhysicalMemory.length > 0)) {
|
|
var memory = [];
|
|
for (var i in hw.PhysicalMemory) {
|
|
var m2 = {}, m = hw.PhysicalMemory[i];
|
|
m2.BankLabel = m.BankLabel;
|
|
m2.Capacity = m.Capacity;
|
|
if (m.PartNumber) { m2.PartNumber = m.PartNumber.trim(); }
|
|
if (typeof m.SerialNumber == 'string') { m2.SerialNumber = m.SerialNumber.trim(); }
|
|
if (typeof m.SerialNumber == 'number') { m2.SerialNumber = m.SerialNumber; }
|
|
if (typeof m.Manufacturer == 'string') { m2.Manufacturer = m.Manufacturer.trim(); }
|
|
if (typeof m.Manufacturer == 'number') { m2.Manufacturer = m.Manufacturer; }
|
|
memory.push(m2);
|
|
}
|
|
hw2.hardware.windows.memory = memory;
|
|
}
|
|
if ((hw.MediaAccessDevice != null) && (hw.MediaAccessDevice.length > 0)) {
|
|
var drives = [];
|
|
for (var i in hw.MediaAccessDevice) {
|
|
var m2 = {}, m = hw.MediaAccessDevice[i];
|
|
m2.Caption = m.DeviceID;
|
|
if (m.MaxMediaSize) { m2.Size = (m.MaxMediaSize * 1000); }
|
|
drives.push(m2);
|
|
}
|
|
hw2.hardware.identifiers.storage_devices = drives;
|
|
}
|
|
if (hw.Bios != null) {
|
|
if (hw.Bios.Manufacturer) { hw2.hardware.identifiers.bios_vendor = hw.Bios.Manufacturer.trim(); }
|
|
hw2.hardware.identifiers.bios_version = hw.Bios.Version;
|
|
if (hw.Bios.ReleaseDate && hw.Bios.ReleaseDate.Datetime) { hw2.hardware.identifiers.bios_date = hw.Bios.ReleaseDate.Datetime; }
|
|
}
|
|
if (hw.PhysicalPackage != null) {
|
|
if (hw.Card.Model) { hw2.hardware.identifiers.board_name = hw.Card.Model.trim(); }
|
|
if (hw.Card.Manufacturer) { hw2.hardware.identifiers.board_vendor = hw.Card.Manufacturer.trim(); }
|
|
if (hw.Card.Version) { hw2.hardware.identifiers.board_version = hw.Card.Version.trim(); }
|
|
if (hw.Card.SerialNumber) { hw2.hardware.identifiers.board_serial = hw.Card.SerialNumber.trim(); }
|
|
}
|
|
if ((hw.Chips != null) && (hw.Chips.length > 0)) {
|
|
for (var i in hw.Chips) {
|
|
if ((hw.Chips[i].ElementName == 'Managed System Processor Chip') && (hw.Chips[i].Version)) {
|
|
hw2.hardware.identifiers.cpu_name = hw.Chips[i].Version;
|
|
}
|
|
}
|
|
}
|
|
|
|
// Compute the hash of the document
|
|
hw2.hash = parent.crypto.createHash('sha384').update(JSON.stringify(hw2)).digest().toString('hex');
|
|
|
|
// Fetch system information
|
|
parent.db.GetHash('si' + dev.nodeid, function (err, results) {
|
|
var sysinfohash = null;
|
|
if ((results != null) && (results.length == 1)) { sysinfohash = results[0].hash; }
|
|
if (sysinfohash != hw2.hash) {
|
|
// Hardware information has changed, update the database
|
|
hw2._id = 'si' + dev.nodeid;
|
|
hw2.domain = dev.nodeid.split('/')[1];
|
|
hw2.time = Date.now();
|
|
hw2.type = 'sysinfo';
|
|
parent.db.Set(hw2);
|
|
|
|
// Event the new sysinfo hash, this will notify everyone that the sysinfo document was changed
|
|
var event = { etype: 'node', action: 'sysinfohash', nodeid: dev.nodeid, domain: hw2.domain, hash: hw2.hash, nolog: 1 };
|
|
parent.DispatchEvent(parent.webserver.CreateMeshDispatchTargets(dev.meshid, [dev.nodeid]), obj, event);
|
|
}
|
|
});
|
|
|
|
devTaskCompleted(dev);
|
|
}
|
|
|
|
|
|
//
|
|
// Intel AMT Activation
|
|
//
|
|
|
|
function activateIntelAmt(dev) {
|
|
// Find the Intel AMT policy
|
|
const mesh = parent.webserver.meshes[dev.meshid];
|
|
if (mesh == null) { dev.consoleMsg("Unable to find device group."); removeAmtDevice(dev); return; }
|
|
var amtPolicy = 0; // 0 = Do nothing, 1 = Deactivate CCM, 2 = CCM, 3 = ACM
|
|
if (mesh.amt != null) { if (mesh.amt.type) { amtPolicy = mesh.amt.type; } }
|
|
if ((typeof dev.mpsConnection.tag.meiState.OsAdmin != 'object') || (typeof dev.mpsConnection.tag.meiState.OsAdmin.user != 'string') || (typeof dev.mpsConnection.tag.meiState.OsAdmin.pass != 'string')) { amtPolicy = 0; }
|
|
if (amtPolicy == 0) { removeAmtDevice(dev); return; } // Do nothing, we should not have gotten this CIRA-LMS connection.
|
|
if (amtPolicy == 2) { activateIntelAmtCcm(dev, mesh.amt.password); }
|
|
}
|
|
|
|
function activateIntelAmtCcm(dev, password) {
|
|
console.log('Intel AMT CCM Activation Required: ' + dev.name, dev.nodeid);
|
|
if ((password == null) || (password == '')) { password = getRandomAmtPassword(); }
|
|
dev.temp = { pass: password };
|
|
|
|
// Setup the WSMAN stack, no TLS
|
|
var comm = CreateWsmanComm(dev.nodeid, 16992, dev.mpsConnection.tag.meiState.OsAdmin.user, dev.mpsConnection.tag.meiState.OsAdmin.pass, 0, null, dev.mpsConnection); // No TLS
|
|
var wsstack = WsmanStackCreateService(comm);
|
|
dev.amtstack = AmtStackCreateService(wsstack);
|
|
dev.amtstack.dev = dev;
|
|
dev.amtstack.BatchEnum(null, ['*AMT_GeneralSettings', '*IPS_HostBasedSetupService'], activateIntelAmtCcmEx1);
|
|
}
|
|
|
|
function activateIntelAmtCcmEx1(stack, name, responses, status) {
|
|
const dev = stack.dev;
|
|
if (isAmtDeviceValid(dev) == false) return; // Device no longer exists, ignore this request.
|
|
if (status != 200) { dev.consoleMsg("Failed to get Intel AMT state."); removeAmtDevice(dev); return; }
|
|
if (responses['IPS_HostBasedSetupService'].response['AllowedControlModes'].length != 2) { dev.consoleMsg("Client control mode activation not allowed."); removeAmtDevice(dev); return; }
|
|
dev.amtstack.IPS_HostBasedSetupService_Setup(2, hex_md5('admin:' + responses['AMT_GeneralSettings'].response['DigestRealm'] + ':' + dev.temp.pass).substring(0, 32), null, null, null, null, activateIntelAmtCcmEx2);
|
|
}
|
|
|
|
function activateIntelAmtCcmEx2(stack, name, responses, status) {
|
|
const dev = stack.dev;
|
|
if (isAmtDeviceValid(dev) == false) return; // Device no longer exists, ignore this request.
|
|
if (status != 200) { dev.consoleMsg("Failed to activate Intel AMT to CCM."); removeAmtDevice(dev); return; }
|
|
obj.parent.mpsserver.SendJsonControl(dev.mpsConnection, { action: 'mestate' }); // Request an MEI state refresh
|
|
|
|
// Update the device
|
|
dev.aquired = {};
|
|
dev.aquired.controlMode = 1; // 1 = CCM, 2 = ACM
|
|
var verSplit = dev.amtstack.wsman.comm.amtVersion.split('.');
|
|
if (verSplit.length >= 3) { dev.aquired.version = verSplit[0] + '.' + verSplit[1] + '.' + verSplit[2]; dev.aquired.majorver = parseInt(verSplit[0]); dev.aquired.minorver = parseInt(verSplit[1]); }
|
|
dev.aquired.realm = dev.amtstack.wsman.comm.digestRealm;
|
|
dev.aquired.user = 'admin';
|
|
dev.aquired.pass = dev.temp.pass;
|
|
dev.aquired.lastContact = Date.now();
|
|
dev.aquired.tls = 0;
|
|
UpdateDevice(dev);
|
|
|
|
// Success, switch to managing this device
|
|
dev.consoleMsg("Succesfully activated Intel AMT in CCM mode.");
|
|
|
|
// Wait 8 seconds before attempting to manage this device in CCM
|
|
var f = function doManage() { if (isAmtDeviceValid(dev)) { attemptInitialContact(doManage.dev); } }
|
|
f.dev = dev;
|
|
setTimeout(f, 8000);
|
|
}
|
|
|
|
//
|
|
// General Methods
|
|
//
|
|
|
|
// Called this when a task is completed, when all tasks are completed the call back function will be called.
|
|
function devTaskCompleted(dev) {
|
|
dev.taskCount--;
|
|
if (dev.taskCount == 0) { var f = dev.taskCompleted; delete dev.taskCount; delete dev.taskCompleted; if (f != null) { f(); } }
|
|
}
|
|
|
|
function guidToStr(g) { return g.substring(6, 8) + g.substring(4, 6) + g.substring(2, 4) + g.substring(0, 2) + '-' + g.substring(10, 12) + g.substring(8, 10) + '-' + g.substring(14, 16) + g.substring(12, 14) + '-' + g.substring(16, 20) + '-' + g.substring(20); }
|
|
|
|
// Check which key pair matches the public key in the certificate
|
|
function amtcert_linkCertPrivateKey(certs, keys) {
|
|
for (var i in certs) {
|
|
var cert = certs[i];
|
|
try {
|
|
if (keys.length == 0) return;
|
|
var b = obj.parent.certificateOperations.forge.asn1.fromDer(cert.X509CertificateBin);
|
|
var a = obj.parent.certificateOperations.forge.pki.certificateFromAsn1(b).publicKey;
|
|
var publicKeyPEM = obj.parent.certificateOperations.forge.pki.publicKeyToPem(a).substring(28 + 32).replace(/(\r\n|\n|\r)/gm, "");
|
|
for (var j = 0; j < keys.length; j++) {
|
|
if (publicKeyPEM === (keys[j]['DERKey'] + '-----END PUBLIC KEY-----')) {
|
|
keys[j].XCert = cert; // Link the key pair to the certificate
|
|
cert.XPrivateKey = keys[j]; // Link the certificate to the key pair
|
|
}
|
|
}
|
|
} catch (e) { console.log(e); }
|
|
}
|
|
}
|
|
|
|
// Generate a random Intel AMT password
|
|
function checkAmtPassword(p) { return (p.length > 7) && (/\d/.test(p)) && (/[a-z]/.test(p)) && (/[A-Z]/.test(p)) && (/\W/.test(p)); }
|
|
function getRandomAmtPassword() { var p; do { p = Buffer.from(obj.crypto.randomBytes(9), 'binary').toString('base64').split('/').join('@'); } while (checkAmtPassword(p) == false); return p; }
|
|
function getRandomPassword() { return Buffer.from(obj.crypto.randomBytes(9), 'binary').toString('base64').split('/').join('@'); }
|
|
function getRandomLowerCase(len) { var r = '', random = obj.crypto.randomBytes(len); for (var i = 0; i < len; i++) { r += String.fromCharCode(97 + (random[i] % 26)); } return r; }
|
|
|
|
function hex_md5(str) { return obj.parent.crypto.createHash('md5').update(str).digest('hex'); }
|
|
function Clone(v) { return JSON.parse(JSON.stringify(v)); }
|
|
function MakeToArray(v) { if (!v || v == null || typeof v == 'object') return v; return [v]; }
|
|
function getItem(x, y, z) { for (var i in x) { if (x[i][y] == z) return x[i]; } return null; }
|
|
function IntToStr(v) { return String.fromCharCode((v >> 24) & 0xFF, (v >> 16) & 0xFF, (v >> 8) & 0xFF, v & 0xFF); }
|
|
|
|
function parseCertName(x) {
|
|
var j, r = {}, xx = x.split(',');
|
|
for (var i in xx) { j = xx[i].indexOf('='); r[xx[i].substring(0, j)] = xx[i].substring(j + 1); }
|
|
return r;
|
|
}
|
|
|
|
/*
|
|
function amtcert_signWithCaKey(DERKey, caPrivateKey, certAttributes, issuerAttributes, extKeyUsage) {
|
|
return amtcert_createCertificate(certAttributes, caPrivateKey, DERKey, issuerAttributes, extKeyUsage);
|
|
}
|
|
*/
|
|
|
|
// --- Extended Key Usage OID's ---
|
|
// 1.3.6.1.5.5.7.3.1 = TLS Server certificate
|
|
// 1.3.6.1.5.5.7.3.2 = TLS Client certificate
|
|
// 2.16.840.1.113741.1.2.1 = Intel AMT Remote Console
|
|
// 2.16.840.1.113741.1.2.2 = Intel AMT Local Console
|
|
// 2.16.840.1.113741.1.2.3 = Intel AMT Client Setup Certificate (Zero-Touch)
|
|
|
|
// Generate a certificate with a set of attributes signed by a rootCert. If the rootCert is obmitted, the generated certificate is self-signed.
|
|
function amtcert_createCertificate(certAttributes, caPrivateKey, DERKey, issuerAttributes, extKeyUsage) {
|
|
// Generate a keypair and create an X.509v3 certificate
|
|
var keys, cert = obj.parent.certificateOperations.forge.pki.createCertificate();
|
|
cert.publicKey = obj.parent.certificateOperations.forge.pki.publicKeyFromPem('-----BEGIN PUBLIC KEY-----' + DERKey + '-----END PUBLIC KEY-----');
|
|
cert.serialNumber = '' + Math.floor((Math.random() * 100000) + 1);
|
|
cert.validity.notBefore = new Date(2018, 0, 1);
|
|
//cert.validity.notBefore.setFullYear(cert.validity.notBefore.getFullYear() - 1); // Create a certificate that is valid one year before, to make sure out-of-sync clocks don't reject this cert.
|
|
cert.validity.notAfter = new Date(2049, 11, 31);
|
|
//cert.validity.notAfter.setFullYear(cert.validity.notAfter.getFullYear() + 20);
|
|
var attrs = [];
|
|
if (certAttributes['CN']) attrs.push({ name: 'commonName', value: certAttributes['CN'] });
|
|
if (certAttributes['C']) attrs.push({ name: 'countryName', value: certAttributes['C'] });
|
|
if (certAttributes['ST']) attrs.push({ shortName: 'ST', value: certAttributes['ST'] });
|
|
if (certAttributes['O']) attrs.push({ name: 'organizationName', value: certAttributes['O'] });
|
|
cert.setSubject(attrs);
|
|
|
|
// Use root attributes
|
|
var rootattrs = [];
|
|
if (issuerAttributes['CN']) rootattrs.push({ name: 'commonName', value: issuerAttributes['CN'] });
|
|
if (issuerAttributes['C']) rootattrs.push({ name: 'countryName', value: issuerAttributes['C'] });
|
|
if (issuerAttributes['ST']) rootattrs.push({ shortName: 'ST', value: issuerAttributes['ST'] });
|
|
if (issuerAttributes['O']) rootattrs.push({ name: 'organizationName', value: issuerAttributes['O'] });
|
|
cert.setIssuer(rootattrs);
|
|
|
|
if (extKeyUsage == null) { extKeyUsage = { name: 'extKeyUsage', serverAuth: true, } } else { extKeyUsage.name = 'extKeyUsage'; }
|
|
|
|
/*
|
|
{
|
|
name: 'extKeyUsage',
|
|
serverAuth: true,
|
|
clientAuth: true,
|
|
codeSigning: true,
|
|
emailProtection: true,
|
|
timeStamping: true,
|
|
'2.16.840.1.113741.1.2.1': true
|
|
}
|
|
*/
|
|
|
|
// Create a leaf certificate
|
|
cert.setExtensions([{
|
|
name: 'basicConstraints'
|
|
}, {
|
|
name: 'keyUsage',
|
|
keyCertSign: true,
|
|
digitalSignature: true,
|
|
nonRepudiation: true,
|
|
keyEncipherment: true,
|
|
dataEncipherment: true
|
|
}, extKeyUsage, {
|
|
name: 'nsCertType',
|
|
client: true,
|
|
server: true,
|
|
email: true,
|
|
objsign: true,
|
|
}, {
|
|
name: 'subjectKeyIdentifier'
|
|
}]);
|
|
|
|
// Self-sign certificate
|
|
var privatekey = obj.parent.certificateOperations.forge.pki.privateKeyFromPem(caPrivateKey);
|
|
cert.sign(privatekey, obj.parent.certificateOperations.forge.md.sha256.create());
|
|
return cert;
|
|
}
|
|
|
|
return obj;
|
|
};
|