Saltar a contenido

Node-RED: Authentik, URLs e IaC

Estado: desplegado 2026-08-04

Esta página registra la migración de autenticación y URL de River Oaks Node-RED. Es una referencia operativa para TI, no un reemplazo de la configuración de origen en el repositorio riveroaks/infra.

Estado actual

Los editores activos de River Oaks Node-RED están protegidos por Authentik OIDC y son accesibles a través del namespace interno *.nodered.riveroaks.cc:

Instancia URL canónica del editor Runtime
Studio https://studio.nodered.riveroaks.cc VM studio-nr
MPR https://mpr.nodered.riveroaks.cc VM mpr-nr
MDF https://mdf.nodered.riveroaks.cc VM mdf-nr
Telegram https://telegram.nodered.riveroaks.cc VM telegram-nr
DB https://db.nodered.riveroaks.cc rocc-db-local en rocc-db

La instancia DB es parte de esta migración. Sus rutas de navegador/editor requieren Authentik, mientras que /public/... permanece disponible sin inicio de sesión de navegador para llamadores existentes de Portal, webhooks y automatización.

La instancia histórica de Archivo no tiene backend activo y no fue restaurada ni incluida como objetivo en vivo.

Autenticación y política de red

  • Authentik es el proveedor OIDC para cada editor activo.
  • Cada aplicación Authentik de Node-RED está vinculada al grupo IT. Los usuarios fuera de IT no deben ser admitidos en el editor.
  • Un perfil de Authentik admitido recibe los permisos del editor de Node-RED configurados en el settings.js correspondiente.
  • El certificado comodín dedicado cubre *.nodered.riveroaks.cc.
  • DNS interno apunta los hosts canónicos a rocc-db (10.200.24.42).
  • Nginx permite solo rangos de red privada (10/8, 172.16/12 y 192.168/16) para las rutas canónicas del editor y deniega otras fuentes.

El editor está protegido en /. La excepción de DB está deliberadamente limitada a /public; no elimine esa división sin auditar primero los llamadores de Portal y automatización.

Compatibilidad de URL

La migración no eliminó inmediatamente los nombres antiguos porque otros servicios pueden todavía contener URL de Node-RED. Los siguientes alias de compatibilidad permanecen en vigor y se verificaron durante la migración:

  • studio-nr.riveroaks.cc y edit-studio-nr.riveroaks.cc
  • mpr-nr.riveroaks.cc y edit-mpr-nr.riveroaks.cc
  • mdf-nr.riveroaks.cc y edit-mdf-nr.riveroaks.cc
  • telegram-nr.riveroaks.cc y edit-telegram-nr.riveroaks.cc
  • db-nr.riveroaks.cc

El antiguo nombre DNS db.nodered.ro.church también se conserva para la limpieza de dependencias. Durante la migración de agosto, su borde externo heredado devolvió HTTP 403. Una sonda externa el 2026-10-28 falló el reconocimiento del nombre de host TLS, por lo que esa respuesta histórica no es una garantía de salud actual. No es la URL canónica del editor interno. No lo elimine ni lo reoriente hasta que se hayan identificado los llamadores restantes.

Los llamadores activos de Portal se cambiaron a nombres canónicos .nodered.riveroaks.cc en el repositorio riveroaks/portal. Home Assistant y cualquier otro propietario de automatización externa aún necesitan ser verificados antes de que los alias de compatibilidad puedan ser retirados.

Fuente de verdad de Git e IaC

El repositorio riveroaks/infra es el propietario de la configuración desplegable de Node-RED:

Configuración Ubicación del repositorio
Flujos, configuraciones, paquetes nodered/instances/<instance>/
Destino y comandos de despliegue deploy/targets/nodered/
Planos OIDC de Authentik apps/authentik/blueprints/custom/*-nodered.yaml
Hosts virtuales de Nginx nginx/hosts/rocc-db/sites-enabled/
Fragmento de acceso a red privada nginx/hosts/rocc-db/snippets/nodered-internal.conf

Los archivos administrados incluyen flows.json, settings.js, package.json, package-lock.json, la estrategia compartida de Authentik y la configuración del cliente de Authentik del destino. Las credenciales, flows_cred.json, secretos de cliente, archivos de entorno, módulos instalados y otros secretos en tiempo de ejecución permanecen en el host y no deben ser confirmados.

Realizar un cambio en Node-RED

  1. Trate el editor/host como un lugar para probar o capturar un cambio, no como la fuente de verdad permanente.
  2. Exporte o copie el flujo/configuración resultante en el directorio nodered/instances/<instance>/ correspondiente. Elimine credenciales y secretos.
  3. Actualice el manifiesto o plano correspondiente cuando el comportamiento del runtime o de la autenticación cambie.
  4. Ejecute la validación del repositorio y las comprobaciones de salud del destino.
  5. Abra una MR, revísela y despliegue desde la rama fusionada.

Un cambio de flujo o settings.js en el lado del editor que no se capture en Git es deriva del runtime. Un despliegue posterior de IaC puede sobrescribir archivos administrados, así que registre los cambios importantes del editor antes de desplegar cualquier otra cosa en esa instancia.

El destino DB tiene una puerta de enlace de despliegue explícita DB_NODERED_MIGRATION porque sus flujos tienen más dependencias. Debe desplegarse y verificarse al final cuando se realice un cambio en toda la flota.

Verificación y reversión

La migración de 2026 se completó a través de:

  • IaC MR !56, fusionado como 7a149b3.
  • Portal MR !328, fusionado como 6001ce5.
  • Pipeline final de IaC merged-main 6060: todos los trabajos de validación, Nginx, despliegue de DB y verificación de Node-RED pasaron.
  • Pipeline de Portal 6054: pruebas y despliegue pasaron.

Las comprobaciones posteriores al despliegue confirmaron:

  • Los cinco editores canónicos devuelven la página de inicio de sesión de Authentik a través de TLS válido.
  • Los alias heredados .riveroaks.cc todavía responden.
  • Portal devuelve HTTP 200.
  • Las sondas de compatibilidad de DB /public devuelven la respuesta esperada de la aplicación sin redirigir al inicio de sesión del navegador.
  • Todas las comprobaciones de salud de Node-RED y los procesos PM2 están en línea.

El despliegue estuvo protegido por instantáneas de Proxmox llamadas nodered-pre-merge-20260804-182845 para los VMID 100, 103, 104, 105 y 106. En rocc-db, se almacenaron archivos de respaldo pre-fusión solo para root bajo:

/root/nginx-preswap-backups/merge-pre-20260804-182845/

El mecanismo de despliegue también mantiene copias de seguridad por versión de los archivos administrados y archivos de respaldo pre-fusión de Nginx. Utilice esas copias de seguridad o las instantáneas de Proxmox para una reversión; no restaure flows_cred.json u otros secretos de Git.

Trabajo pendiente

  1. Auditar Home Assistant y otras automatizaciones externas en busca de URL antiguas de DB y *.nodered.ro.church.
  2. Mantener los alias de compatibilidad hasta que esos llamadores se migren y se observe que usan los nombres canónicos.
  3. Decidir si el antiguo borde db.nodered.ro.church debe retirarse o convertirse en una ruta de compatibilidad interna intencional.
  4. Continuar monitoreando la renovación del certificado comodín y las copias de seguridad normales de Proxmox.