Novedad: el cortafuegos de IA supervisa toda la plataforma y explica cada incidente con palabras sencillas. Vea cómo funciona

Perfiles de dispositivo

Cada sección y campo de un perfil de dispositivo: transporte, inicios de sesión, temas, regla de conexión, límites, claves y aprovisionamiento, con valores por defecto y reglas de eliminación.

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 integradoUsado por
LoRaWAN EU868 Class A OTAA (1.0.3)Sensores LoRaWAN añadidos con New device > LoRaWAN device
Gateway LoRaWANPasarelas Basics Station
El perfil del protocolo de cámarasCá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ñaLo que configuras
GeneralName (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ónTransporte, 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íneaCómo decide Hermetry que un dispositivo está en línea.
LímitesLí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íaLas claves que envían los dispositivos, con etiquetas, unidades, decimales y rangos.
Claves de configuraciónLas claves cfg.* que puedes establecer en los dispositivos.
AprovisionamientoCó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

TransporteDispositivos
MQTTConexión por MQTT.
HTTPEnvío solo por HTTPS.
MQTT y HTTPCualquiera de los dos.
LoRaWANSe unen a través del servidor de red LoRaWAN de Hermetry. No inician sesión por sí mismos.
Un protocolo de sondeoLa 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

AjustePredeterminadoEfecto
MQTT sin cifrarSolo 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)DesactivadoPermite 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 permitidasVací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 TLSVacíoHasta 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):

EsquemaTopics
El esquema predeterminadov1/telemetry, v1/attributes, v1/rpc/… y el resto del conjunto predeterminado. Los topics v1/… desconocidos son rechazados.
Compatible con sistemas heredadosSolo 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.

CampoPredeterminadoRango
Anteponer el topic a las clavesDesactivado: cuando la misma clave llega por dos topics, gana la última escritura—
Profundidad máxima del topic (niveles)81 a 16
Longitud máxima del topic (caracteres)12816 a 256
Topics distintos por dispositivo501 a 1.000
Tamaño máximo del payload sin procesar (bytes)4,096256 a 65.536, nunca por encima del límite de payload

Estado de conexión

ReglaUn dispositivo está en línea cuando
Conexión en vivoMantiene su conexión MQTT. Recomendado para dispositivos que mantienen MQTT abierto.
Mensaje recienteSu último mensaje es más reciente que Expected interval (seconds) × Factor. La página muestra «Shown offline after … without a message.»
Solo última vez vistoNunca 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.

FamiliaPor defecto
Mensajes de telemetría10:1,300:60
Puntos de telemetría200:1,6000:60
Actualizaciones de atributos5:1,60:60
Solicitudes de atributos5:1,60:60
Mensajes RPC5:1,60:60
Solicitudes de certificados1:3600
Conexiones6: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.

CampoPor defectoRango
Mensajes de repetición por segundoVacío: la mitad del recuento de telemetría por segundo1 a 10 000
Carga útil máxima de mensaje (bytes)65,5361 024 a 65 536
Carga útil máxima de enlace descendente (bytes)65,5361 024 a 65 536
Máximo de mensajes no confirmados (MQTT)201 a 1 000
Tiempo de inactividad (segundos)60010 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 pasarela5000 a 10 000
Perfil de los nuevos hijosPerfil de hijo genéricoCualquier perfil; se usa cuando la pasarela no indica tipo
Tiempo de espera RPC por defecto (segundos)101 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.»).

Relacionado