Cómo funcionan las decisiones de acceso

En esta página

En esta página se explica el modelo detrás de cada desbloqueo: quién puede pasar por una puerta, en qué orden se ejecutan las comprobaciones y cómo interactúan las Access Policies, las concesiones y las comprobaciones de seguridad. Léela primero: todas las demás páginas se basan en estos conceptos.

Las vías de autorización acumulativas

Un usuario puede obtener permiso para pasar por una puerta mediante cualquier vía de política o de concesión. Basta con superar una vía; ninguna vía resta el acceso que proporciona otra.

Vía	Qué es	Dónde se configura
Access Policies	Varias políticas con nombre que solo permiten. Cada política define Who, Where y When.	Settings → Access Policies
Concesiones permanentes	Permisos explícitos para una persona: para toda la instalación, para puertas seleccionadas o para Alcances de acceso seleccionados, opcionalmente con su propio horario.	Users → abre un usuario → Access Control → Additional permanent access
Access Time Windows	Acceso temporal propiedad de un administrador para una persona y para destinos de instalación, puerta o alcance seleccionados.	Users → abre un usuario → Access Time Windows
Access Time Windows de integración	Períodos de origen de solo lectura para una persona sincronizada, asignados a partir de claves lógicas de alcance de origen.	Datos de origen, además de las asignaciones de Settings → Sync settings

Una política solo coincide cuando Who Y Where Y When coinciden. Las políticas se combinan con O. Dentro de Who, las condiciones de tipo de persona o estado y las etiquetas son alternativas; dentro de When, los períodos Weekly y One-time son alternativas. Where puede incluir todas las puertas de la instalación, Alcances de acceso, puertas individuales y exclusiones.

Ejemplo: una política "Active members" puede abarcar el alcance Front entrances con Anytime, mientras que una política "Staff" independiente abarca todas las puertas de la instalación excepto la Plant room. Un empleado de limpieza que no coincide con ninguna de ellas puede seguir recibiendo una concesión permanente para el alcance Service entries.

Las concesiones permanentes y los períodos de administrador o de integración se mantienen independientes y se suman. Las ediciones de políticas y la importación automática no los absorben ni los eliminan.

El personal de Performance Hub sincronizado en Users obtiene acceso a las puertas mediante la política editable Performance Hub staff, como cualquier otra política. Consulta Sincronización e integraciones.

La secuencia de decisión completa

Cuando un usuario toca Unlock en la aplicación móvil, el servidor comprueba lo siguiente, en este orden. La primera comprobación que falla deniega el desbloqueo y registra el motivo en los Registros de acceso.

¿Está habilitado el acceso del usuario? El interruptor Access enabled de la fila del usuario en Users es un interruptor de corte para administradores. Los usuarios eliminados, deshabilitados o bloqueados por la sincronización no pueden desbloquear, independientemente de las políticas o concesiones. (Por ejemplo: access_disabled).
¿Está la puerta bloqueada o en mantenimiento? Un blockAllAccess explícito deniega todas las vías de los miembros. El modo de mantenimiento Force closed mantiene la puerta bloqueada y fuera de servicio para los miembros; Force open mantiene la puerta desbloqueada. Los administradores pueden desbloquear una puerta de forma remota; cada desbloqueo de administrador queda registrado en los Registros de acceso.
¿Se supera alguna vía de autorización acumulativa?
- Vía de política: cualquier política con nombre habilitada cuyos Who, Where y When coincidan permite el acceso.
- Vía de concesión permanente: una concesión de instalación, de puerta o de un Alcance de acceso que la contenga permite el acceso cuando coincide su horario opcional.
- Vía de período del usuario: una Access Time Window propiedad de un administrador está activa y tiene como destino esta puerta, la instalación o un Alcance de acceso que la contenga.
- Vía de período de integración: un período de origen actualizado está activo y su asignación scope_key configurada tiene como destino esta puerta. Los períodos de origen obsoletos o sin asignar fallan de forma cerrada.
- Si no se supera ninguna → se deniega (no_matching_policy_or_grant)
Comprobación de la geovalla (si está habilitada). Con la ubicación que informa el teléfono:
- Si el teléfono no pudo proporcionar una ubicación → se deniega (location_unavailable)
- Si la lectura del GPS es menos precisa que la configuración Require GPS accuracy better than → se deniega (gps_too_imprecise)
- Si la distancia del usuario al centro de la geovalla supera radio + precisión del GPS + margen de precisión → se deniega (outside_geofence)
- El servidor es la fuente autorizada: una ubicación falsificada en el teléfono se sigue rechazando en el servidor.
¿Está en línea el controlador de la puerta? Si el controlador no se ha reportado (señal de actividad en los últimos 5 minutos), no se puede entregar el desbloqueo (device_offline). Si se envía el comando, pero el controlador no lo confirma, el evento se registra como Timed out.
Desbloqueo. El relé se libera durante el Hold time de la puerta (1–30 segundos, 10 de forma predeterminada) y, luego, vuelve a bloquearse automáticamente. El evento se registra como Confirmed unlocked una vez que el controlador lo confirma.

Los períodos One-time y los períodos Weekly con límites usan límites enteros en segundos Unix e intervalos semiabiertos [from, to): el inicio se incluye y el final no. Los bloques Weekly usan la zona horaria IANA declarada y las reglas locales de hora oficial y horario de verano. Consulta Horarios de las Access Policies.

Los clientes nuevos reciben el detalle outside_access_time_window, además de la próxima disponibilidad estructurada para una puerta que solo tiene períodos futuros. Durante la implementación de compatibilidad, los clientes más antiguos siguen recibiendo outside_access_hours como motivo principal, para que la puerta permanezca deshabilitada de forma segura y visible.

Configuración existente

La configuración de acceso existente se importa automáticamente a las Access Policies. La importación conserva quién tenía acceso, las puertas o los Alcances de acceso que podía usar y el horario aplicable como valores Who, Where y When de las políticas. Los administradores gestionan directamente las políticas resultantes; no hay modo de implementación ni proceso de conversión manual.

La herencia de la geovalla sigue siendo independiente de las Access Policies. Las coincidencias de políticas siguen pasando por la geovalla efectiva y por todas las demás comprobaciones de seguridad y de dispositivo.

Iniciar sesión en la aplicación móvil (con un código de un solo uso por SMS o correo electrónico) es solo autenticación: demuestra quién es el usuario. Por sí solo no concede acceso a las puertas. Cada desbloqueo se autoriza individualmente con la secuencia de decisión anterior. Un usuario puede tener la sesión iniciada en la aplicación y, aun así, ver "You don't have access to this door."

Glosario

Término	Definición
Controlador de puerta	El dispositivo de hardware vinculado a una puerta o portón que acciona el relé de la cerradura. Aparece como una "puerta" en este módulo y como un dispositivo en Gestión de dispositivos.
Puerta	Un controlador de puerta registrado en tu instalación, con un nombre, una etiqueta de ubicación, un icono y una configuración.
Fila de usuario	El registro de una persona en esta instalación en la pestaña Users. Se crea manualmente, mediante una importación de CSV o mediante la sincronización. Contiene identificadores de contacto, tipo, estado, etiquetas, concesiones y el estado de la aplicación.
Origen	De dónde proviene una fila de usuario: Manually added, External Integration, CCTV/Computer Vision o Performance Hub staff.
Access Policy	Una política con nombre que solo permite y que contiene Who, Where y When. Los tres deben coincidir; las políticas se combinan con O.
Condición de tipo de persona	Una condición Who de una política que contiene un tipo de persona y estados de membresía opcionales. Si no hay estados, se acepta cualquier estado.
Etiqueta	Una etiqueta asignada a un usuario. Las etiquetas sincronizadas provienen de la integración y se sobrescriben en cada sincronización; las etiquetas personalizadas son propiedad del administrador y nunca se sobrescriben. Ambas pueden cumplir las condiciones Who de las políticas.
Horario de funcionamiento / bloque horario	Períodos por día de la semana (por ejemplo, lun 06:00–22:00) que restringen cuándo las políticas o las concesiones permiten el acceso. Vacío = siempre permitido. Las horas usan la zona horaria de la instalación.
Access Time Window	Un período Weekly o One-time que se usa en el horario de una política o en una vía de concesión independiente de administrador o de integración.
Concesión por usuario	Acceso explícito otorgado a un usuario: para toda la instalación (todas las puertas), puertas específicas o Alcances de acceso específicos, opcionalmente con su propio horario de funcionamiento.
Alcance de acceso	Un conjunto de puertas con nombre (por ejemplo, "Main entrances" o "Staff-only") que se usa como destino de políticas o concesiones y para la configuración de geovalla a nivel de alcance. Internamente también se denomina grupo de puertas.
Exclusión de política	Una puerta o un Alcance de acceso que se quita de la coincidencia Where de una política. No deniega otra vía de política ni de concesión.
Geofence	Un círculo alrededor de la instalación (centro + radio). Cuando está habilitada, los usuarios deben estar físicamente dentro de ella (teniendo en cuenta la precisión del GPS y el margen) para desbloquear.
Margen de precisión	Metros adicionales que se suman al radio de la geovalla para tolerar el ruido normal del GPS. Valor predeterminado: 25 m.
Modo de mantenimiento	Configuración por puerta que saca una puerta del funcionamiento normal: Normal, Force open (se mantiene desbloqueada) o Force closed (se mantiene bloqueada y fuera de servicio para los miembros).
Block all access	Un bloqueo de seguridad por puerta que anula las políticas y las concesiones por usuario en esa puerta, sin usar el modo de mantenimiento. El desbloqueo de administrador sigue disponible.
Hold time	Cuánto tiempo permanece liberado el relé después de un desbloqueo antes de volver a bloquearse. Intervalo de 1–30 segundos, 10 de forma predeterminada.
Horario de desbloqueo automático	Un horario por puerta que mantiene la puerta desbloqueada durante el horario con personal de la instalación o durante un horario personalizado. Es independiente de las Access Policies.
Lock now	Bloquea una puerta que el horario de desbloqueo automático mantiene abierta, hasta el siguiente cambio del horario. Resume schedule lo deshace.
Access enabled	El interruptor de corte por usuario. Desactivado = el usuario no puede desbloquear nada.
Desvinculado	Un usuario sincronizado cuyo interruptor Track source updates está desactivado. Las sincronizaciones omiten la fila, por lo que se conservan las ediciones del administrador.
Invitación	El correo electrónico que se envía a un usuario con enlaces para descargar la aplicación móvil. Se registra por usuario (Not invited / Invited / Send failed).
Inicio de sesión con OTP	El inicio de sesión sin contraseña de la aplicación móvil: un código de un solo uso que se envía al teléfono o al correo electrónico del usuario.
Anulación de administrador / desbloqueo de administrador	Un desbloqueo que un administrador activa desde Performance Hub (pestaña Doors → Open, o Unlock door en el panel de la puerta). Cada desbloqueo de administrador queda registrado en los Registros de acceso con la cuenta del administrador.
Bloqueo de la aplicación	Nueva autenticación en el dispositivo exigida por la instalación (Face ID / Touch ID / biometría de Android / código de acceso) antes de poder usar la aplicación.
Mensaje en la aplicación	Una tarjeta de anuncio en el panel de la aplicación: para toda la instalación, por usuario o configurada automáticamente por una regla de App Messaging.
Evento de acceso	Un registro en los Registros de acceso: un intento de desbloqueo y su resultado.

Access Policies: Who, Where, When y la importación automática
Horarios de las Access Policies: Anytime, Weekly y One-time
Alcances de acceso: conjuntos de puertas reutilizables
Geovallas: comprobaciones de ubicación
Users: concesiones por usuario y el interruptor de corte
Referencia: todos los motivos de denegación y valores predeterminados en una sola tabla
Las puertas también se pueden incluir en las respuestas de Duress. Consulta Acciones de respuesta en Duress.