- mamux.org/
- Posts/
- Construyendo una interfaz de gestión multi-servidor para FIDO Device Onboard (FDO)/
Construyendo una interfaz de gestión multi-servidor para FIDO Device Onboard (FDO)
Un viaje desde la administración de un solo servidor hasta una gestión integral multi-servidor de FDO
Introducción #
FIDO Device Onboard (FDO) está revolucionando la forma en que conectamos de manera segura dispositivos IoT a escala. Sin embargo, a medida que los despliegues de FDO crecen, las organizaciones suelen encontrarse gestionando múltiples servidores FDO con diferentes roles: Fabricantes que crean vouchers de propiedad, Servidores de Rendezvous que facilitan el descubrimiento de dispositivos, y Owners que gestionan certificados y configuraciones de dispositivos.
Nos propimos construir una interfaz web que pudiera simplificar esta complejidad, facilitando la gestión de múltiples servidores FDO desde una única interfaz. Esta es la historia de cómo transformamos una herramienta básica de administración de un solo servidor en una plataforma integral de gestión multi-servidor.
El desafío: Gestionar múltiples servidores FDO #
En despliegues reales de FDO, normalmente tienes tres roles de servidor distintos:
- Servidores Fabricante: Generan y gestionan vouchers de propiedad para dispositivos durante su fabricación
- Servidores Rendezvous: Facilitan la conexión inicial entre dispositivos y sus propietarios durante el proceso de onboarding
- Servidores Owner: Gestionan certificados de dispositivos, vouchers de propiedad y configuraciones finales de dispositivos
Antes de esta interfaz, los administradores tenían que:
- Llevar un registro manual de múltiples URLs de servidores
- Cambiar entre diferentes pestañas del navegador o herramientas para cada servidor
- Recordar qué APIs proporciona cada rol de servidor
- Probar manualmente las conexiones para verificar la salud del servidor
Sabíamos que debía haber una mejor manera.
La visión: Una interfaz, muchos servidores #
Nuestro objetivo era simple: crear una única interfaz donde puedas gestionar todos tus servidores FDO, independientemente de su rol o ubicación.
Los requisitos clave incluían:
- Soporte para los tres roles de servidor FDO
- Cambio fácil de servidor con un solo clic
- Navegación basada en roles mostrando solo las APIs relevantes
- Monitoreo de salud de la conexión
- Funciona de forma independiente o como plugin del OpenShift Console
- Compatible con versiones anteriores con despliegues de un solo servidor
El viaje: De simple a sofisticado #
Fase 1: Entender el panorama #
Comenzamos con una interfaz básica de un solo servidor que podía:
- Mostrar vouchers de propiedad
- Subir certificados CA de dispositivos
- Mostrar información de rendezvous
Funcionaba bien para despliegues simples, pero los usuarios con múltiples servidores se encontraban manejando múltiples ventanas del navegador y perdiendo la pista de qué servidor estaban viendo.
Fase 2: Introducir contexto del servidor #
El avance llegó cuando implementamos un sistema de contexto del servidor. Esto permite que toda la interfaz “sepa” con qué servidor estás trabajando actualmente y configure automáticamente todas las llamadas API para usar ese servidor.
La pieza central es un selector de servidores en la cabecera de la aplicación. Con un solo clic, puedes:
- Ver todos tus servidores configurados de un vistazo
- Cambiar entre servidores al instante
- Ver el rol y estado de conexión de cada servidor
- Ir a la gestión del servidor
Fase 3: Navegación inteligente basada en roles #
Diferentes roles de servidor FDO proporcionan diferentes APIs. Un servidor Fabricante tiene APIs de vouchers e información de rendezvous, pero no tiene la API de CA de dispositivos. Un servidor Owner tiene todo excepto información de rendezvous.
Implementamos una navegación inteligente que muestra solo los elementos del menú relevantes para el rol del servidor seleccionado:
- Fabricante: Salud, Vouchers, Información de Rendezvous
- Owner: Salud, Vouchers, CAs de Dispositivos, Direcciones RV TO2
- Rendezvous: Salud, CAs de Dispositivos
Ya no hay confusión sobre qué APIs están disponibles en cada servidor: la interfaz te lo indica automáticamente.
La navegación se adapta según el rol del servidor - aquí mostrando el rol Fabricante con Vouchers e Información de Rendezvous
Misma interfaz con el rol Owner seleccionado - ahora mostrando CAs de Dispositivos y Direcciones RV TO2
Fase 4: Gestión de servidores simplificada #
Construimos una interfaz integral de gestión de servidores donde puedes:
Agregar Nuevos Servidores: Simplemente proporciona un nombre, URL y rol. La interfaz prueba la conexión automáticamente antes de guardar.
Ver Todos los Servidores de un Vistazo: Una tabla que muestra todos tus servidores con:
- Nombre y URL del servidor
- Rol (con insignias de colores)
- Estado de conexión (saludable/no saludable)
- Acciones rápidas (editar, probar conexión, eliminar)
Probar Conexiones: Verificaciones de salud con un solo clic que confirman que tus servidores están respondiendo correctamente.
Fase 5: Resolver el problema de cambio de contexto #
Las pruebas iniciales revelaron un problema sutil pero crítico: cuando los usuarios cambiaban de servidor e intentaban subir certificados, ¡los archivos seguían yendo al servidor original!
Este fue nuestro momento “ajá”. Nos dimos cuenta de que cada parte de la interfaz debía respetar el contexto del servidor: no solo las operaciones de lectura, sino también las subidas, ediciones y eliminaciones.
Actualizamos sistemáticamente cada componente que se comunicaba con los servidores FDO para usar el contexto del servidor actual. Ahora, todo: desde ver vouchers hasta subir certificados - siempre usa el servidor que has seleccionado.
Fase 6: Flexibilidad de despliegue #
Diseñamos la interfaz para funcionar en dos modos de despliegue:
Modo Independiente: Usa el almacenamiento local del navegador para guardar las configuraciones de tus servidores. Perfecto para desarrollo o cuando se ejecuta fuera de OpenShift.
Modo Plugin del OpenShift Console: Lee las configuraciones de servidores desde Definiciones de Recursos Personalizados (CRDs) de Kubernetes. Los administradores pueden gestionar servidores mediante kubectl o el OpenShift Console, y la interfaz los descubre automáticamente.
Esta flexibilidad significa que la interfaz funciona para todos: desde desarrolladores probando localmente hasta despliegues de producción en OpenShift.
Características principales #
Gestión Multi-Servidor #
- Agregar, editar y eliminar servidores con una interfaz intuitiva
- Selector de servidores en la cabecera de la aplicación para cambio instantáneo
- Selección persistente del servidor: la interfaz recuerda con qué servidor estás trabajando
- Monitoreo de salud de conexión con indicadores de estado en tiempo real
Interfaz Basada en Roles #
- Descubrimiento automático de APIs: la interfaz se adapta al rol de cada servidor
- Insignias de colores para roles (Fabricante: Azul, Owner: Verde, Rendezvous: Púrpura)
- Navegación dinámica mostrando solo las APIs disponibles
- Operaciones conscientes del rol: subir vouchers solo a servidores que lo soporten
Gestión de Vouchers de Propiedad #
- Listar todos los vouchers con GUID, versión del protocolo e información de rendezvous
- Ver detalles del voucher incluyendo información del dispositivo
- Subir nuevos vouchers con soporte multi-archivo
- Actualizar vouchers existentes reemplazando el archivo PEM
- Eliminar vouchers con diálogos de confirmación
Gestión de Certificados CA de Dispositivos #
- Ver todos los certificados CA de dispositivos con fechas de expiración e huellas digitales
- Subir certificados en lote (formatos PEM, CRT, CER)
- Eliminar certificados de forma segura con advertencias de impacto
- Detalles del certificado mostrando información completa del certificado
Gestión de Información de Rendezvous #
- Configurar endpoints de rendezvous para descubrimiento de dispositivos
- Gestionar múltiples entradas RV por servidor
- Editar y eliminar configuraciones de rendezvous
Gestión de Direcciones RV TO2 #
- Configurar direcciones TO2 (Transfer Ownership 2) para entrega de dispositivos
- Gestionar protocolos de transporte y configuraciones de endpoints
- Editar y actualizar configuraciones TO2 a medida que evolucionan los despliegues
Mejoras de Experiencia de Usuario #
- Manejo de errores en tiempo real con notificaciones toast
- Alertas de conexión cuando los servidores se vuelven no disponibles
- Estados de carga con skeleton loaders de PatternFly
- Diálogos de confirmación previniendo eliminaciones accidentales
- Subida multi-archivo con seguimiento de progreso
- Estados vacíos guiando a los usuarios cuando no hay datos
El stack tecnológico #
Construimos esta interfaz usando tecnologías web modernas optimizadas para aplicaciones empresariales:
- React 18 para una arquitectura responsiva basada en componentes
- TypeScript para seguridad de tipos y mejor experiencia de desarrollo
- PatternFly 6 para componentes de interfaz empresarial y accesibilidad
- Generación de código OpenAPI para clientes API con seguridad de tipos
- Servidor Mock Express.js para desarrollo local y pruebas
El sistema de diseño PatternFly fue crucial: proporcionó
- Accesibilidad (cumplimiento WCAG 2.1 AA) de forma predeterminada
- Patrones UX consistentes familiares para usuarios de OpenShift
- Componentes de calidad empresarial (tablas, modales, formularios, alertas)
- Diseño responsivo que funciona en cualquier tamaño de pantalla
Impacto en el mundo real #
Esta interfaz resuelve problemas reales para administradores de FDO:
Antes: “Tengo tres servidores FDO para pruebas, staging y producción. Llevo un archivo de texto con URLs y tengo tres ventanas del navegador abiertas. Cuando subo vouchers, a veces olvido qué pestaña es cuál y subo al entorno equivocado.”
Después: “Ahora tengo los tres servidores configurados en la interfaz. El selector de servidores me muestra exactamente con cuál estoy trabajando. La insignia del fabricante es azul, así que sé al instante que estoy en el servidor de pruebas. Subo vouchers con confianza sabiendo que van al lugar correcto.”
Antes: “Nuestro servidor de rendezvous no tiene la API de vouchers, pero nuestra interfaz antigua mostraba el menú de vouchers de todas formas. Al hacer clic solo daba errores. Muy confuso.”
Después: “Cuando seleccionamos nuestro servidor de rendezvous, la interfaz solo muestra Salud y CAs de Dispositivos: exactamente lo que ese servidor soporta. La interfaz te guía a lo que realmente puedes hacer.”
Antes: “Ejecutamos en OpenShift y nuestro equipo de seguridad gestiona servidores FDO como CRDs. Tenía que pedirles las URLs cada vez que algo cambiaba.”
Después: “La interfaz descubre automáticamente todos los servidores FDO en nuestro namespace. Cuando el equipo agrega un nuevo servidor, simplemente aparece en mi lista de servidores. No se necesita configuración.”
Servidor Mock de Desarrollo #
Para facilitar el desarrollo local, creamos un servidor FDO mock completo:
- Todas las APIs FDO implementadas con respuestas realistas
- Persistencia basada en archivos: los datos sobreviven reinicios del servidor
- Instancias aisladas: cada servidor mock obtiene su propio directorio de datos
- Simulación multi-servidor: ejecutar múltiples mocks en diferentes puertos
- Datos de ejemplo precargados para pruebas inmediatas
Los desarrolladores pueden comenzar a codificar inmediatamente con:
npm run start:dev:mock
Esto inicia tanto el servidor mock FDO como el servidor de desarrollo de la interfaz, listo para usar.
Lecciones aprendidas #
1. El contexto lo es todo #
Construir una aplicación verdaderamente consciente del contexto significa que cada interacción debe respetar el contexto actual. Perder incluso una operación (como hicimos inicialmente con las subidas) rompe la experiencia del usuario.
2. Diseñar para la flexibilidad #
Soportar múltiples modos de despliegue (independiente y plugin de OpenShift) desde el primer día hizo la arquitectura más robusta. El patrón del adaptador de almacenamiento hizo esto transparente.
3. Las interfaces basadas en roles son poderosas #
Mostrar a los usuarios solo lo relevante para su contexto actual (rol del servidor) reduce la carga cognitiva y previene errores. La navegación dinámica basada en las capacidades del servidor fue un cambio radical.
4. Probar con flujos de trabajo reales #
El error de subir al servidor equivocado solo apareció al probar flujos de trabajo realistas: cambiar de servidor y luego subir inmediatamente. Las pruebas automáticas capturaron errores de compilación, pero las pruebas con usuarios capturaron problemas de UX.
5. La experiencia del desarrollador importa #
El servidor mock transformó el desarrollo. Los ingenieros pueden probar escenarios multi-servidor localmente sin desplegar servidores FDO reales. Esto aceleró significativamente el desarrollo.
Próximos pasos #
Estamos continuando mejorando la interfaz basándonos en los comentarios de los usuarios:
- Operaciones por lote: Seleccionar múltiples vouchers o certificados para acciones en lote
- Advertencias de expiración de certificados: Alertas proactivas para CAs de dispositivos por expirar
- Búsqueda y filtrado: Filtrado avanzado en todos los tipos de recursos
- Funcionalidad de exportación: Descargar vouchers y certificados en varios formatos
- Visualización de cadena de certificados: Entender las relaciones CA de un vistazo
- Registro de auditoría: Rastrear quién hizo qué cambios y cuándo
- Integración RBAC: Permisos finos para despliegues en OpenShift
Conclusión #
Lo que comenzó como una interfaz simple de un solo servidor evolucionó en una sofisticada plataforma de gestión multi-servidor. Al centrarnos en las necesidades reales de los usuarios: gestionar múltiples servidores FDO con diferentes roles, creamos una herramienta que hace la administración de FDO más rápida, segura e intuitiva.
El viaje nos enseñó que las grandes interfaces no se tratan solo de funciones: se trata de entender los flujos de trabajo del usuario y eliminar la fricción. Ya sea que gestiones dos o veinte servidores FDO, cambiar entre ellos debería ser sin esfuerzo. Ya seas un fabricante subiendo vouchers o un owner gestionando certificados de dispositivos, la interfaz debería guiarte hacia el éxito.
Estamos emocionados por ver cómo la comunidad FDO utiliza esta interfaz para optimizar sus flujos de trabajo de onboarding de dispositivos. Si estás trabajando con FIDO Device Onboard, nos encantaría saber sobre tu experiencia y casos de uso.
Pruébalo tú mismo #
La interfaz es de código abierto y está lista para usar:
- Clonar el repositorio:
git clone https://github.com/mmartinv/go-fdo-server-ui-prototype
- Instalar dependencias:
npm install
- Iniciar el servidor mock y la interfaz:
npm run start:dev:mock
- Abrir tu navegador: Navega a http://localhost:9000
Agrega tu primer servidor, explora la interfaz y descubre cómo la gestión multi-servidor de FDO puede ser simple e intuitiva.
¿Preguntas, comentarios o quieres contribuir? Abrir un issue o pull request en GitHub
Sobre FIDO Device Onboard (FDO) #
FIDO Device Onboard es un protocolo de onboarding automático para dispositivos IoT desarrollado por la FIDO Alliance. Permite que los dispositivos se conecten de manera segura a sus plataformas de gestión sin credenciales preconfiguradas, resolviendo el “problema del desempaquetado” para IoT a escala. Aprende más en fidoalliance.org.