Un perfil de dispositivo describe cómo se comporta un tipo de dispositivo. Cada dispositivo usa exactamente un perfil. Si cambia el perfil, todos los dispositivos que lo usan lo siguen. Cree un perfil por 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).
Abra los perfiles en Device Profiles en el menú IoT. Ver requiere el rol User; modificar requiere Admin. La estrategia de aprovisionamiento y las claves requieren 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 distintivos para Default, Built-in y Platform template. Busque por nombre y filtre por transporte y regla de estado en línea.
Para crear un perfil, seleccione New profile, introduzca un Name, una Description y el Transport, y seleccione Create profile. Los límites, los topics y los inicios de sesión parten de los valores predeterminados del protocolo; los cambia en la página del perfil. Debe elegir una regla de estado en línea 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 estado en línea 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,
- TLS only (port 8883).
Su primer perfil propio también pasa a ser el predeterminado. Para hacer predeterminado otro perfil, ábralo y seleccione Make default. Los dispositivos nuevos que no indiquen perfil reciben 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 |
| LoRaWAN gateway | Pasarelas Basics Station |
| El perfil del protocolo de cámaras | Cámaras y grabadores de ese protocolo |
Un perfil integrado conserva su transporte («Un perfil integrado conserva su transporte: los dispositivos de su protocolo se registran con él.») y no se puede eliminar. Lo demás del perfil es editable, y puede renombrarlo.
Perfiles a partir de una plantilla
Un dispositivo licenciado que reclame recibe una copia del perfil de su modelo, creado a partir de una plantilla de la plataforma. El encabezado del perfil indica de qué plantilla y versión procede, y algunos campos muestran from template. Un perfil así acepta solo certificados X.509 («Este perfil acepta solo certificados X.509»). El aprovisionamiento permanece en Disabled en una copia.
Secciones del perfil
| Pestaña | Qué configura |
|---|---|
| General | Name (de 1 a 128 caracteres, único en su 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). |
| Transport & auth | Transporte, inicios de sesión permitidos, MQTT sin cifrar, token en la URL, redes permitidas, comandos permitidos sin TLS, esquemas de topics y topics personalizados. |
| Online status | Cómo decide Hermetry que un dispositivo está en línea. |
| Limits | Límites de frecuencia, tamaños de payload, la ventana de mensajes en vuelo, inactividad, dispositivos hijos de pasarela y el tiempo de espera predeterminado de comandos. |
| Telemetry keys | Las claves que envían los dispositivos, con etiquetas, unidades, decimales y rangos. |
| Configuration keys | Las claves cfg.* que puede establecer en los dispositivos. |
| Provisioning | 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).
Transport & auth
Transport
| Transporte | Dispositivos |
|---|---|
| MQTT | Conexión por MQTT. |
| HTTP | Envío solo por HTTPS. |
| MQTT and 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 mediante 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 estado en línea; una regla que el transporte no puede usar impide guardar.
Allowed authentication (al menos una): Access token, MQTT basic (username and password), X.509 certificate. Consulte Device credentials.
Transport security
| Ajuste | Predeterminado | Efecto |
|---|---|---|
| Plain MQTT | TLS only (port 8883) | Un dispositivo que inicie sesión por el puerto sin cifrar 1883 es 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 in the URL (devices that cannot send headers) | Desactivado | Permite POST /api/v1/{token}/telemetry y /attributes. Un perfil así pasa a ser solo HTTP: se rechaza cualquier inicio de sesión MQTT de sus dispositivos. |
| Allowed networks | 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). |
| Commands allowed without 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. |
Advertencia
Incluya solo comandos sin TLS cuyo uso indebido sea inofensivo, como sys.info o sys.ping. No incluya nunca 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. |
| Legacy compatible | Solo v1/devices/me/telemetry y v1/devices/me/attributes, para firmware existente: sin comandos, reclamación, aprovisionamiento ni topics de pasarela. |
Con ambos activados, 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 clave raw de tamaño limitado.
| Campo | Predeterminado | Rango |
|---|---|---|
| Prefix keys with the topic | Desactivado: si la misma clave llega por dos topics, gana la última escritura | — |
| Max topic depth (levels) | 8 | De 1 a 16 |
| Max topic length (characters) | 128 | De 16 a 256 |
| Distinct topics per device | 50 | De 1 a 1.000 |
| Max raw payload (bytes) | 4,096 | De 256 a 65.536, nunca por encima del límite de payload |
Estado en línea
| Regla | Un dispositivo está en línea cuando |
|---|---|
| Live connection | Mantiene su conexión MQTT. Recomendado para dispositivos que mantienen MQTT abierto. |
| Recent message | Su último mensaje es más reciente que Expected interval (seconds) × Factor. La página muestra «Se muestra sin conexión tras … sin mensaje.» |
| Last seen only | 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, por lo que no se ofrece Conexión en directo para ellos; los dispositivos sondeados usan Solo última conexión vista. Consulte Estado de conexión y actividad.
Límites
Los límites de tasa usan la forma count:seconds; se aplican varias ventanas a la vez, cada una más larga que la anterior (como máximo 4 por familia, un recuento de 1 a 1.000.000 en ventanas de 1 segundo a 1 día). Valor predeterminado del protocolo restablece una familia.
| Familia | Predeterminado |
|---|---|
| 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, puntos de telemetría y actualizaciones de atributos a cada dispositivo. Si se supera un límite, el mensaje se confirma y se descarta. Los propietarios y administradores reciben un aviso por dispositivo y hora. Cada dispositivo recibe sus límites efectivos en el atributo compartido session_limits.
| Campo | Predeterminado | Rango |
|---|---|---|
| Mensajes de reproducció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 downlink (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 predeterminado (segundos) | 10 | 1 a 300 |
Claves de telemetría
Enumere 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 indicador toma el rango como escala predeterminada. 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_ ni cfg..
Las claves que no figuran en la lista se siguen almacenando. Rechazar claves que no figuran en la lista se guarda, pero todavía no se aplica; la página lo indica.
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). Desviación de configuración (Informar diferencias o Forzar) se guarda, pero todavía no se aplica. 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.
- 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 muestra ¿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 abriera, 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», con el nombre
<name> (copy). - Eliminar perfil se rechaza para el perfil predeterminado («primero haga predeterminado otro perfil»), para un perfil integrado, para una plantilla de la plataforma y para un perfil que aún usan dispositivos, reglas de alarma o comandos («Aún en uso por …: muévalos o elimínelos primero.»).