Node-RED Flow: Tag ePO System when ISE Policy Applied

chrissmith added a new solution:

Quote

Prerequisites

• The Node-RED DXL client configuration step has been completed (see Client Configuration).
• The DXL fabric to which the Node-RED DXL client will connect has been bridged to Cisco pxGrid.
• An ePO DXL service is running and available on the DXL fabric. If version 5.0 or later of the DXL ePO extensions are installed on your ePO server, an ePO DXL service should already be running on the fabric. If you are using an earlier version of the DXL ePO extensions, you can use the ePO DXL Python Service.
• The Node-RED DXL client is authorized to perform the apply tag, clear tag, and find system operations within ePO (see Client Authorization).
• The Node-RED DXL client is authorized to perform DXL Cisco pxGrid Queries (see Authorize Client to Use Cisco pxGrid via DXL)
• The following Node-RED modules have been installed (Node-RED palette):
  • Node-RED config node (included in OpenDXL Node-RED Docker image)
  • DXL Node-RED nodes (included in OpenDXL Node-RED Docker image)
  • McAfee ePolicy Orchestrator (ePO) DXL nodes for Node-RED
  • Cisco pxGrid DXL nodes for Node-RED

Setup

Configure the Configure: ISE Policy to ePO Tag Mapping node. This node contains a mapping that maps between the ISE policy name and the corresponding tag name within ePO (see below).

JavaScript: ISE Policy to ePO Tag Mapping

1. {
2. "shut_down_policy": "ISE_shut_down_policy",
3. "port_bounce_policy": "ISE_port_bounce_policy",
4. "quarantine_policy": "ISE_quarantine_policy"
5. }

This mapping should be updated to reflect your Cisco ISE ANC policy names and corresponding tag names within ePO. Each of the ePO tag names must be created within ePO (they are not automatically created).

The Node-RED flow content for this solution:

Code: Node-RED Flow

1. [
2. {
3. "id": "454f293f.10a098",
4. "type": "tab",
5. "label": "Tag System when ISE Policy Applied",
6. "disabled": false,
7. "info": "This flow ensures that systems within McAfee ePO are tagged to indicate\r\nwhat policies are currently applied within Cisco ISE Adaptive Network \r\nControl (ANC). When an ANC policy is applied, the corresponding system is\r\nlocated within ePO and tagged approriately. When an ANC policy is removed,\r\nthe corresponding system is located within ePO and untagged appropriately.\r\n\r\n### Prerequisites\r\n\r\n* The Node-RED DXL client configuration step has been completed (see\r\n [Client Configuration](https://opendxl.github.io/node-red-contrib-dxl/jsdoc/tutorial-configuration.html)).\r\n* The DXL fabric to which the Node-RED DXL client will connect has been bridged to Cisco\r\n pxGrid.\r\n* An ePO DXL service is running and available on the DXL fabric. If version 5.0\r\n or later of the DXL ePO extensions are installed on your ePO server, an ePO\r\n DXL service should already be running on the fabric. If you are using an\r\n earlier version of the DXL ePO extensions, you can use the\r\n [ePO DXL Python Service](https://github.com/opendxl/opendxl-epo-service-python).\r\n* The Node-RED DXL client is authorized to perform the `apply tag`, `clear tag`,\r\n and `find system` operations within ePO (see\r\n [Client Authorization](https://opendxl.github.io/opendxl-epo-client-python/pydoc/authorization.html)).\r\n* The Node-RED DXL client is authorized to perform `DXL Cisco pxGrid Queries`\r\n (see [Authorize Client to Use Cisco pxGrid via DXL](https://opendxl.github.io/opendxl-pxgrid-client-python/pydoc/pxgridauth.html))\r\n* The following Node-RED modules have been installed:\r\n * [Node-RED config node](https://flows.nodered.org/node/node-red-contrib-config) (included in OpenDXL Node-RED Docker image)\r\n * [DXL Node-RED nodes](https://flows.nodered.org/node/@opendxl/node-red-contrib-dxl) (included in OpenDXL Node-RED Docker image)\r\n * [McAfee ePolicy Orchestrator (ePO) DXL nodes for Node-RED](https://flows.nodered.org/node/@opendxl/node-red-contrib-dxl-epo-client)\r\n * [Cisco pxGrid DXL nodes for Node-RED](https://flows.nodered.org/node/@opendxl/node-red-contrib-dxl-pxgrid-client) \r\n\r\n### Setup\r\n\r\n* Configure the `Configure: ISE Policy to ePO Tag Mapping` node. This node \r\n contains a mapping that maps between the ISE policy name and the \r\n corresponding tag name within ePO (see below).\r\n\r\n```javascript\r\n{\r\n \"shut_down_policy\": \"ISE_shut_down_policy\",\r\n \"port_bounce_policy\": \"ISE_port_bounce_policy\",\r\n \"quarantine_policy\": \"ISE_quarantine_policy\"\r\n}\r\n```\r\n\r\nThis mapping should be updated to reflect your Cisco ISE ANC policy names and corresponding tag\r\nnames within ePO. Each of the ePO tag names must be created within ePO (they \r\nare not automatically created).\r\n"
8. },
9. {
10. "id": "74ea78ed.44fa38",
11. "type": "function",
12. "z": "454f293f.10a098",
13. "name": "Extract IP Address from Result",
14. "func": "if(msg.payload.length)\n msg.names = msg.payload[0]['EPOComputerProperties.IPAddress'];\n\nif(msg.names)\n node.send(msg);\nelse\n node.warn(\"Unable to find IP address for: \" + msg.macAddress);",
15. "outputs": 1,
16. "noerr": 0,
17. "x": 490,
18. "y": 740,
19. "wires": [
20. [
21. "fc467203.f8911"
22. ]
23. ]
24. },
25. {
26. "id": "326a995c.504086",
27. "type": "function",
28. "z": "454f293f.10a098",
29. "name": "Format System Find Request",
30. "func": "msg.macAddress = msg.payload.macAddress;\nmsg.searchText = msg.macAddress.replace(/:/g,'');\nreturn msg;",
31. "outputs": 1,
32. "noerr": 0,
33. "x": 480,
34. "y": 580,
35. "wires": [
36. [
37. "d3a40a6d.61e2d8"
38. ]
39. ]
40. },
41. {
42. "id": "4951c6c3.245d58",
43. "type": "switch",
44. "z": "454f293f.10a098",
45. "name": "Determine if event contains IP or MAC",
46. "property": "payload.ipAddress",
47. "propertyType": "msg",
48. "rules": [
49. {
50. "t": "nnull"
51. },
52. {
53. "t": "null"
54. }
55. ],
56. "checkall": "true",
57. "repair": false,
58. "outputs": 2,
59. "x": 250,
60. "y": 500,
61. "wires": [
62. [
63. "7538913a.f122e"
64. ],
65. [
66. "326a995c.504086"
67. ]
68. ],
69. "outputLabels": [
70. "IP Address",
71. "MAC Address"
72. ]
73. },
74. {
75. "id": "94e79ef.7e98e6",
76. "type": "debug",
77. "z": "454f293f.10a098",
78. "name": "Debug: Response",
79. "active": true,
80. "tosidebar": true,
81. "console": false,
82. "tostatus": false,
83. "complete": "payload",
84. "x": 990,
85. "y": 640,
86. "wires": []
87. },
88. {
89. "id": "4b4e0ddd.ebc784",
90. "type": "debug",
91. "z": "454f293f.10a098",
92. "name": "Debug: ISE Apply Notification",
93. "active": true,
94. "tosidebar": true,
95. "console": false,
96. "tostatus": false,
97. "complete": "payload",
98. "x": 590,
99. "y": 240,
100. "wires": []
101. },
102. {
103. "id": "808becbf.b6432",
104. "type": "function",
105. "z": "454f293f.10a098",
106. "name": "Set Tag Name to Apply",
107. "func": "msg.tagName = flow.get(\"policyToTagMap\")[msg.payload.policyName]\n\nif(msg.tagName)\n node.send(msg);\nelse\n node.warn(\"Tag not found for policy: \" + msg.payload.policyName);\n",
108. "outputs": 1,
109. "noerr": 0,
110. "x": 210,
111. "y": 340,
112. "wires": [
113. [
114. "4951c6c3.245d58"
115. ]
116. ]
117. },
118. {
119. "id": "7538913a.f122e",
120. "type": "change",
121. "z": "454f293f.10a098",
122. "name": "Extract IP Address from ISE Event",
123. "rules": [
124. {
125. "t": "set",
126. "p": "names",
127. "pt": "msg",
128. "to": "payload.ipAddress",
129. "tot": "msg"
130. }
131. ],
132. "action": "",
133. "property": "",
134. "from": "",
135. "to": "",
136. "reg": false,
137. "x": 500,
138. "y": 420,
139. "wires": [
140. [
141. "fc467203.f8911"
142. ]
143. ]
144. },
145. {
146. "id": "73eca8ff.3b6c58",
147. "type": "comment",
148. "z": "454f293f.10a098",
149. "name": "Tag ePO System based on Cisco ISE Apply Endpoint Policy Notification",
150. "info": "",
151. "x": 270,
152. "y": 180,
153. "wires": []
154. },
155. {
156. "id": "fc467203.f8911",
157. "type": "function",
158. "z": "454f293f.10a098",
159. "name": "Join",
160. "func": "\nreturn msg;",
161. "outputs": 1,
162. "noerr": 0,
163. "x": 730,
164. "y": 540,
165. "wires": [
166. [
167. "a22897d6.bdac58",
168. "27004ecc.2bda12",
169. "df83f27a.76672"
170. ]
171. ]
172. },
173. {
174. "id": "27004ecc.2bda12",
175. "type": "debug",
176. "z": "454f293f.10a098",
177. "name": "Debug: System to Tag",
178. "active": true,
179. "tosidebar": true,
180. "console": false,
181. "tostatus": false,
182. "complete": "names",
183. "x": 1000,
184. "y": 400,
185. "wires": []
186. },
187. {
188. "id": "df83f27a.76672",
189. "type": "debug",
190. "z": "454f293f.10a098",
191. "name": "Debug: Tag to Apply",
192. "active": true,
193. "tosidebar": true,
194. "console": false,
195. "tostatus": false,
196. "complete": "tagName",
197. "x": 1000,
198. "y": 440,
199. "wires": []
200. },
201. {
202. "id": "dc275431.b559f8",
203. "type": "function",
204. "z": "454f293f.10a098",
205. "name": "Extract IP Address from Result",
206. "func": "if(msg.payload.length)\n msg.names = msg.payload[0]['EPOComputerProperties.IPAddress'];\n\nif(msg.names)\n node.send(msg);\nelse\n node.warn(\"Unable to find IP address for: \" + msg.macAddress);",
207. "outputs": 1,
208. "noerr": 0,
209. "x": 490,
210. "y": 1340,
211. "wires": [
212. [
213. "fc1db5f3.3f4618"
214. ]
215. ]
216. },
217. {
218. "id": "e584c1a8.3c522",
219. "type": "function",
220. "z": "454f293f.10a098",
221. "name": "Format System Find Request",
222. "func": "msg.macAddress = msg.payload.macAddress;\nmsg.searchText = msg.macAddress.replace(/:/g,'');\nreturn msg;",
223. "outputs": 1,
224. "noerr": 0,
225. "x": 480,
226. "y": 1180,
227. "wires": [
228. [
229. "6b7a54f6.756f3c"
230. ]
231. ]
232. },
233. {
234. "id": "612d3d71.615f14",
235. "type": "switch",
236. "z": "454f293f.10a098",
237. "name": "Determine if event contains IP or MAC",
238. "property": "payload.ipAddress",
239. "propertyType": "msg",
240. "rules": [
241. {
242. "t": "nnull"
243. },
244. {
245. "t": "null"
246. }
247. ],
248. "checkall": "true",
249. "repair": false,
250. "outputs": 2,
251. "x": 250,
252. "y": 1080,
253. "wires": [
254. [
255. "722d6752.477ea8"
256. ],
257. [
258. "e584c1a8.3c522"
259. ]
260. ],
261. "outputLabels": [
262. "IP Address",
263. "MAC Address"
264. ]
265. },
266. {
267. "id": "4a2cf3e9.47dcac",
268. "type": "debug",
269. "z": "454f293f.10a098",
270. "name": "Debug: Response",
271. "active": true,
272. "tosidebar": true,
273. "console": false,
274. "tostatus": false,
275. "complete": "payload",
276. "x": 850,
277. "y": 1580,
278. "wires": []
279. },
280. {
281. "id": "824b2f3b.c4cb",
282. "type": "debug",
283. "z": "454f293f.10a098",
284. "name": "Debug: ISE Clear Notification",
285. "active": true,
286. "tosidebar": true,
287. "console": false,
288. "tostatus": false,
289. "complete": "payload",
290. "x": 580,
291. "y": 900,
292. "wires": []
293. },
294. {
295. "id": "722d6752.477ea8",
296. "type": "change",
297. "z": "454f293f.10a098",
298. "name": "Extract IP Address from ISE Event",
299. "rules": [
300. {
301. "t": "set",
302. "p": "names",
303. "pt": "msg",
304. "to": "payload.ipAddress",
305. "tot": "msg"
306. }
307. ],
308. "action": "",
309. "property": "",
310. "from": "",
311. "to": "",
312. "reg": false,
313. "x": 520,
314. "y": 980,
315. "wires": [
316. [
317. "fc1db5f3.3f4618"
318. ]
319. ]
320. },
321. {
322. "id": "60beb4e6.67beac",
323. "type": "comment",
324. "z": "454f293f.10a098",
325. "name": "Clear ePO System Tag based on Cisco ISE Clear Endpoint Policy Notification",
326. "info": "",
327. "x": 290,
328. "y": 840,
329. "wires": []
330. },
331. {
332. "id": "fc1db5f3.3f4618",
333. "type": "function",
334. "z": "454f293f.10a098",
335. "name": "Collect ISE Tag Names to Clear",
336. "func": "var policyMap = flow.get(\"policyToTagMap\");\nvar keys = Object.keys(policyMap);\nmsg.payload = keys.map(function(key){\n return policyMap[key]; \n});\nreturn msg;",
337. "outputs": 1,
338. "noerr": 0,
339. "x": 850,
340. "y": 1340,
341. "wires": [
342. [
343. "98dc07a7.a3fda8"
344. ]
345. ]
346. },
347. {
348. "id": "98dc07a7.a3fda8",
349. "type": "split",
350. "z": "454f293f.10a098",
351. "name": "Execute for each Tag Name",
352. "splt": "\\n",
353. "spltType": "str",
354. "arraySplt": 1,
355. "arraySpltType": "len",
356. "stream": false,
357. "addname": "",
358. "x": 260,
359. "y": 1500,
360. "wires": [
361. [
362. "e1607375.f97fd"
363. ]
364. ]
365. },
366. {
367. "id": "e1607375.f97fd",
368. "type": "change",
369. "z": "454f293f.10a098",
370. "name": "Set Tag Name to Clear",
371. "rules": [
372. {
373. "t": "set",
374. "p": "tagName",
375. "pt": "msg",
376. "to": "payload",
377. "tot": "msg"
378. }
379. ],
380. "action": "",
381. "property": "",
382. "from": "",
383. "to": "",
384. "reg": false,
385. "x": 340,
386. "y": 1580,
387. "wires": [
388. [
389. "f4184ca2.2bd89",
390. "f9e49855.aba888",
391. "8f4516f2.cbc7c8"
392. ]
393. ]
394. },
395. {
396. "id": "f9e49855.aba888",
397. "type": "debug",
398. "z": "454f293f.10a098",
399. "name": "Debug: Tag to Clear",
400. "active": true,
401. "tosidebar": true,
402. "console": false,
403. "tostatus": false,
404. "complete": "tagName",
405. "x": 620,
406. "y": 1520,
407. "wires": []
408. },
409. {
410. "id": "8f4516f2.cbc7c8",
411. "type": "debug",
412. "z": "454f293f.10a098",
413. "name": "Debug: System to Clear Tag",
414. "active": true,
415. "tosidebar": true,
416. "console": false,
417. "tostatus": false,
418. "complete": "names",
419. "x": 640,
420. "y": 1480,
421. "wires": []
422. },
423. {
424. "id": "30525000.94864",
425. "type": "dxl-ise-anc-apply-endpoint-policy in",
426. "z": "454f293f.10a098",
427. "name": "",
428. "client": "92f8ab5f.08f1b8",
429. "payloadType": "obj",
430. "x": 220,
431. "y": 240,
432. "wires": [
433. [
434. "4b4e0ddd.ebc784",
435. "808becbf.b6432"
436. ]
437. ]
438. },
439. {
440. "id": "79ef6e3b.3fdd5",
441. "type": "dxl-ise-anc-clear-endpoint-policy in",
442. "z": "454f293f.10a098",
443. "name": "",
444. "client": "92f8ab5f.08f1b8",
445. "payloadType": "obj",
446. "x": 220,
447. "y": 900,
448. "wires": [
449. [
450. "824b2f3b.c4cb",
451. "612d3d71.615f14"
452. ]
453. ]
454. },
455. {
456. "id": "a22897d6.bdac58",
457. "type": "dxl-epo-system-apply-tag",
458. "z": "454f293f.10a098",
459. "name": "",
460. "tagName": "",
461. "client": "92f8ab5f.08f1b8",
462. "epoUniqueId": "",
463. "returnType": "obj",
464. "x": 970,
465. "y": 540,
466. "wires": [
467. [
468. "94e79ef.7e98e6"
469. ]
470. ]
471. },
472. {
473. "id": "d3a40a6d.61e2d8",
474. "type": "dxl-epo-system-find",
475. "z": "454f293f.10a098",
476. "name": "",
477. "client": "92f8ab5f.08f1b8",
478. "searchNameOnly": false,
479. "epoUniqueId": "",
480. "returnType": "obj",
481. "x": 460,
482. "y": 660,
483. "wires": [
484. [
485. "74ea78ed.44fa38"
486. ]
487. ]
488. },
489. {
490. "id": "6b7a54f6.756f3c",
491. "type": "dxl-epo-system-find",
492. "z": "454f293f.10a098",
493. "name": "",
494. "client": "92f8ab5f.08f1b8",
495. "searchNameOnly": false,
496. "epoUniqueId": "",
497. "returnType": "obj",
498. "x": 460,
499. "y": 1260,
500. "wires": [
501. [
502. "dc275431.b559f8"
503. ]
504. ]
505. },
506. {
507. "id": "f4184ca2.2bd89",
508. "type": "dxl-epo-system-clear-tag",
509. "z": "454f293f.10a098",
510. "name": "",
511. "tagName": "",
512. "client": "92f8ab5f.08f1b8",
513. "epoUniqueId": "",
514. "returnType": "obj",
515. "x": 600,
516. "y": 1580,
517. "wires": [
518. [
519. "4a2cf3e9.47dcac"
520. ]
521. ]
522. },
523. {
524. "id": "6a9f1e60.07926",
525. "type": "config",
526. "z": "454f293f.10a098",
527. "name": "Configure: ISE Policy to ePO Tag Mapping",
528. "properties": [
529. {
530. "p": "policyToTagMap",
531. "pt": "flow",
532. "to": "{\"shut_down_policy\":\"ISE_shut_down_policy\",\"port_bounce_policy\":\"ISE_port_bounce_policy\",\"quarantine_policy\":\"ISE_quarantine_policy\"}",
533. "tot": "json"
534. }
535. ],
536. "active": true,
537. "x": 250,
538. "y": 100,
539. "wires": []
540. },
541. {
542. "id": "2500153e.3895ca",
543. "type": "comment",
544. "z": "454f293f.10a098",
545. "name": "MANDATORY STEP: Update ISE Policy to ePO Tag Mapping",
546. "info": " This node \n contains a mapping that maps between the ISE policy name and the \n corresponding tag name within ePO (see below).\n\n```javascript\n{\n \"shut_down_policy\": \"ISE_shut_down_policy\",\n \"port_bounce_policy\": \"ISE_port_bounce_policy\",\n \"quarantine_policy\": \"ISE_quarantine_policy\"\n}\n```\n\nThis mapping should be updated to reflect your Cisco ISE ANC policy names and corresponding tag\nnames within ePO. Each of the ePO tag names must be created within ePO (they \nare not automatically created).\n",
547. "x": 240,
548. "y": 60,
549. "wires": []
550. }
551. ]

Display More

Display More