zsec

n8n community node for UniFi Network Security Scanner by ZurdAI

Package Information

Downloads: 1 weekly / 24 monthly
Latest Version: 2.0.1
Author: ZurdAI

Available Nodes

ZurdAI Security Scanner icon
ZurdAI Security Scanner
Advanced security scanner for UniFi networks - detects threats, anomalies, and compromised devices

Documentation

@zurdai/n8n-nodes-zsec

n8n community node for UniFi Network Security Scanner by ZurdAI.

This node connects to your UniFi Network Controller, scans all connected devices, and performs automated security risk analysis.

Features

  • Authenticate with UniFi OS API (cookie-based session)
  • Fetch all clients connected to your network
  • Analyze DPI data (Deep Packet Inspection)
  • Risk classification for each device:
    • HIGH: Malicious domain patterns detected or high upload traffic (>50MB)
    • MEDIUM: Night activity (00:00-05:00) or unusual DPI query volume
    • LOW: No suspicious behavior

Installation

In n8n (Community Nodes)

  1. Go to Settings > Community Nodes
  2. Select Install
  3. Enter @zurdai/n8n-nodes-zsec
  4. Click Install

Manual Installation

npm install @zurdai/n8n-nodes-zsec

Configuration

Credentials

Create UniFi API credentials in n8n with:

Field Description Example
Controller URL Your UniFi Controller URL https://192.168.1.104
Username UniFi login (email) admin@example.com
Password UniFi password ********
Ignore SSL Issues Enable for self-signed certs true

Node Parameters

Parameter Description Default
Action Operation to perform scanNetwork
Site UniFi site name default

Options

Option Description Default
Upload Threshold (MB) Traffic threshold for HIGH risk 50
DPI Spike Threshold Record count for MEDIUM risk 500
Night Hours Start Start of night window 0
Night Hours End End of night window 5
Custom Malicious Keywords Additional patterns to detect

Output

For each device, the node returns:

{
  "mac": "aa:bb:cc:dd:ee:ff",
  "ip": "192.168.1.100",
  "hostname": "device-name",
  "risk": "LOW",
  "reasons": ["No suspicious behavior detected"],
  "online": true
}

Security Note

Your UniFi credentials are stored only in n8n's encrypted credentials system. They are never:

  • Stored in this package's code
  • Pushed to GitHub
  • Published to npm

Compatibility

  • n8n >= 1.0.0
  • Node.js >= 18.0.0

License

MIT

Author

ZurdAI

Discussion