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

Referencia de permisos

Cada identificador de permiso de IoT con su rol mínimo y lo que permite, los permisos principales de la plataforma, los permisos exclusivos del propietario y las plantillas de grupos de IoT.

Cada acción en Hermetry está protegida por un permiso. Esta página enumera los permisos de los módulos de IoT y los permisos de la plataforma que los administradores de IoT encuentran con más frecuencia, cada uno con su rol mínimo y lo que permite. Cómo se combinan los roles, los grupos y la matriz de Access Rights se explica en Grupos y permisos; las políticas de acceso que restringen aún más el acceso están en Políticas de acceso.

Cómo leer las tablas

ColumnaSignificado
PermisoEl id, tal como aparece en Access Rights (buscar por id) y en Module permissions de la clave API
Lo que permiteEl nombre del permiso tal como lo muestra la consola, ligeramente abreviado
Rol mínimoEl rol integrado más bajo que puede tenerlo. User significa todos los miembros por defecto, Admin significa administradores y propietarios, Owner significa solo propietarios.

Reglas que se aplican a todas las filas:

  • Un miembro tiene un permiso cuando su rol es al menos el rol mínimo y la matriz de la organización lo concede a ese rol, o cuando uno de sus grupos activos lo concede y el rol mínimo es User o Admin.
  • Un grupo puede elevar a un miembro por encima de un mínimo Admin, nunca por encima de un mínimo Owner.
  • Un permiso de un módulo que su plan no incluye no existe para su organización.
  • Una clave API solo tiene los permisos que usted le concede y nunca más de los que tiene su titular; los permisos exclusivos del propietario nunca los tienen las claves API.
  • Algunos permisos pertenecen a funciones que están en desarrollo; están marcados. Concederlos no tiene efecto hasta que la función se publique. Véase En desarrollo.

Permisos de IoT

Dispositivos

PermisoLo que permiteRol mínimo
iot_device.devices.readVer dispositivosUser
iot_device.devices.createCrear dispositivosAdmin
iot_device.devices.updateEditar y desactivar dispositivosAdmin
iot_device.devices.deleteEliminar dispositivosAdmin
iot_device.credentials.manageGestionar las credenciales de los dispositivosAdmin
iot_device.attributes.readVer atributos de dispositivosUser
iot_device.attributes.writeEscribir atributos del servidor y atributos compartidos de los dispositivosAdmin
iot_device.bindings.readVer enlaces de lecturasUser
iot_device.bindings.manageGestionar enlaces de lecturas (con el permiso de gestión propio del registro de destino)Admin

Perfiles de dispositivo

PermisoLo que permiteRol mínimo
iot_device_profile.profiles.readVer perfiles de dispositivoUser
iot_device_profile.profiles.writeCrear, editar y eliminar perfiles de dispositivoAdmin
iot_device_profile.provisioning.manageGestionar la configuración de aprovisionamiento y las claves de los perfiles de dispositivoAdmin
iot_device_profile.templates.manageGestionar las plantillas de perfiles de la plataforma. Solo operadores de la plataforma.Admin

Comandos

PermisoLo que permiteRol mínimo
iot_rpc.readVer el historial de comandos y los catálogos de comandosUser
iot_rpc.send.basicEnviar comandos básicos (solo lectura) a los dispositivosUser
iot_rpc.send.privilegedEnviar comandos de configuración a los dispositivosAdmin
iot_rpc.send.criticalEnviar comandos de alto impacto a los dispositivos (reinicio)Admin
iot_rpc.send.rawEnviar comandos sin procesar (métodos fuera del catálogo)Owner
iot_rpc.commands.manageGestionar los catálogos de comandos de los perfiles de dispositivoAdmin

Alarmas

PermisoLo que permiteRol mínimo
iot_alarm.readVer alarmas y reglas de alarmaUser
iot_alarm.rules.manageEditar las reglas de alarma de los perfiles de dispositivoAdmin
iot_alarm.muteSilenciar las alarmas de un dispositivoAdmin
iot_alarm.acknowledgeReconocer alarmas y añadir notasUser
iot_alarm.resolveResolver (borrar) alarmas manualmenteAdmin

Tarjeta de reglas

PermisoLo que permiteRol mínimo
iot_rules.readVer las reglas de los lugares y dispositivos y sus ejecucionesUser
iot_rules.runEjecutar una regla ahoraUser
iot_rules.modeCambiar un lugar entre Manual y AutoUser
iot_rules.manageAñadir, cambiar, activar o desactivar y eliminar reglasAdmin

Sitios y activos

PermisoLo que permiteRol mínimo
iot_asset.assets.readVer sitios y activos de IoTUser
iot_asset.assets.manageCrear, editar, mover y eliminar sitios y activos de IoTAdmin
iot_asset.relations.manageGestionar relaciones y ubicación de dispositivosAdmin

Telemetría

PermisoLo que permiteRol mínimo
telemetry.readLeer lecturas de telemetría (de los dispositivos que puede ver)User
telemetry.admin.readVer la configuración del almacén de telemetría (tipos, retención, claves)Admin
telemetry.admin.manageGestionar el almacén de telemetríaAdmin

Configuración de telemetría de IoT

PermisoLo que permiteRol mínimo
iot_telemetry.settings.readVer la configuración de telemetría de IoTAdmin
iot_telemetry.settings.updateCambiar la configuración de telemetría de IoTAdmin

Actualizaciones de firmware

PermisoLo que permiteRol mínimo
iot_ota.readVer paquetes de firmware, asignaciones y estados de actualización de los dispositivosUser
iot_ota.packages.manageSubir, depreciar, revocar y eliminar paquetes de firmwareAdmin
iot_ota.assignAsignar firmware, cambiar la configuración de OTA y reintentar actualizacionesAdmin
iot_ota.keys.manageRegistrar y revocar las claves públicas de firma de firmwareOwner

Ajustes remotos de dispositivos

PermisoLo que permiteRol mínimo
iot_device_settings.manifests.readVer el catálogo de manifiestos de ajustes de dispositivosAdmin
iot_device_settings.manifests.manageSubir manifiestos de ajustes de dispositivos al catálogoAdmin
iot_device_settings.readVer los ajustes de un dispositivoAdmin
iot_device_settings.operateCambiar los ajustes operativos de un dispositivo (la clase más baja; conceder junto con lectura)Admin
iot_device_settings.writeCambiar los ajustes de configuración de un dispositivo (red, Wi-Fi, cortafuegos; incluye los ajustes operativos; conceder junto con operate)Admin
iot_device_settings.baselines.manageCrear, cambiar y eliminar líneas base de ajustes de dispositivos (valores parciales con nombre de secciones para muchos dispositivos)Admin
iot_device_settings.jobs.manageIniciar, pausar, reanudar y cancelar trabajos de ajustes que aplican una línea base o un cambio a muchos dispositivos en oleadas (lo que un trabajo puede cambiar es lo que usted puede cambiar)Admin
iot_device_settings.dangerous.writeCambiar los ajustes peligrosos de un dispositivo (lo que puede dejar el dispositivo sin conexión; conceder junto con write)Owner

Aprovisionamiento y reclamación

PermisoLo que permiteRol mínimo
iot_provisioning.claimReclamar dispositivosAdmin
iot_provisioning.releaseLiberar dispositivosAdmin
iot_provisioning.release.forceForzar la liberación de dispositivos. Solo operadores de la plataforma.Admin
iot_provisioning.quarantine.activateActivar dispositivos en cuarentenaAdmin
iot_provisioning.pool.readVer el pool de fábrica de dispositivos licenciados. Solo operadores de la plataforma.Admin
iot_provisioning.pool.manageGestionar el pool de fábrica. Solo operadores de la plataforma.Admin

Certificados de dispositivo

PermisoLo que permiteRol mínimo
iot_pki.certificates.readVer certificados de dispositivoAdmin
iot_pki.certificates.revokeRevocar certificados de dispositivoAdmin
iot_pki.recovery.approveAprobar la recuperación de certificadosAdmin
iot_pki.ca.manageVer y gestionar las autoridades de certificación de la plataforma. Solo operadores de la plataforma.Admin
iot_pki.settings.updateCambiar la configuración de certificados de dispositivoAdmin

Endpoints de protocolo

PermisoLo que permiteRol mínimo
iot_gateway.endpoints.readVer endpoints de protocolo y la conexión de los dispositivos sondeadosUser
iot_gateway.endpoints.manageCrear, editar, probar y eliminar endpoints de protocolo; descubrir y conectar dispositivos sondeadosAdmin

Acciones de protocolo de cámaras

PermisoLo que permiteRol mínimo
iot_gateway_isapi.actions.manageCambiar el intervalo de fotogramas clave de una cámara compatible (Set to 2 seconds) y restaurarloAdmin

Cámaras

PermisoLo que permiteRol mínimo
iot_camera.cameras.readVer cámaras, sus flujos y la configuración de vídeo en directoUser
iot_camera.cameras.manageUsar un dispositivo como cámara, activar y desactivar la vista en directo, volver a leer sus streams y eliminar la cámaraAdmin
iot_camera.view_liveVer la imagen en directo de una cámaraUsuario
iot_camera.snapshots.readVer las instantáneas de las cámaras y las cifras de almacenamiento de la cámara (en desarrollo)Usuario
iot_camera.snapshots.manageTomar una instantánea de una cámara en este momento y eliminar instantáneas (en desarrollo)Admin
iot_camera.disk.readVer lo que guarda una cámara en su propia tarjeta de memoria (en desarrollo)Admin
iot_camera.disk.downloadDescargar grabaciones e imágenes de la tarjeta de memoria propia de una cámara (en desarrollo)Admin
iot_camera.recordings.readVer la línea temporal de grabaciones, reproducir grabaciones y listar clips de eventos (en desarrollo)Usuario
iot_camera.recordings.manageActivar y desactivar la grabación, cambiar los ajustes de grabación, guardar, eliminar y exportar clips (en desarrollo)Admin

LoRaWAN

PermisoQué permiteRol mínimo
iot_lorawan.gateways.readVer las pasarelas LoRaWANUsuario
iot_lorawan.gateways.manageAñadir, editar, desactivar y eliminar pasarelas LoRaWAN y rotar sus tokensAdmin
iot_lorawan.devices.readVer los dispositivos LoRaWANUsuario
iot_lorawan.devices.manageAñadir, editar y eliminar dispositivos LoRaWAN y definir su AppKeyAdmin
iot_lorawan.keys.readMostrar la AppKey de un dispositivo LoRaWANAdmin
iot_lorawan.frames.readVer las tramas LoRaWAN en tiempo realUsuario

Codecs LoRaWAN

PermisoQué permiteRol mínimo
iot_lorawan_codecs.readVer los codecs LoRaWAN y usar el banco de pruebas de codecsUsuario
iot_lorawan_codecs.manageAñadir, modificar y eliminar tus propios codecs LoRaWANAdmin
iot_lorawan_codecs.library.manageRetirar y restaurar codecs de la biblioteca de la plataformaAdmin

Paneles de routers (acceso remoto)

PermisoQué permiteRol mínimo
iot_remote_access.panel.openAbrir, acceder y cerrar el panel web de un router reclamadoAdmin
iot_remote_access.sessions.readVer las sesiones de panel de la organizaciónAdmin

eSIM

PermisoQué permiteRol mínimo
iot_esim.readVer el chip eSIM, los perfiles y las operaciones de un router (en desarrollo)Admin
iot_esim.manageDescargar, cambiar, desactivar, renombrar y eliminar los perfiles eSIM de un router (en desarrollo)Propietario

Paneles

PermisoQué permiteRol mínimo
dashboard.home.viewAbrir la página de inicioUsuario
dashboard.boards.readVer panelesUsuario
dashboard.boards.writeCrear y organizar tus propios panelesUsuario
dashboard.boards.manageGestionar paneles compartidosAdmin
dashboard.widgets.author_privateCrear y editar tus propios widgets privadosUsuario
dashboard.widgets.authorCrear y editar widgetsAdmin
dashboard.widgets.publishPublicar versiones de widgetsAdmin
dashboard.query.executeEjecutar consultas de datos de widgetsUsuario
dashboard.commands.executeEjecutar comandos de widgetsUsuario
dashboard.display.viewAbrir un panel mediante un enlace de visualizaciónCualquiera con un enlace de visualización
dashboard.settings.readVer la configuración de los panelesAdmin
dashboard.settings.updateCambiar la configuración de los panelesAdmin

Diagramas de proceso (SCADA)

PermisoQué permiteRol mínimo
dashboard_scada.commands.authorCrear comandos en los símbolos de los diagramas de procesoAdmin
dashboard_scada.diagrams.readVer diagramas de procesoUsuario
dashboard_scada.diagrams.writeCrear, editar y eliminar diagramas de procesoAdmin

Diseños 3D

PermisoQué permiteRol mínimo
dashboard_viewer.designs.readVer diseños 3DUsuario
dashboard_viewer.designs.writeCrear, editar y eliminar diseños 3DAdmin

Automatización (flujos)

PermisoQué permiteRol mínimo
automation.readVer flujos y el catálogo de bloquesAdmin
automation.manageCrear, editar y desplegar flujosAdmin
automation.manage_privilegedDesplegar flujos con bloques de nivel de control (comandos, ajustes)Admin
automation.debugInyectar mensajes, ver el contenido de los mensajes y los mensajes fallidosAdmin
automation.hooks.callLlamar a webhooks de flujos desplegados desde una sesión iniciada (widgets de paneles, páginas de la aplicación)Usuario

Permisos de la plataforma usados habitualmente con IoT

PermisoQué permiteRol mínimo
members.viewVer miembrosUsuario
members.invite, tenant_invitation.invitations.inviteInvitar miembros, enviar invitacionesAdmin
members.edit_role, members.suspend, members.removeCambiar el rol o el estado de un miembro, suspender, eliminarAdmin
members.manage_ownerModificar o eliminar propietariosPropietario
members.transfer_ownershipTransferir la propiedadPropietario
api_key.keys.read, .create, .update, .deleteVer, crear, actualizar y revocar claves de APIAdmin
api_key.keys.rotate, api_key.keys.revoke_allRotar claves de API, revocar todas las claves de APIPropietario
webhook.endpoints.read, .create, .update, .delete, .test, .triggerGestionar endpoints de webhook, enviar eventos de prueba y manualesAdmin
webhook.endpoints.rotate_secretRotar el secreto de firma de un webhookPropietario
webhook.deliveries.read, .redeliver, .replayVer entregas, reenviar y repetir las fallidasAdmin
audit_log.logs.read, .export, .verifyVer, exportar y verificar el registro de auditoríaAdmin
audit_log.logs.anonymize, audit_log.logs.purgeAnonimizar un actor (borrado), purgar filas caducadasPropietario
tenant_usage.metrics.readLeer métricas de uso y cuotasAdmin
tenant_usage.settings.updateCambiar la configuración de alertas de usoAdmin
tenant_setting.config.read, .updateVer y cambiar la configuración de la organizaciónAdmin
tenant_session.settings.read, .updateVer y cambiar la política de inicio de sesiónAdmin
auth_abac.policies.read, .write, auth_abac.simulate, auth_abac.decisions.readPolíticas de acceso, el simulador y el registro de decisionesPropietario
auth_saml.config.read, .update, .deleteConfigurar el inicio de sesión único SAMLPropietario
auth_sso.settings.read, .updateVer y cambiar la configuración del inicio de sesión únicoAdmin
tenant_domain.domains.create, tenant_domain.domains.deleteAñadir y eliminar dominios personalizadosPropietario
tenant_domain.domains.read, .verifyVer dominios, verificar la propiedadAdmin
tenant_export.data.exportExportar todos los datos de la organizaciónPropietario
tenant_branding.branding.updateCambiar la identidad visualAdmin
notification_mail.settings.update, notification_sms.settings.update, notification_push.settings.update, notification_inapp.settings.updateCambiar la configuración de notificaciones por correo, SMS, push y en la aplicaciónAdmin
notification_external.link.manageVincular o desvincular tus propias cuentas de chatUsuario
notification_external.provider.manageConectar o desconectar las plataformas de chat de la organizaciónAdmin
ai_firewall.incidents.read, .manage, ai_firewall.settings.manageLeer y gestionar incidentes y ajustes del cortafuegos de IAAdmin
mcp_server.connectConectar asistentes de IA (clientes MCP)Usuario
mcp_server.settings.manageGestionar la configuración de MCPAdmin

Acciones exclusivas del propietario

Estas acciones siguen reservadas a los propietarios, independientemente de lo que indiquen los grupos:

AcciónPermiso
Transferir la propiedad; cambiar o eliminar propietariosmembers.transfer_ownership, members.manage_owner
Configurar el inicio de sesión único SAMLauth_saml.config.*
Políticas de accesoauth_abac.*
Añadir y eliminar dominios personalizadostenant_domain.domains.create, tenant_domain.domains.delete
Exportar todos los datostenant_export.data.export
Rotar y revocar todas las claves de APIapi_key.keys.rotate, api_key.keys.revoke_all
Rotar un secreto de firma de webhookwebhook.endpoints.rotate_secret
Enviar comandos sin procesariot_rpc.send.raw
Registrar y revocar claves de firma de firmwareiot_ota.keys.manage
Cambiar los ajustes peligrosos de un dispositivoiot_device_settings.dangerous.write

Las plantillas de grupos de IoT

Settings > Access Control > Groups > From template… añade estos grupos. Cada uno solo incluye los permisos de los módulos que tiene su organización.

PlantillaPermisos
IoT operatoriot_device.devices.read, iot_device.devices.update, iot_device.attributes.write
IoT vieweriot_device.devices.read, iot_device.attributes.read, iot_device.bindings.read, iot_device_profile.profiles.read, iot_alarm.read, iot_asset.assets.read, iot_rules.read, iot_rpc.read, iot_ota.read, iot_pki.certificates.read, iot_device_settings.read, iot_gateway.endpoints.read, iot_lorawan.gateways.read, iot_lorawan.devices.read, iot_lorawan.frames.read, iot_lorawan_codecs.read, iot_camera.cameras.read, iot_camera.view_live, iot_camera.snapshots.read, iot_camera.recordings.read

Los miembros son User por defecto, así que un grupo IoT viewer añade sobre todo los permisos de lectura cuyo rol mínimo es Admin (ajustes de dispositivo, certificados). Un IoT operator puede editar dispositivos y escribir sus atributos, pero no puede gestionar credenciales ni crear y eliminar dispositivos.

Ninguna de las dos plantillas permite a un miembro enviar comandos más allá de lo que permite su rol: los comandos Basic requieren iot_rpc.send.basic, que todos los User tienen por defecto. Para impedir que los viewers pulsen los controles de la placa, elimina ese permiso del rol User en Access Rights, o asigna a los viewers un rol y grupos que no lo incluyan.

Relacionado