Un perfil de dispositivo describe cómo se comporta un tipo de dispositivo. Cada dispositivo usa exactamente un perfil. Si cambias el perfil, todos los dispositivos que lo usan lo siguen. Crea un perfil por cada tipo de dispositivo: un perfil por modelo de sensor, por familia de firmware o por necesidad de seguridad (por ejemplo, un perfil TLS y otro para dispositivos antiguos que no pueden usar TLS).
Abre los perfiles en Device Profiles en el menú IoT. Para ver se necesita el rol User; para cambiar, Admin. La estrategia de aprovisionamiento y las claves necesitan el permiso independiente para gestionar el aprovisionamiento (administradores).
La lista de perfiles
La lista muestra Name, Transport, Online rule, Devices (el recuento se actualiza cada 30 s) y Updated, con las insignias Default, Built-in y Platform template. Busca por nombre y filtra por transporte y regla de conexión.
Para crear un perfil, selecciona New profile, introduce un Name, una Description y el Transport, y selecciona Create profile. Los límites, los topics y los inicios de sesión parten de los valores predeterminados del protocolo; los cambias en la página del perfil. Debes elegir una regla de conexión antes de poder guardar el perfil.
El perfil predeterminado
Cada organización tiene exactamente un perfil predeterminado. Hermetry crea un perfil llamado Default la primera vez que lo necesita. Utiliza:
- la regla de conexión Live connection,
- el esquema de topics predeterminado,
- solo inicio de sesión con token de acceso,
- los límites estándar del protocolo,
- aprovisionamiento Disabled,
- Solo TLS (puerto 8883).
Tu primer perfil propio también se convierte en el predeterminado. Para hacer predeterminado otro perfil, ábrelo y selecciona Make default. Los dispositivos nuevos que no indiquen ningún perfil recibirán el predeterminado.
Perfiles integrados
Algunos protocolos incluyen un perfil integrado, marcado como Built-in profile. Hermetry lo crea la primera vez que se necesita:
| Perfil integrado | Usado por |
|---|---|
| LoRaWAN EU868 Class A OTAA (1.0.3) | Sensores LoRaWAN añadidos con New device > LoRaWAN device |
| Gateway LoRaWAN | Pasarelas Basics Station |
| El perfil del protocolo de cámaras | Cámaras y grabadores de ese protocolo |
Un perfil integrado conserva su transporte («A built-in profile keeps its transport: devices of its protocol are registered with it.») y no se puede eliminar. Lo demás del perfil es editable, y puedes renombrarlo.
Perfiles desde una plantilla
Un dispositivo licenciado que reclames recibe una copia del perfil de su modelo, creado a partir de una plantilla de la plataforma. La cabecera del perfil indica de qué plantilla y versión procede, y algunos campos muestran from template. Este perfil solo acepta certificados X.509 («This profile accepts X.509 certificates only»). El aprovisionamiento permanece en Disabled en una copia.
Secciones del perfil
| Pestaña | Lo que configuras |
|---|---|
| General | Name (de 1 a 128 caracteres, único en tu organización), Description (hasta 2.000 caracteres). Muestra cuándo se creó el perfil y cuándo se modificó por última vez, su ID y qué lo usa (In use). |
| Transporte y autenticación | Transporte, inicios de sesión permitidos, MQTT sin cifrar, token en la URL, redes permitidas, comandos permitidos sin TLS, esquemas de topics, topics personalizados. |
| Estado en línea | Cómo decide Hermetry que un dispositivo está en línea. |
| Límites | Límites de tasa, tamaños de payload, la ventana de mensajes en vuelo, la inactividad, los hijos de pasarela y el tiempo de espera predeterminado de comandos. |
| Claves de telemetría | Las claves que envían los dispositivos, con etiquetas, unidades, decimales y rangos. |
| Claves de configuración | Las claves cfg.* que puedes establecer en los dispositivos. |
| Aprovisionamiento | Cómo se registran solos los dispositivos sin credenciales. |
Otros módulos añaden pestañas: Alarm rules, Commands, Firmware, LoRaWAN (perfiles LoRaWAN) y SNMP (perfiles SNMP).
Transporte & autenticación
Transporte
| Transporte | Dispositivos |
|---|---|
| MQTT | Conexión por MQTT. |
| HTTP | Envío solo por HTTPS. |
| MQTT y HTTP | Cualquiera de los dos. |
| LoRaWAN | Se unen a través del servidor de red LoRaWAN de Hermetry. No inician sesión por sí mismos. |
| Un protocolo de sondeo | La plataforma los consulta (sondeo) a través de un endpoint (agentes SNMP, cámaras, grabadores). Los ajustes de MQTT, token y red no se aplican. |
Cambiar el transporte nunca cambia la regla de conexión; una regla que el transporte no puede usar impide guardar.
Allowed authentication (al menos uno): Access token, MQTT basic (username and password), X.509 certificate. Consulta Device credentials.
Seguridad de transporte
| Ajuste | Predeterminado | Efecto |
|---|---|---|
| MQTT sin cifrar | Solo TLS (puerto 8883) | Un dispositivo que inicie sesión en el puerto sin cifrar 1883 será rechazado. Cambiar un perfil a solo TLS termina de inmediato las sesiones sin cifrar de sus dispositivos. Plain MQTT allowed (port 1883) es para dispositivos que no pueden usar TLS. |
| Token en la URL (dispositivos que no pueden enviar encabezados) | Desactivado | Permite POST /api/v1/{token}/telemetry y /attributes. Este perfil pasa a ser solo HTTP: se rechaza cualquier inicio de sesión MQTT de sus dispositivos. |
| Redes permitidas | Vacío (cualquier red) | Hasta 64 redes IPv4 o IPv6 (203.0.113.0/24) o direcciones individuales. Los dispositivos fuera de ellas son rechazados (MQTT CONNACK 5, HTTP 403). |
| Comandos permitidos sin TLS | Vacío | Hasta 32 nombres exactos de comando que un dispositivo puede recibir en una sesión sin cifrar. Cualquier otro comando espera a una sesión TLS. |
Aviso
Incluye solo comandos sin TLS cuyo mal uso sea inofensivo, como sys.info o sys.ping. Nunca incluyas sys.reboot, ota.check ni cert.renew. Las actualizaciones de firmware y los ajustes del dispositivo nunca se envían sin cifrar, y un restablecimiento de fábrica nunca se envía.
Topic schemes (al menos uno):
| Esquema | Topics |
|---|---|
| El esquema predeterminado | v1/telemetry, v1/attributes, v1/rpc/… y el resto del conjunto predeterminado. Los topics v1/… desconocidos son rechazados. |
| Compatible con sistemas heredados | Solo v1/devices/me/telemetry y v1/devices/me/attributes, para firmware existente: sin comandos, reclamación, aprovisionamiento ni topics de pasarela. |
Con ambos activos, el firmware antiguo y el nuevo comparten un perfil; los mensajes de bajada siguen lo que cada dispositivo se suscribió.
Custom topics (Accept topics outside v1/ as telemetry): cualquier topic fuera de v1/ se acepta como telemetría. Un objeto JSON se convierte en claves; cualquier otra cosa se convierte en una única clave raw con tamaño limitado.
| Campo | Predeterminado | Rango |
|---|---|---|
| Anteponer el topic a las claves | Desactivado: cuando la misma clave llega por dos topics, gana la última escritura | — |
| Profundidad máxima del topic (niveles) | 8 | 1 a 16 |
| Longitud máxima del topic (caracteres) | 128 | 16 a 256 |
| Topics distintos por dispositivo | 50 | 1 a 1.000 |
| Tamaño máximo del payload sin procesar (bytes) | 4,096 | 256 a 65.536, nunca por encima del límite de payload |
Estado de conexión
| Regla | Un dispositivo está en línea cuando |
|---|---|
| Conexión en vivo | Mantiene su conexión MQTT. Recomendado para dispositivos que mantienen MQTT abierto. |
| Mensaje reciente | Su último mensaje es más reciente que Expected interval (seconds) × Factor. La página muestra «Shown offline after … without a message.» |
| Solo última vez visto | Nunca se muestra como en línea o fuera de línea. Las listas muestran cuándo se vio por última vez. |
Intervalo esperado va de 60 a 604 800 segundos y es obligatorio para Mensaje reciente. Factor va de 1,5 a 10 (un decimal), 3 por defecto. Los dispositivos HTTP y LoRaWAN no mantienen conexión, así que no se ofrece Conexión en vivo para ellos; los dispositivos por sondeo usan Solo última conexión vista. Consulte Estado de conexión y actividad.
Límites
Límites de tasa usan la forma count:seconds; varias ventanas se aplican juntas, cada una más larga que la anterior (como máximo 4 por familia, un recuento de 1 a 1 000 000 en una ventana de 1 segundo a 1 día). Valor por defecto del protocolo restablece una familia.
| Familia | Por defecto |
|---|---|
| Mensajes de telemetría | 10:1,300:60 |
| Puntos de telemetría | 200:1,6000:60 |
| Actualizaciones de atributos | 5:1,60:60 |
| Solicitudes de atributos | 5:1,60:60 |
| Mensajes RPC | 5:1,60:60 |
| Solicitudes de certificados | 1:3600 |
| Conexiones | 6:60 |
Hermetry aplica los límites de mensajes de telemetría, de puntos de telemetría y de actualizaciones de atributos a cada dispositivo. Al superar un límite, el mensaje se confirma y se descarta. Los propietarios y administradores reciben un aviso por dispositivo cada hora. Cada dispositivo recibe sus límites efectivos en el atributo compartido session_limits.
| Campo | Por defecto | Rango |
|---|---|---|
| Mensajes de repetición por segundo | Vacío: la mitad del recuento de telemetría por segundo | 1 a 10 000 |
| Carga útil máxima de mensaje (bytes) | 65,536 | 1 024 a 65 536 |
| Carga útil máxima de enlace descendente (bytes) | 65,536 | 1 024 a 65 536 |
| Máximo de mensajes no confirmados (MQTT) | 20 | 1 a 1 000 |
| Tiempo de inactividad (segundos) | 600 | 10 a 604 800. Un dispositivo que no envía nada durante este tiempo está inactivo (no es lo mismo que estar desconectado). |
| Máximo de hijos de una pasarela | 500 | 0 a 10 000 |
| Perfil de los nuevos hijos | Perfil de hijo genérico | Cualquier perfil; se usa cuando la pasarela no indica tipo |
| Tiempo de espera RPC por defecto (segundos) | 10 | 1 a 300 |
Claves de telemetría
Liste las claves que envían los dispositivos (hasta 500). Cada clave tiene un Tipo (Número, Número entero, Sí / no, Texto, JSON) y, opcionalmente, una Unidad (hasta 32 caracteres), una Etiqueta (hasta 128), Mín, Máx y Decimales (0 a 10). Los paneles las usan: un medidor toma el rango como escala por defecto. Las claves siguen las reglas de claves: hasta 64 caracteres de A–Z a–z 0–9 _ . -, y no pueden empezar por _, fw_, current_fw_ o cfg..
Las claves que no están en la lista se siguen almacenando.
Al eliminar o renombrar claves, el perfil muestra Las claves eliminadas siguen en uso con las reglas de alarma y otros lectores que las leen, y ofrece Actualizarlas a los nuevos nombres o Mantener.
Claves de configuración
Las claves cfg.* que un dispositivo acepta como atributos compartidos, cada una con un tipo, etiqueta y límites: Mín, Máx, Valores permitidos (hasta 100), Longitud mín y Longitud máx, y Secreto (solo escritura). Consulte Atributos.
Aprovisionamiento
La estrategia (Desactivado, Permitir crear dispositivos nuevos, Solo dispositivos preaprovisionados) y las claves de aprovisionamiento. Consulte Añadir y reclamar dispositivos.
Guardar cambios
- Guardar cambios envía solo los campos que modificó; Descartar los elimina. Sus cambios permanecen en el formulario mientras cambia de pestaña.
- Al guardar cambios en el transporte, los inicios de sesión, las redes, los esquemas de temas o los límites de un perfil en uso, aparece ¿Cambiar cómo se conectan los dispositivos de …?: las sesiones activas que ya no cumplen los requisitos terminan ahora. Seleccione Guardar y aplicar.
- Si otra persona guardó el perfil después de que lo abrió, su guardado se rechaza: «Otra persona guardó este perfil después de que lo abriera.» Use Recargar perfil.
Duplicar y eliminar
- Duplicar perfil crea «un perfil nuevo con todos los ajustes de este; el aprovisionamiento empieza desactivado y no se copia ninguna clave», llamado
<name> (copy). - Eliminar perfil se rechaza para el perfil por defecto («primero haga otro perfil el predeterminado»), un perfil integrado, una plantilla de la plataforma y un perfil que aún usan dispositivos, reglas de alarma o comandos («Todavía lo usan …: muévalos o elimínelos primero.»).

