Skip to Content

Seguridad

El appliance se ejecuta en hardware y en una red que operas tú. IronFlock proporciona el software y sus valores predeterminados; lo bien protegido que esté el appliance depende también del modo que elijas, de la red que lo rodea y del host en el que se ejecuta. Esta página es la lista de comprobación para esa parte.

Qué protege cada modo

El appliance funciona en uno de tres modos, descritos en HTTPS y certificados. Se diferencian en qué se cifra y qué se verifica:

HTTP simple (predeterminado)HTTPS con una CA autoemitidaHTTPS con tu certificado corporativo
Navegador al applianceSin cifrarHTTPSHTTPS
Cookies de inicio de sesiónNo marcadas como segurasSegurasSeguras
Enlace del dispositivo (puerto 18080)Sin cifrarSin cifrarHTTPS en 443
Imágenes de apps y actualizaciones del agente para los dispositivosSin cifrarSin cifrarHTTPS en 443
Túnel de acceso remoto de los dispositivosCifrado, servidor no verificadoCifrado, servidor no verificadoCifrado y verificado
Passkeys y llaves de seguridadSolo desde el propio applianceSíSí

Usa HTTPS con tu certificado corporativo siempre que el appliance comparta red con otros sistemas. Es el único modo en el que los dispositivos conectados verifican con quién hablan. Los otros dos modos son adecuados para un segmento de red al que solo pueden acceder el appliance, sus dispositivos y sus operadores.

Qué queda sin cifrar

Incluso con HTTPS, parte del tráfico no está cifrado. Planifica tu red teniéndolo en cuenta:

  • El enlace del dispositivo en el puerto 18080 se publica en todas las interfaces de red en todos los modos. Se conectan a él el propio agente de dispositivo del appliance y las apps que se ejecutan en el appliance, y en modo simple y con una CA autoemitida también todos los dispositivos conectados.
  • Los túneles de acceso remoto hacia el appliance (puerto 7000) están cifrados en modo simple y con una CA autoemitida, pero los dispositivos no pueden comprobar el certificado del appliance. Alguien con acceso a la ruta de red podría hacerse pasar por el servidor de túneles del appliance. Los agentes de dispositivo registran una advertencia cuando se conectan de esta forma.
  • Las conexiones entre los servicios dentro del appliance, como las que van a sus bases de datos, no están cifradas. No salen del host.
  • Los datos en reposo no los cifra el appliance. Usa el cifrado del sistema operativo o del disco del host si el appliance almacena datos sensibles o puede salir de tus instalaciones.

Lista de comprobación de endurecimiento

  • Elige el modo que se ajuste a tu red (consulta Qué protege cada modo).
  • Restringe quién puede alcanzar los puertos del appliance. La instalación no abre nada en tu cortafuegos, y Docker publica los puertos del appliance saltándose las reglas de entrada habituales del cortafuegos del host (ufw, firewalld). Filtra en la cadena DOCKER-USER o en el cortafuegos de tu red: la instalación deja una plantilla en /opt/ironflock/docker-user-firewall.sh.example. Permite los puertos de los dispositivos (18080, 15001, 15002, 7000, 30000–30049) solo desde las redes de tus dispositivos — consulta Dispositivos que se conectan al appliance.
  • Mantén actualizado el sistema operativo del host y limita quién tiene una cuenta en él. Cualquiera con acceso root al host puede leer todos los secretos del appliance.
  • Usa claves SSH en lugar de contraseñas para el acceso administrativo al host.
  • Configura la sincronización horaria — consulta Sincronización horaria (NTP).
  • Cambia la contraseña de administrador tras el primer inicio de sesión y configura un segundo factor para la cuenta de administrador.
  • Exige un segundo factor a todos una vez que todas las cuentas tengan uno (consulta Cuentas y acceso).
  • Protege con un segundo factor la cuenta de ironflock.com propietaria de la instancia: tiene acceso de administrador al appliance desde la nube.
  • Desactiva la conexión a la nube si nadie necesita trabajar en el appliance desde ironflock.com (consulta Conexión a la nube).
  • Instala solo apps de confianza. Las apps se ejecutan en el appliance y en tus dispositivos con un amplio acceso al host, incluidos los archivos de configuración del appliance.
  • Mantén el appliance actualizado (consulta Actualizaciones).
  • Verifica ironflock antes de la primera instalación (consulta Verificar ironflock antes de la primera instalación).

Cuentas y acceso

  • Cuenta de administrador: cada appliance recibe su propia contraseña de administrador durante la instalación; ironflock appliance install la muestra una sola vez. Si se pierde, establece una nueva como se describe en Operación local — esto también cierra todas las sesiones de administrador.
  • Los nuevos usuarios solo pueden registrarse con una invitación de un proyecto del appliance. Sin invitación, el registro se rechaza, también a través del inicio de sesión social.
  • Segundo factor: los usuarios pueden configurar una app de autenticación (TOTP), passkeys o llaves de seguridad, y códigos de recuperación. Las passkeys y las llaves de seguridad necesitan HTTPS. La opción --2fa de ironflock appliance install o de ironflock appliance configure establece la política, y esta se mantiene entre actualizaciones:
    • available — los usuarios pueden configurar un segundo factor, pero nunca se les pide.
    • effective (predeterminado) — los usuarios que tienen un segundo factor deben usarlo.
    • required — todos los usuarios deben usar un segundo factor. Asegúrate antes de que cada cuenta tenga uno: un usuario sin él ya no puede iniciar sesión.
  • Las sesiones duran 24 horas.
  • Acceso desde ironflock.com: la cuenta de ironflock.com que creó la Instance Key está vinculada a la cuenta de administrador del appliance. Los usuarios que invitas vinculan sus propias cuentas de ironflock.com — consulta Vincular cuentas. Un usuario puede eliminar esa vinculación en cualquier momento. Para impedir todo acceso desde ironflock.com, el administrador desactiva la conexión a la nube.

Secretos en el host

ironflock appliance install genera los secretos del appliance una sola vez, durante la instalación, y los conserva entre actualizaciones. Se encuentran en /opt/ironflock/:

ArchivoContenidoAcceso
.envContraseñas y claves de todos los servicios, la contraseña inicial de administrador, credenciales del proxy y de SMTPSolo root (0600)
license.envLa Instance Key, y lo que la validación de la licencia guarda con ellaRoot y los servicios de IronFlock (0640)
certs/El certificado HTTPS y su clave; con una CA autoemitida también la clave de la CAClaves privadas solo root (0600)
registry-token-certs/La clave que firma los tokens de descarga de imágenes de appsSolo el servicio de registro (0600)
.env.prev, rotation.logEl .env anterior a la última rotación; cuándo se rotó qué secreto, sin valoresSolo root (0600)

La instalación también inicia sesión de Docker en el registro de IronFlock con tu Instance Key, así que la configuración de Docker de root también la contiene.

Incluye estos archivos en tus copias de seguridad y protege las copias igual que el propio appliance. Nunca borres .env ni dejes que una instalación lo vuelva a generar: las bases de datos y los datos cifrados dependen de sus valores. Para sustituir un secreto, rótalo.

Lo que puedes sustituir tú mismo:

  • Contraseña de administrador: en el perfil, o con sudo ironflock appliance reset-admin-password (consulta Operación local).
  • Certificado HTTPS: tu propio certificado con sudo ironflock appliance configure --tls-cert <file> --tls-key <file> (consulta HTTPS y certificados). Un certificado de la CA propia del appliance se renueva solo: una comprobación semanal firma uno nuevo cuando quedan menos de 30 días.
  • Instance Key: en la sección de licencia del perfil de administrador, o con sudo ironflock appliance configure --license-file <file>, donde el archivo contiene la clave nueva. La clave nueva tiene que dar acceso al registro de IronFlock antes de que se escriba.
  • Credenciales de SMTP: en .env, y después reinicia con sudo ironflock appliance restart.
  • Proxy: con sudo ironflock appliance configure (consulta Detrás de un proxy corporativo).
  • Secretos internos de los servicios: sudo ironflock appliance rotate <NAME>, consulta más abajo.

Rotación de un secreto interno

sudo ironflock appliance rotate <NAME> da un nuevo valor a un secreto de .env mientras el appliance está en marcha. El nuevo valor va primero donde se guarda el anterior (un rol de la base de datos, el archivo de dispositivo del agente, el par de claves de los tokens del registro) y después a .env. Solo se recrean los servicios que leen el secreto, y el comando comprueba que están en buen estado. El .env anterior al cambio se conserva como .env.prev, y rotation.log enumera cada rotación, nunca un valor. ironflock appliance rotate --help enumera los nombres que puede rotar. Consulta ironflock appliance rotate.

Ejecuta las rotaciones por SSH o en la consola del appliance, no en el terminal del propio dispositivo del appliance en IronFlock: una rotación que reinicia los servicios de los que depende ese terminal lo interrumpe.

SecretosQué hace una rotación
WAMP_SECRET_SVC_*, WAMP_SYSTEM_SECRET y los demás secretos de servicioLos servicios que lo usan se reinician; sus conexiones se restablecen en pocos segundos.
KRATOS_SECRETS_COOKIELos nuevos inicios de sesión usan la nueva clave; las sesiones iniciadas antes siguen siendo válidas, porque la clave anterior se conserva hasta la siguiente rotación.
POSTGRES_PASSWORD, PGPASSWORD_*, DATASERVICE_PASSWORDEl rol de la base de datos recibe la nueva contraseña y después se reinician sus servicios. Pregunta antes; --yes responde.
REGISTRY_TOKEN_KEYLos tokens de descarga de imágenes de apps se firman con una nueva clave; los tokens firmados antes siguen siendo válidos hasta la siguiente rotación. Pregunta antes; --yes responde.
APPLIANCE_DEVICE_SECRETEl propio dispositivo del appliance recibe una nueva credencial; su agente se reinicia y vuelve a estar en línea en menos de un minuto. Pregunta antes; --yes responde.
FILE_CRED_KEYLas apps conservan sus archivos; su acceso al almacenamiento pasa a la nueva clave. Para las credenciales S3 directas de las apps, elige --keep-direct-access o --revoke-direct-access. Las credenciales conservadas siguen funcionando, para una rotación planificada: quien conozca la clave anterior aún puede derivarlas, por eso la configuración de almacenamiento de cada app las marca para sustituirlas, y sudo ironflock appliance revoke-direct-access elimina más tarde las que queden. Las credenciales revocadas dejan de funcionar y se eliminan de inmediato, por ejemplo tras una sospecha de filtración. Pregunta antes (--yes responde) y requiere la versión 1.6.23 o posterior del appliance.
APPLIANCE_ADMIN_PASSWORDUna nueva contraseña inicial de administrador, igual que ironflock appliance reset-admin-password.

Rota FLEETDB_SECRET_KEYS, KRATOS_SECRETS_CIPHER y las dos claves OBJECTSTORE_ADMIN_* solo junto con el equipo de IronFlock: los datos guardados con ellas dependen de ellas. La Instance Key se cambia en el perfil de administrador o con ironflock appliance configure, no con rotate.

Conexiones salientes y telemetría

Los destinos a los que se conecta el appliance se enumeran en Configuración del cortafuegos; todas estas conexiones están cifradas.

  • La validación de la licencia envía la clave de licencia, una huella del hardware y los tokens de acceso de las conexiones del appliance a la App Store online.
  • El asistente de IA envía los prompts a través del gateway de LLM de IronFlock, a menos que configures un gateway propio.
  • Sin telemetría. El appliance no envía analíticas de uso: ni la UI del appliance ni sus servicios informan del uso a IronFlock ni a terceros.
  • Desde el navegador del usuario: los mosaicos de los mapas se cargan desde Mapbox, y la entrada de voz usa el servicio de reconocimiento de voz Deepgram. Estas conexiones las realiza el navegador, no el appliance.

Actualizaciones

  • Las actualizaciones del appliance las inicia el administrador (consulta Mantenimiento) y están firmadas por IronFlock. ironflock comprueba la lista de versiones disponibles y el manifiesto de release de la nueva versión con la clave de release del appliance que lleva, y después cada archivo de la nueva versión y cada imagen de contenedor con ese manifiesto. Un archivo modificado o sin firmar, o cualquier imagen distinta de la publicada, detiene la actualización antes de que cambie nada en el appliance. Una actualización nunca devuelve por sí sola el appliance a una versión anterior y, si una actualización falla, el appliance vuelve a la versión que ejecutaba antes.
  • Las actualizaciones del agente de dispositivo están firmadas. Cada agente comprueba la firma antes de aplicar una actualización y revierte si la nueva versión no arranca — consulta Actualizaciones del agente de dispositivo.
  • El sistema operativo del host es tu responsabilidad, incluido Docker.

Verificar ironflock antes de la primera instalación

El appliance comprueba cada actualización por sí mismo: ironflock comprueba cada versión del appliance con la clave de release del appliance de IronFlock que lleva, antes de instalarla. Lo que aceptas por confianza es el script de instalación de ironflock, que se ejecuta como root. Compruébalo antes de que se ejecute, como se describe en Verificar antes el script de instalación: gpg debe indicar una firma válida de la clave IronFlock Bootstrap con la huella F6C9 4D96 CE31 5377 ACA7 C8EA 4990 5433 7321 2788. El script, a su vez, comprueba ironflock con esa clave antes de instalarlo. Ambas claves aparecen en Claves de firma.

Copia de seguridad y restauración

Para hacer una copia de seguridad de todo el appliance, detenlo con sudo ironflock appliance stop y copia:

  • la carpeta /opt/ironflock/, incluidos .env, license.env, certs/ y registry-token-certs/;
  • los volúmenes de Docker del appliance (docker volume ls), que contienen las bases de datos, los archivos, la App Store local y los archivos de los usuarios.

Después vuelve a iniciarlo con sudo ironflock appliance start. Guarda .env junto con los volúmenes del mismo momento: los datos cifrados de los volúmenes solo pueden leerse con las claves de ese .env.

Los secretos por sí solos se pueden guardar con el appliance en marcha:

sudo ironflock appliance backup -o /root/appliance-secrets.tar.gz

El archivo comprimido contiene .env, license.env, la CA, las claves de los tokens del registro, el inventario de secretos y rotation.log; solo root puede leer el archivo. Un FLEETDB_SECRET_KEYS o un FILE_CRED_KEY perdidos no se pueden recuperar de ninguna otra forma: cifra el archivo comprimido y guárdalo con las copias de seguridad de los volúmenes.

Para restaurar los secretos en un appliance instalado, restáuralos con --force mientras está en marcha, y después reinícialo para que todos los servicios lean los archivos restaurados:

sudo ironflock appliance restore appliance-secrets.tar.gz --force sudo ironflock appliance restart

El .env del appliance anterior a la restauración se conserva como .env.prev. En una máquina nueva, instala ironflock, ejecuta sudo ironflock appliance restore appliance-secrets.tar.gz y después instala el appliance como de costumbre, con la Instance Key y las opciones que usabas, por ejemplo --tls. Consulta ironflock appliance backup e ironflock appliance restore.

Retirada del servicio

  1. Traslada o libera la licencia mientras el appliance siga en línea — consulta Mover tu licencia a nuevo hardware.

  2. Elimina el software:

    sudo ironflock appliance remove --purge sudo ironflock agent remove

    ironflock appliance remove --purge elimina los servicios, los contenedores y la red del appliance, el inicio de sesión de Docker en el registro de IronFlock, los cambios que su instalación hizo en el host y, con --purge, también sus datos: el directorio de instalación /opt/ironflock con .env y license.env, los volúmenes de Docker y las imágenes. Después, ironflock agent remove elimina el agente de dispositivo propio del appliance. Cada comando enumera lo que elimina y pregunta antes; --yes responde. Docker sigue instalado, y también ironflock en /usr/local/bin. Consulta ironflock appliance remove e ironflock agent remove.

  3. Si el hardware sale de tus instalaciones, borra su disco — los comandos anteriores eliminan archivos, pero no los sobrescriben.

Ajustes que debilitan la seguridad

Algunos ajustes existen solo para la resolución de problemas. No los definas en producción:

  • AGENT_UPDATE_ALLOW_UNSIGNED — permite que un agente de dispositivo aplique actualizaciones sin firmar. Solo funciona como until=<time>, como máximo 24 horas por delante, y después caduca por sí solo.
  • TUNNEL_AUTHZ_ENFORCE=false — permite que los dispositivos abran túneles sin demostrar su identidad.
  • ?tls.rejectUnauthorized=false en SMTP_CONNECTION_URI — acepta cualquier certificado de tu servidor de correo.
  • --2fa available — nunca se piden segundos factores.
Last updated on