Programações das Access Policies
Nesta página
O horário é a parte When de toda Access Policy. Escolha Anytime ou Scheduled; uma política programada contém uma ou mais janelas Weekly ou One-time. Para a página Settings → Access Time Windows, consulte Períodos de tolerância e fuso horário.
Uma política só concede acesso quando Who E Where E When correspondem. As janelas dentro de uma política são combinadas com OU, e as políticas nomeadas também são combinadas com OU. As políticas apenas concedem permissão: uma política inativa não revoga o acesso concedido por outra política correspondente, por uma concessão permanente ou por uma janela separada de administrador/integração.
A qualquer momento
Anytime significa que o Who e o Where da política podem corresponder sem restrição de programação. Isso não ignora as verificações de segurança, manutenção, geofence, bloqueio, limite de taxa ou dispositivo.
Janelas Weekly
Uma janela Weekly se repete usando blocos de horário de relógio local, como segunda-feira das 06:00 às 08:30.
- O fuso horário IANA selecionado controla o dia da semana, o horário local e o comportamento do horário de verão.
- Instantes opcionais de início e término de vigência podem delimitar a recorrência; o fim não é incluído.
- Os blocos não podem se sobrepor nem atravessar a meia-noite. Divida um período noturno em dois dias.
- Quando o relógio é adiantado, os horários locais pulados não ocorrem. Quando o relógio é atrasado, os dois instantes reais representados por um horário local repetido são válidos.
Janelas One-time
Uma janela One-time tem um único instante exato de início e de fim. Use-a para um período avulso conhecido.
- O início e o fim são segundos Unix inteiros que identificam instantes em UTC.
- O limite é semiaberto:
[from, to). O início é incluído; o fim não. - O fuso horário exibido serve de contexto para entrada, exibição e auditoria. Ele não altera um instante armazenado.
Janelas separadas de usuário e de integração
As janelas de usuário de responsabilidade do administrador e as janelas fornecidas por integrações continuam sendo caminhos separados e cumulativos; elas não são convertidas em Access Policies e não podem ser removidas editando uma política. Elas podem ter como destino a instalação, portas ou Escopos de acesso, de acordo com o próprio contrato.
As janelas de integração mantêm o comportamento de propriedade da origem, revisão, atualização e mapeamento scope_key. Janelas da origem desconhecidas, desabilitadas, sem mapeamento, desatualizadas ou desvinculadas não concedem acesso. Uma origem não pode apagar as janelas de outra origem, e nem as atualizações da origem nem as edições de políticas apagam as janelas de responsabilidade do administrador.
As concessões permanentes são outro caminho separado e cumulativo. O horário de funcionamento opcional existente delas continua independente das programações das políticas.
Períodos de tolerância e fuso horário
Figura 1: Settings → Access Time Windows → Access grace periods
Settings → Access Time Windows → Access grace periods define quanta margem as pessoas têm em torno das janelas programadas. "Scheduled start and end times remain unchanged. These buffers only expand when door access is allowed."
- Fuso horário da instalação — o fuso horário usado pelas janelas semanais, que acompanha automaticamente as mudanças de horário de verão. Use Alterar o fuso horário em Configuração de instalações e sistemas para alterá-lo; consulte Fuso horário.
- Allow early access — "Allow users to unlock doors shortly before their scheduled window starts." Off, 5 minutes, 10 minutes, 15 minutes ou 30 minutes.
- Allow access after end — "Keep door access available briefly after the scheduled window ends." Off, 5 minutes, 10 minutes, 15 minutes ou 30 minutes.
Os períodos de tolerância se aplicam a todas as janelas avulsas e semanais da instalação, incluindo as janelas fornecidas por integrações de reservas. Eles também contam para No visit recorded: uma pessoa que desbloqueia durante o período de tolerância conta como tendo comparecido. Por exemplo, um hotel pode definir Allow access after end como 15 minutos para cobrir check-outs tardios em passes de hóspedes.
Programações existentes
O horário de funcionamento existente é importado automaticamente para a seção When das Access Policies correspondentes. Os horários diferentes que antes se aplicavam a escopos ou portas específicos são preservados em políticas com destinos Where explícitos. Os administradores não precisam converter as programações manualmente.
Autorização e disponibilidade
Para o acesso de membros, as verificações de segurança do usuário e da porta são executadas primeiro. Em seguida, o servidor avalia os caminhos de permissão de política, concessão permanente, janela de administrador e janela de integração. As verificações de geofence e do controlador continuam sendo barreiras definitivas posteriores.
Uma janela de política futura pode retornar disponibilidade estruturada com o próximo início/fim concreto, o tipo, o rótulo e o fuso horário. Os clientes compatíveis usam esses dados para exibição; eles não calculam a autorização localmente. Os limites exatos continuam sendo [from, to).
A negação detalhada de janela futura é outside_access_time_window. Os clientes de compatibilidade podem continuar recebendo o motivo existente outside_access_hours com deniedReasonDetail: outside_access_time_window.
Atribuição
Uma decisão de política identifica a política correspondente pelo nome. Para acesso programado, os Registros de acesso também podem mostrar a janela ativa e o início e o fim concretos dela, deixando claro qual entrada de When concedeu o acesso.