vh/NetAlertX
1
0
Fork 0
mirror of https://github.com/jokob-sk/NetAlertX.git synced 2026-04-02 00:02:19 -07:00
Code Issues Actions 3 Packages Projects Releases Wiki Activity
Files
c7399215ecd76126156b4c35f7e16262bdea5598
NetAlertX/front/plugins/unifi_import
History
Jokob @NetAlertX c7399215ec Refactor event and session column names to camelCase 
- Updated test cases to reflect new column names (eve_MAC -> eveMac, eve_DateTime -> eveDateTime, etc.) across various test files.
- Modified SQL table definitions in the database cleanup and migration tests to use camelCase naming conventions.
- Implemented migration tests to ensure legacy column names are correctly renamed to camelCase equivalents.
- Ensured that existing data is preserved during the migration process and that views referencing old column names are dropped before renaming.
- Verified that the migration function is idempotent, allowing for safe re-execution without data loss.
2026-03-16 10:11:22 +00:00
..
config.json
Refactor event and session column names to camelCase
2026-03-16 10:11:22 +00:00
full_run.lock
Ignored IPs not applied #836
2024-10-11 20:05:23 +11:00
README.md
DOCS: UNIFIAPI
2026-02-19 14:10:47 +11:00
script.py
FIX: lowercase MAC normalization across project v0.1
2026-02-07 13:44:50 +11:00

README.md

Overview

A plugin allowing for importing devices from a UniFi controller. The plugin also tries to import the network map.

Usage

Specify the following settings in the Settings section of NetAlertX:

  • UNFIMP_username - Username used to log in the UNIFI controller.
  • UNFIMP_password - Password used to log in the UNIFI controller.
  • UNFIMP_host - Host URL or IP address where the UNIFI controller is hosted (excluding http://)
  • UNFIMP_sites - Name of the sites (usually 'default', check the URL in your UniFi controller UI if unsure. The site id is in the following part of the URL: https://192.168.1.1:8443/manage/site/this-is-the-site-id/settings/).
  • UNFIMP_protocol - https:// or http://
  • UNFIMP_port - Usually 8443, 8843, or 443 (UPSTREAM BUG: Setting UNFIMP_version='UDMP-unifiOS' will force 443 see #1524 or switch to the UNIFIAPI plugin)
  • UNFIMP_version - see below table for details

Config overview

Controller UNFIMP_version UNFIMP_port
Cloud Gateway Ultra / UCK cloudkey V2 plus (v4.0.18) UDMP-unifiOS 443 (BUG: always forced)
Docker hosted v5 8443 (usually)

Notes

  • It is recommended to create a read-only user in your UniFi controller