n8n-nodes-resolve-mac-address 0.1.0 → 0.2.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md
CHANGED
|
@@ -10,3 +10,5 @@ Resolve a local-network hostname or IPv4 address to a MAC address from n8n.
|
|
|
10
10
|
- **Not Found Behavior**: Choose whether missing MAC addresses throw an error or return a `notFound` status.
|
|
11
11
|
|
|
12
12
|
This node depends on the operating system neighbor table. It works for hosts visible on the same local network segment and doesn't resolve MAC addresses across routers.
|
|
13
|
+
|
|
14
|
+
When the target IP matches one of the n8n container's IPv4 interfaces, the output also includes network details: interface name, interface address, netmask, prefix length, network address, and broadcast address.
|
|
@@ -4,8 +4,59 @@ exports.ResolveMacAddress = void 0;
|
|
|
4
4
|
const node_child_process_1 = require("node:child_process");
|
|
5
5
|
const promises_1 = require("node:dns/promises");
|
|
6
6
|
const node_net_1 = require("node:net");
|
|
7
|
+
const node_os_1 = require("node:os");
|
|
7
8
|
const n8n_workflow_1 = require("n8n-workflow");
|
|
8
9
|
const macAddressPattern = /\b(?:[0-9a-f]{2}[:-]){5}[0-9a-f]{2}\b/i;
|
|
10
|
+
function ipv4ToNumber(ipAddress) {
|
|
11
|
+
return ipAddress
|
|
12
|
+
.split('.')
|
|
13
|
+
.reduce((value, octet) => (value << 8) + Number(octet), 0) >>> 0;
|
|
14
|
+
}
|
|
15
|
+
function numberToIpv4(value) {
|
|
16
|
+
return [
|
|
17
|
+
(value >>> 24) & 255,
|
|
18
|
+
(value >>> 16) & 255,
|
|
19
|
+
(value >>> 8) & 255,
|
|
20
|
+
value & 255,
|
|
21
|
+
].join('.');
|
|
22
|
+
}
|
|
23
|
+
function prefixLengthFromNetmask(netmask) {
|
|
24
|
+
const netmaskNumber = ipv4ToNumber(netmask);
|
|
25
|
+
let prefixLength = 0;
|
|
26
|
+
for (let bit = 31; bit >= 0; bit -= 1) {
|
|
27
|
+
if ((netmaskNumber & (1 << bit)) === 0) {
|
|
28
|
+
break;
|
|
29
|
+
}
|
|
30
|
+
prefixLength += 1;
|
|
31
|
+
}
|
|
32
|
+
return prefixLength;
|
|
33
|
+
}
|
|
34
|
+
function getNetworkDetails(ipAddress) {
|
|
35
|
+
const targetAddress = ipv4ToNumber(ipAddress);
|
|
36
|
+
for (const [interfaceName, addresses] of Object.entries((0, node_os_1.networkInterfaces)())) {
|
|
37
|
+
for (const address of addresses ?? []) {
|
|
38
|
+
if (address.family !== 'IPv4' || address.internal) {
|
|
39
|
+
continue;
|
|
40
|
+
}
|
|
41
|
+
const interfaceAddress = ipv4ToNumber(address.address);
|
|
42
|
+
const netmask = ipv4ToNumber(address.netmask);
|
|
43
|
+
const networkAddress = interfaceAddress & netmask;
|
|
44
|
+
if ((targetAddress & netmask) !== networkAddress) {
|
|
45
|
+
continue;
|
|
46
|
+
}
|
|
47
|
+
const broadcastAddress = networkAddress | (~netmask >>> 0);
|
|
48
|
+
return {
|
|
49
|
+
interfaceName,
|
|
50
|
+
interfaceAddress: address.address,
|
|
51
|
+
netmask: address.netmask,
|
|
52
|
+
prefixLength: prefixLengthFromNetmask(address.netmask),
|
|
53
|
+
networkAddress: numberToIpv4(networkAddress),
|
|
54
|
+
broadcastAddress: numberToIpv4(broadcastAddress),
|
|
55
|
+
};
|
|
56
|
+
}
|
|
57
|
+
}
|
|
58
|
+
return undefined;
|
|
59
|
+
}
|
|
9
60
|
function normalizeMacAddress(macAddress) {
|
|
10
61
|
return macAddress.replace(/-/g, ':').toUpperCase();
|
|
11
62
|
}
|
|
@@ -152,6 +203,7 @@ class ResolveMacAddress {
|
|
|
152
203
|
}
|
|
153
204
|
const neighborTable = await readNeighborTable(ipAddress, probeTimeoutMs);
|
|
154
205
|
const macAddress = parseMacAddress(neighborTable);
|
|
206
|
+
const network = getNetworkDetails(ipAddress);
|
|
155
207
|
if (!macAddress && notFoundBehavior === 'throw') {
|
|
156
208
|
throw new Error(`No MAC address found for ${host} (${ipAddress}). The host must be visible on the same local network.`);
|
|
157
209
|
}
|
|
@@ -163,6 +215,7 @@ class ResolveMacAddress {
|
|
|
163
215
|
ipAddress,
|
|
164
216
|
macAddress,
|
|
165
217
|
status: macAddress ? 'resolved' : 'notFound',
|
|
218
|
+
network,
|
|
166
219
|
probeError,
|
|
167
220
|
},
|
|
168
221
|
},
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"ResolveMacAddress.node.js","sourceRoot":"","sources":["../../../nodes/ResolveMacAddress/ResolveMacAddress.node.ts"],"names":[],"mappings":";;;AAAA,2DAA8C;AAC9C,gDAA2C;AAC3C,uCAAgC;
|
|
1
|
+
{"version":3,"file":"ResolveMacAddress.node.js","sourceRoot":"","sources":["../../../nodes/ResolveMacAddress/ResolveMacAddress.node.ts"],"names":[],"mappings":"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"}
|