Las políticas de acceso añaden reglas basadas en atributos (ABAC) sobre los roles y los grupos. Una política examina quién hace la petición, qué quiere hacer y en qué contexto, y permite o deniega. Usa las políticas para restringir lo que los roles y grupos permitirían de otro modo, por ejemplo «nadie puede enviar comandos críticos desde fuera de la red de la planta» o «el firmware solo puede asignarse desde una sesión iniciada con una passkey». Las políticas son una herramienta avanzada: la mayoría de las organizaciones solo necesitan roles y grupos.
Necesitas el rol Owner. Abre Settings > Access Policies (dirección /admin/access-policies).
Cómo se toma una decisión
Para cada petición protegida:
- Se recogen todas las políticas activas cuyo destino coincide (sus acciones y tipos de recurso) y cuyas condiciones se cumplen todas, en orden de prioridad (la más baja se ejecuta primero).
- Si alguna deniega, la petición se rechaza. Denegar siempre prevalece.
- En caso contrario, si una permite, la petición sigue adelante.
- Si no se aplica ninguna política, prevalece la decisión de roles, grupos y matriz («RBAC fallback»).
Las políticas son restricciones adicionales: escribe los requisitos como políticas Deny. Una política Permit cuyas condiciones no se cumplen no rechaza nada; la petición simplemente recurre a la decisión del rol.
Qué peticiones ven las políticas
Las políticas se comprueban en las rutas que llaman al motor de políticas. La mayoría de las páginas y rutas de la API de Hermetry lo hacen; algunas no, porque no hay un miembro con sesión iniciada que evaluar (el propio inicio de sesión, las conexiones de dispositivos, las devoluciones de llamada de webhooks, los trabajos programados y las peticiones con el contrato de una clave de API, como SCIM). La página Coverage indica exactamente qué rutas llegan al motor y, para las demás, «What guards it instead». Consúltala antes de confiar en una política.
Importante
Las páginas de IoT y la API de IoT transmiten a las políticas la acción (el permiso) y el solicitante, pero no los atributos de los dispositivos. No puedes escribir una política para un solo dispositivo o un solo emplazamiento, y un miembro que puede ver dispositivos ve todos los dispositivos de la organización. Si los grupos de personas nunca deben ver los dispositivos de otros, pon esos dispositivos en organizaciones separadas. La separación entre organizaciones se aplica en la base de datos mediante seguridad a nivel de fila (row-level security). Prueba siempre una política primero en el probador de accesos y en modo sombra.
Crear una política
- Selecciona New policy (o Load examples para empezar con políticas predefinidas).
- Introduce un Name, el Effect (Permit, o Deny (overrides any permit)) y la Priority (lower runs first). Selecciona Create & edit.
- En Definition, configura:
- Actions (comma-separated, empty = all): identificadores de permisos como
iot_rpc.send.critical, iot_ota.assign. - Tipos de recurso (separados por comas; vacío = todos).
- Description: por qué existe la política.
- Status: Active o Inactive. Selecciona Save definition.
- Actions (comma-separated, empty = all): identificadores de permisos como
- En Conditions, selecciona Add condition para cada prueba. «Todas las condiciones deben cumplirse (AND) para que la política se aplique.» Selecciona Save conditions.
Una política sin condiciones se aplica a toda petición que coincida con su destino.
Condiciones
Cada condición consta de un Attribute, un Operator y un Value (o Values (comma-separated)).
| Atributo | Significado |
|---|---|
subject.role | El rol integrado: OWNER, ADMIN, USER |
subject.roles | El rol más las claves de grupo del miembro |
subject.permissions | Los permisos que conceden los grupos del miembro |
subject.id, subject.email | El miembro |
subject.department, subject.jobTitle | Del perfil del miembro, cuando está definido |
subject.amr | Cómo se inició la sesión: pwd, otp, mfa, hwk (passkey), fed:saml, fed:<provider> |
subject.acr | El nivel de garantía derivado: NONE, LOW (solo contraseña o federado), SUBSTANTIAL (un segundo factor verificado), HIGH (una passkey) |
environment.ip | La dirección del solicitante |
environment.now, environment.method, environment.userAgent, environment.host | Hora, método HTTP, navegador, nombre de host |
action | El permiso que se comprueba |
Operadores: equals, not equals, in list, not in list, contains, greater than, less than, exists, matches regex, DN equals (RDN).
Un atributo ausente se lee como vacío, lo que satisface not equals y not in list. Por eso las reglas de denegación son seguras y las de permiso no.
Ejemplos
Denegar los comandos críticos y en bruto salvo que la sesión haya usado un segundo factor o una passkey:
| Campo | Valor |
|---|---|
| Efecto | Denegar |
| Acciones | iot_rpc.send.critical, iot_rpc.send.raw |
| Condición | subject.acr no está en la lista SUBSTANTIAL, HIGH |
Impedir que los miembros de un grupo contractors escriban atributos o envíen comandos, sea cual sea su rol:
| Campo | Valor |
|---|---|
| Efecto | Denegar |
| Acciones | iot_device.attributes.write, iot_rpc.send.basic, iot_rpc.send.privileged |
| Condición | subject.roles contiene contractors |
Para conceder un derecho solo a un grupo, la matriz Access Rights suele ser más sencilla que una política: desmarca el permiso para Admin y márcalo para el grupo. Consulta Groups and permissions.
Modo sombra, probador de accesos y registro de decisiones
| Herramienta | Dónde | Uso |
|---|---|---|
| Shadow Mode | Settings en la página de políticas (Access Control Settings) | «Las políticas se evalúan y las decisiones se registran, pero una «denegación» NUNCA bloquea la petición.» Desactivado por defecto. Actívalo antes de aplicar una nueva política, revisa el registro y después desactívalo. |
| Probador de acceso | Simulador | «Simula una decisión con las políticas en vigor: no se guarda nada ni se registra.» Introduce Subject id, Subject role, Action, Resource type, Resource ownerId, Environment IP y un RBAC fallback role, y luego Evaluate. La Policy trace muestra el destino y las reglas de cada política. |
| Registro de decisiones | Registro de decisiones | Cada petición evaluada con Effect, Action, Reason (Policy permit, Explicit deny, RBAC fallback, Default deny, Not applicable) y Subject. Las denegaciones en modo sombra aparecen marcadas como Shadow. |
Decision Log Mode (All decisions, Deny only, Off; por defecto all) y Permit Log Sample Rate (%) determinan cuánto se envía al registro de auditoría. Las denegaciones siempre se registran.
Buenas prácticas
- Empieza con Load examples y léelas antes de escribir las tuyas.
- Usa políticas de denegación con listas de acciones acotadas. Evita las políticas sin acciones: evalúan todas las peticiones.
- Nunca bloquees a los owners: prueba cada política con el rol de un owner en el probador de accesos.
- Los cambios surten efecto de inmediato en todos los nodos.

