n8n-nodes-librenms-e1

Nodo comunitario de n8n para consultar datos de LibreNMS en modo solo lectura.

Qué incluye

• Credenciales por API token (X-Auth-Token).
• Operaciones modeladas para las categorías más útiles de la API oficial:
  • System
  • Devices
  • Alerts
  • Bills
  • Device Groups
  • Inventory
  • Locations
  • Logs
  • Pollers
  • Poller Groups
  • Ports
  • Routing (BGP)
  • Services
  • Switching
  • ARP
• Una operación Custom Read-Only Request para cubrir endpoints GET documentados que no tengan una operación dedicada.

Principios de seguridad

Este paquete no expone operaciones POST, PATCH, PUT ni DELETE. También bloquea rutas GET con efecto lateral conocidas, como discover_device.

La cobertura revisada de endpoints y exclusiones está documentada en docs/endpoint-coverage.md.

Desarrollo local

npm install
npm run build
npm test
npm run lint

Para publicar manualmente en npm:

npm run verify
npm run publish:public

npm run release:n8n mantiene el helper de release de n8n, pero exige un repositorio git limpio y cambios ya committeados.

Para probar el nodo dentro de n8n:

npm run dev

Credenciales

Configura:

• Base URL: la URL base de tu instancia, por ejemplo https://librenms.example.com
• API Token: token generado desde LibreNMS en /api-access/
• Ignore SSL Issues: opcional para entornos internos con certificados autofirmados

No incluyas /api/v0 en la URL base; el nodo añade las rutas de la API automáticamente.

Estado del proyecto

El objetivo de este repositorio es un nodo enfocado en extracción de datos y automatización de reportes, inventario, salud, conectividad y consulta operativa desde n8n, sin permitir mutaciones sobre LibreNMS.