¿Puedo confiarle mi flota?
Esta página resume el modelo de seguridad de la documentación de DeviceChain: lo que se aplica hoy, cómo se firman las versiones y lo que aún no existe. No añade nada a la documentación. Cada sección enlaza con la página que expone el detalle completo.
El aislamiento entre inquilinos se aplica en los datos y en los mensajes.
- Un único conjunto de servicios atiende a todos los inquilinos, así que el aislamiento se aplica en los datos y en los mensajes, no con pods separados.
- Las tablas de un inquilino llevan el inquilino, y un ámbito central de base de datos añade la condición del inquilino a cada lectura y lo estampa en cada escritura. Una consulta con ámbito de inquilino que no tiene inquilino en su contexto se rechaza, no se ejecuta sin filtrar.
- Los asuntos de mensajería tienen ámbito por inquilino, y un segmento de inquilino mal formado se rechaza donde un servicio publica o se suscribe.
- El inquilino de una solicitud se toma de la reclamación de inquilino del token verificado del llamador. Un servicio que llama a otro nombra el inquilino en una cabecera, que solo se acepta tras verificar la firma del token de servicio.
En la documentación: Modelo de seguridad: inquilinos · Multitenencia: aislamiento
Un dispositivo solo puede hablar como sí mismo.
- Los listeners MQTT y NATS del broker usan TLS por defecto. La ingesta HTTP queda protegida por el TLS del ingress de la instancia.
- El broker pide a la plataforma que apruebe cada conexión, y la plataforma vincula la conexión a los asuntos de ese único dispositivo. Un dispositivo no puede publicar en los asuntos de otro dispositivo ni de otro inquilino, ni leer sus comandos.
- Las contraseñas y los tokens de acceso de los dispositivos se guardan solo como resúmenes unidireccionales con clave, bajo una clave derivada de la clave raíz de la instancia. Cada uno se muestra una vez, cuando se establece.
- En el broker MQTT propio de la plataforma, un dispositivo puede autenticarse con un certificado de cliente X.509. La plataforma comprueba la cadena contra un ancla de confianza que el inquilino añadió, en cada conexión, exige el uso de clave de autenticación de cliente y rechaza SHA-1 y las claves débiles. El dispositivo demuestra su clave en el handshake TLS, así que no se guarda ni se envía nada reproducible.
- Una flota puede autorregistrarse con un secreto de 256 bits generado por el servidor, que se guarda solo como un resumen con clave y se compara en tiempo constante. Todas las formas en que puede fallar la autenticación reciben la misma respuesta, de modo que la respuesta nunca dice qué parte era incorrecta.
- Desactivar, rotar o eliminar una credencial rechaza de inmediato las nuevas conexiones y cierra las sesiones abiertas del dispositivo.
En la documentación: Modelo de seguridad: dispositivos · Identidad por certificado · Conectar con un certificado · Autorregistro de dispositivos · Credenciales de dispositivo
Las actualizaciones se comprueban en su integridad y las firman claves que tú registras.
- Los bytes subidos deben coincidir con el tamaño y el resumen SHA-256 declarados del artefacto. Un cuerpo que no coincide se desecha y el artefacto permanece en el estado de subida.
- Los firmantes se registran por inquilino como claves públicas (ECDSA P-256 o Ed25519). La plataforma nunca necesita una clave privada, y si se le da una, la rechaza.
- Por defecto, un artefacto que ningún firmante registrado ha firmado no se puede asignar.
- Una asignación de un artefacto firmado entrega al dispositivo la firma sobre el resumen del artefacto. Tu dispositivo debe verificarla antes de instalar; comprobarla en el dispositivo es tarea del dispositivo, y este debe además imponer la versión y el componente, que la firma no cubre. La ruta de actualización se ha validado de extremo a extremo con el dispositivo de referencia.
- El servicio de actualizaciones forma parte del perfil de instalación por defecto.
En la documentación: Actualizaciones over-the-air: firmantes · Qué significa "verificado" · Firmar actualizaciones
Los secretos almacenados están sellados y son de solo escritura.
- Las credenciales que guarda un inquilino, como los ajustes de conectores y los secretos de cliente del proveedor de identidad, se conservan en un almacén de secretos cifrado.
- Cada valor se sella con su propia clave de datos AES-256-GCM, y esa clave se envuelve con la clave raíz de la instancia.
- Un valor es de solo escritura a través de la API: se resuelve dentro del servidor cuando se usa y nunca se devuelve. Los cambios se auditan por quién, cuándo y qué identificador, nunca por valor.
- La clave raíz tiene un procedimiento documentado de depósito y restauración, y una copia de depósito puede comprobarse con
dcctl secrets escrow verify.
En la documentación: Modelo de seguridad: secretos · Recuperación ante desastres: la clave raíz
A dónde pueden enviar los webhooks y conectores de un inquilino se comprueba en el momento de la conexión.
- Los webhooks, los relés de correo y los conectores de salida se comprueban en el momento en que se establece cada conexión, contra la dirección a la que el nombre se resolvió realmente.
- Las direcciones de bucle local, privadas, de NAT de operador, de enlace local y de metadatos de la nube se rechazan por defecto. Un operador puede permitir direcciones privadas concretas, y una excepción se aplica a todos los inquilinos y a todos los conectores y webhooks.
- En Kafka se comprueba cada broker que el clúster anuncia, no solo las direcciones que configuraste.
En la documentación: Modelo de seguridad: tráfico de salida · Conectores de Salida: a dónde puede enviar un conector
Las solicitudes a la API se autentican y se comprueban contra permisos.
- El inicio de sesión emite tokens firmados con RS256. Cada servicio los valida localmente con un conjunto de claves publicado. Las claves de firma las tiene un solo servicio, selladas bajo la clave raíz de la instancia.
- Los roles llevan permisos, y la API los comprueba en cada llamada. Una pertenencia puede limitarse a los datos de un cliente, y los miembros, invitaciones y roles que un inquilino gestiona por sí mismo no pueden conceder más de lo que posee quien los concede.
- Las cuentas de servicio intercambian un ID de cliente y un secreto por un token de acceso de 5 minutos, sin token de actualización y sin el inicio de sesión de ninguna persona.
- Un inquilino puede exigir el inicio de sesión a través de su propio proveedor de identidad OpenID Connect, y las cuentas pueden exigir un código de una aplicación de autenticación después de la contraseña.
- El endpoint de tokens de servicio y el conjunto de claves de firma se sirven en un puerto interno independiente al que no hace referencia ningún ingress, ruta ni balanceador de carga.
En la documentación: Modelo de seguridad: personas y programas · Autenticación en dos pasos · Endpoints que nunca salen del clúster
Un agente de IA nunca puede hacer más que la persona que lo autorizó.
- El servidor MCP opcional requiere activación expresa. Sus herramientas leen con el token del usuario; en Preview, con acciones de agentes activadas, también permite proponer confirmar o limpiar alarmas. Solo la aprobación de una persona en la consola ejecuta la acción.
- Está detrás de un servidor de autorización OAuth 2.1: código de autorización con PKCE, metadatos RFC 8414, rotación de tokens de actualización y vinculación de audiencia RFC 8707.
- El servidor no tiene ningún token propio. Cada llamada se ejecuta con el token del propio llamador, así que un agente solo lee lo que su usuario puede leer.
En la documentación: MCP: el modelo de seguridad
Los cambios se registran en un diario con quién los hizo.
- Cada servicio registra una entrada de diario, con la identidad que actúa, por cada creación, actualización y eliminación que hace sobre los datos de un inquilino.
- El servicio de inicio de sesión también registra eventos de acceso, como inicios de sesión, inicios de sesión fallidos y resultados del inicio de sesión único.
- Una entrada del registro se escribe en la misma transacción que el cambio que describe.
En la documentación: Modelo de seguridad: auditoría
Comprueba lo que ejecutas antes de ejecutarlo.
- Cada imagen de servicio, el operador, el agente de borde, el administrador del broker, las imágenes del broker de mensajes y de la consola, y el chart de Helm se firman con cosign, sin claves de larga duración. Cada firma queda vinculada al flujo de trabajo de la versión y a la etiqueta, y se registra en un registro de transparencia público.
- Cada imagen lleva además una lista firmada SPDX de lo que contiene (un SBOM), y las imágenes y el chart llevan procedencia de compilación SLSA. El SBOM se genera a partir de la variante amd64.
- Un script comprueba todas las imágenes y el chart, y después demuestra que su propia comprobación puede fallar rechazando una identidad que no puede coincidir y una imagen que no se firmó para la versión.
- Los archivos de dcctl y del agente de borde llevan procedencia de compilación, y cada versión de paquete npm desde la 0.14.0 lleva procedencia de npm.
- La firma empieza en la v0.25.0.
En la documentación: Verificar las versiones · El script de verificación · Qué te dice la verificación y qué no · Paquetes de npm
Notifica una vulnerabilidad de forma privada.
- No notifiques vulnerabilidades mediante incidencias, discusiones ni pull requests públicos.
- Usa la notificación privada de vulnerabilidades de GitHub en la pestaña Security del repositorio (opción preferida), o escribe a admin@devicechain.io si no puedes usar GitHub.
- La política fija objetivos de respuesta para el acuse de recibo, la evaluación y las correcciones según la gravedad. Son objetivos, no garantías.
- A partir de la 1.0.0, las correcciones de seguridad se publican para la última versión menor 1.x y, para los problemas High y Critical, también para la versión menor 1.x anterior durante 90 días después de que salga la siguiente versión menor.
Lo que aún no existe.
Se indican en la documentación como carencias aceptadas. Planifica teniéndolas en cuenta.
- No se ha publicado ninguna prueba de penetración externa.
- Todos los servicios de una instancia comparten un único inicio de sesión de base de datos, así que el aislamiento entre inquilinos en la base de datos se apoya en el ámbito de inquilino de la aplicación, no en permisos de la base de datos.
- La clave raíz de la instancia puede leerla cualquiera que pueda leer el Secret de Kubernetes de la instancia, y todavía no se distribuye ningún gestor de claves externo.
- La autenticación en dos pasos protege solo la contraseña. El requisito de un inquilino vincula la entrada a ese inquilino, no al plano de administración de los operadores: un superusuario con una sesión solo de contraseña puede entrar en un inquilino así, y cada entrada se audita. Quien tiene la contraseña y sigue probando hasta el tope de bloqueo tiene alrededor de un 10% de probabilidad de entrar en un año, y puede mantener bloqueado el autenticador del propietario.
En la documentación: La lista completa de carencias aceptadas
Nada de esta página sustituye tu propia revisión. Si una entrada de aquí es un problema para tu despliegue, la sección correspondiente de la documentación indica dónde se aplica el control.