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

Políticas de acceso

Reglas basadas en atributos sobre roles y grupos: evaluación, editor de reglas, modo sombra, probador de accesos, registro de decisiones y límites.

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:

  1. 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).
  2. Si alguna deniega, la petición se rechaza. Denegar siempre prevalece.
  3. En caso contrario, si una permite, la petición sigue adelante.
  4. 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

  1. Selecciona New policy (o Load examples para empezar con políticas predefinidas).
  2. Introduce un Name, el Effect (Permit, o Deny (overrides any permit)) y la Priority (lower runs first). Selecciona Create & edit.
  3. 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.
  4. 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)).

AtributoSignificado
subject.roleEl rol integrado: OWNER, ADMIN, USER
subject.rolesEl rol más las claves de grupo del miembro
subject.permissionsLos permisos que conceden los grupos del miembro
subject.id, subject.emailEl miembro
subject.department, subject.jobTitleDel perfil del miembro, cuando está definido
subject.amrCómo se inició la sesión: pwd, otp, mfa, hwk (passkey), fed:saml, fed:<provider>
subject.acrEl nivel de garantía derivado: NONE, LOW (solo contraseña o federado), SUBSTANTIAL (un segundo factor verificado), HIGH (una passkey)
environment.ipLa dirección del solicitante
environment.now, environment.method, environment.userAgent, environment.hostHora, método HTTP, navegador, nombre de host
actionEl 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:

CampoValor
EfectoDenegar
Accionesiot_rpc.send.critical, iot_rpc.send.raw
Condiciónsubject.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:

CampoValor
EfectoDenegar
Accionesiot_device.attributes.write, iot_rpc.send.basic, iot_rpc.send.privileged
Condiciónsubject.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

HerramientaDóndeUso
Shadow ModeSettings 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 accesoSimulador«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 decisionesRegistro de decisionesCada 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.