Логотип Performance HubPerformance Hub
Раздел сайта: Документация

Как принимаются решения о доступе

На этой странице

На этой странице описана модель, лежащая в основе каждого открытия: кому разрешено проходить через дверь, в каком порядке выполняются проверки и как взаимодействуют Access Policies, разрешения и проверки безопасности. Прочитайте её в первую очередь — все остальные страницы опираются на эти понятия.

Суммирующиеся пути разрешения доступа

Пользователь может получить доступ через дверь по любому пути — политике или разрешению. Достаточно пройти один путь; ни один путь никогда не отменяет доступ, предоставленный другим.

ПутьЧто этоГде настраивается
Access PoliciesНесколько именованных политик, которые только разрешают доступ. Каждая политика задаёт Who, Where и When.Settings → Access Policies
Постоянные разрешенияЯвные разрешения для одного человека: на весь объект, на выбранные двери или выбранные области доступа, при необходимости с собственными часами.Users → открыть пользователя → Access Control → Additional permanent access
Access Time WindowsВременный доступ, выданный администратором одному человеку к выбранным объектам, дверям или областям.Users → открыть пользователя → Access Time Windows
Integration Access Time WindowsДоступные только для чтения окна из исходной системы для синхронизированного человека, сопоставляемые по логическим ключам областей источника.Исходные данные, а также сопоставления в Settings → Sync settings

Политика срабатывает, только если совпадают Who И Where И When. Политики объединяются по ИЛИ. Внутри Who условия по типу и статусу человека и теги являются альтернативами; внутри When альтернативами являются окна Weekly и One-time. Where может включать все двери объекта, области доступа, отдельные двери и исключения.

Пример: политика "Active members" может охватывать область Front entrances в режиме Anytime, а отдельная политика "Staff" — все двери объекта, кроме Plant room. Уборщик, не подпадающий ни под одну из них, всё равно может получить постоянное разрешение на область Service entries.

Постоянные разрешения и окна, выданные администратором или интеграцией, остаются отдельными и суммируются с политиками. Изменения политик и автоматический импорт не поглощают и не удаляют их.

Сотрудники Performance Hub, синхронизированные в Users, получают доступ к дверям через редактируемую политику Performance Hub staff, как и через любую другую политику. См. раздел Синхронизация и интеграции.

Полная последовательность принятия решения

Когда пользователь нажимает Unlock в мобильном приложении, сервер по порядку проверяет следующее. Первая неудачная проверка приводит к отказу в открытии, а причина записывается в журналы доступа.

  1. Включён ли доступ пользователя? Переключатель Access enabled в строке пользователя в Users — это аварийный выключатель для администратора. Удалённые, отключённые или заблокированные синхронизацией пользователи не могут открывать двери независимо от политик или разрешений. (Например: access_disabled.)
  2. Заблокирована ли дверь или находится ли она в режиме обслуживания? Явная блокировка blockAllAccess запрещает все пути доступа участников. Режим обслуживания Force closed держит дверь запертой и недоступной для участников; Force open держит дверь открытой. Администраторы могут открывать двери удалённо; каждое открытие администратором записывается в журналы доступа.
  3. Проходит ли какой-либо из суммирующихся путей разрешения доступа?
    • Путь через политику: доступ разрешает любая включённая именованная политика, у которой совпадают Who, Where и When.
    • Путь через постоянное разрешение: разрешение на объект, дверь или содержащую её область доступа разрешает доступ, если совпадают его необязательные часы.
    • Путь через окно пользователя: активно окно Access Time Window, выданное администратором, и оно нацелено на эту дверь, объект или содержащую её область доступа.
    • Путь через окно интеграции: активно актуальное окно из исходной системы, и настроенное для него сопоставление scope_key нацелено на эту дверь. Устаревшие или несопоставленные окна из исходной системы приводят к отказу.
    • Если ни один путь не проходит → отказ (no_matching_policy_or_grant)
  4. Проверка геозоны (если включена). По местоположению, которое сообщает телефон:
    • Если телефон не смог передать местоположение → отказ (location_unavailable)
    • Если показание GPS менее точное, чем задано параметром Require GPS accuracy better than → отказ (gps_too_imprecise)
    • Если расстояние от пользователя до центра геозоны превышает радиус + точность GPS + запас точности → отказ (outside_geofence)
    • Решающее слово за сервером — подделанное на телефоне местоположение всё равно отклоняется на стороне сервера.
  5. В сети ли дверной контроллер? Если контроллер не выходил на связь (контрольный сигнал в течение последних 5 минут), команду открытия доставить нельзя (device_offline). Если команда отправлена, но контроллер её не подтвердил, событие записывается как Timed out.
  6. Открытие. Реле размыкается на Hold time двери (1–30 секунд, по умолчанию 10), после чего дверь автоматически запирается. После подтверждения контроллером событие записывается как Confirmed unlocked.

Окна One-time и ограниченные по времени окна Weekly используют целочисленные границы в секундах Unix и полуоткрытые интервалы [from, to): начальный момент входит в интервал, а конечный — нет. Блоки Weekly используют заявленный для них часовой пояс IANA и местные правила времени, включая переход на летнее время. См. раздел Расписания политик доступа.

Новые клиенты получают подробность outside_access_time_window и структурированные данные о следующей доступности для двери, доступной только в будущих окнах. На время перехода старые клиенты по-прежнему получают outside_access_hours в качестве основной причины, чтобы дверь оставалась безопасно неактивной и при этом видимой.

Существующая конфигурация

Существующая конфигурация доступа автоматически импортируется в Access Policies. Импорт сохраняет, у кого был доступ, какими дверями или областями доступа эти люди могли пользоваться и применимые часы в виде значений Who, Where и When политик. Администраторы управляют полученными политиками напрямую; режима поэтапного внедрения или процесса ручного преобразования нет.

Наследование геозон не зависит от Access Policies. Совпадение с политикой по-прежнему проходит через действующую геозону и все остальные проверки безопасности и устройства.

Что делает и чего не делает вход по одноразовому коду

Вход в мобильное приложение (одноразовый код по SMS или электронной почте) — это только аутентификация: он подтверждает, кто является пользователем. Сам по себе он не предоставляет доступ к дверям. Каждое открытие авторизуется отдельно по описанной выше последовательности. Пользователь может войти в приложение и всё равно увидеть сообщение "You don't have access to this door."

Глоссарий

ТерминОпределение
Дверной контроллерАппаратное устройство, сопряжённое с дверью или воротами, которое управляет реле замка. В этом модуле отображается как «дверь», а в модуле «Управление устройствами» — как устройство.
ДверьДверной контроллер, зарегистрированный на вашем объекте, с названием, меткой расположения, значком и настройками.
Строка пользователяЗапись о человеке на этом объекте на вкладке Users. Создаётся вручную, импортом CSV или синхронизацией. Содержит контактные идентификаторы, тип, статус и теги, разрешения и состояние приложения.
ИсточникОткуда появилась строка пользователя: Manually added, External Integration, CCTV/Computer Vision или Performance Hub staff.
Access PolicyИменованная политика, которая только разрешает доступ и содержит Who, Where и When. Должны совпасть все три; политики объединяются по ИЛИ.
Условие по типу человекаУсловие Who в политике, содержащее тип человека и необязательные статусы членства. Пустой список статусов означает любой статус.
ТегМетка пользователя. Синхронизированные теги поступают из интеграции и перезаписываются при каждой синхронизации; пользовательские теги принадлежат администраторам и никогда не перезаписываются. И те и другие могут удовлетворять условиям Who в политиках.
Часы работы / временной блокВременные окна по дням недели (например, Пн 06:00–22:00), ограничивающие время, когда политики или разрешения предоставляют доступ. Пусто = доступ всегда разрешён. Время указывается в часовом поясе объекта.
Access Time WindowПериод Weekly или One-time, используемый в расписании политики или в отдельном пути разрешения от администратора или интеграции.
Персональное разрешениеЯвный доступ, предоставленный одному пользователю: на весь объект (все двери), на определённые двери или определённые области доступа, при необходимости с собственными часами работы.
Область доступаИменованный набор дверей (например, "Main entrances", "Staff-only"), используемый как цель политики или разрешения и для настроек геозоны на уровне области. Во внутренней терминологии также называется группой дверей.
Исключение политикиДверь или область доступа, исключённая из условия Where одной политики. Исключение не запрещает доступ через другую политику или путь разрешения.
GeofenceГеозона — круг вокруг объекта (центр + радиус). Если геозона включена, для открытия пользователи должны физически находиться внутри неё (с учётом точности GPS и запаса).
Запас точностиДополнительные метры, добавляемые к радиусу геозоны с учётом обычной погрешности GPS. По умолчанию 25 m.
Режим обслуживанияПараметр отдельной двери, выводящий её из обычного режима работы: Normal, Force open (дверь остаётся открытой) или Force closed (дверь остаётся запертой и недоступной для участников).
Block all accessЗащитная блокировка отдельной двери, которая имеет приоритет над политиками и персональными разрешениями для этой двери без использования режима обслуживания. Открытие администратором остаётся доступным.
Время удержанияКак долго реле остаётся разомкнутым после открытия перед повторным запиранием. Диапазон 1–30 секунд, по умолчанию 10.
Расписание автоматического открытияРасписание отдельной двери, которое держит её открытой в часы присутствия персонала на объекте или по собственному расписанию. Не зависит от Access Policies.
Lock nowЗапирает дверь, которую держит открытой расписание автоматического открытия, до следующего изменения в расписании. Resume schedule отменяет это действие.
Access enabledАварийный выключатель для отдельного пользователя. Выключено = пользователь не может ничего открыть.
ОтвязанныйСинхронизированный пользователь, у которого выключен переключатель Track source updates. Синхронизация пропускает эту строку, поэтому изменения администратора сохраняются.
ПриглашениеПисьмо, отправляемое пользователю со ссылками для загрузки мобильного приложения. Отслеживается для каждого пользователя (Not invited / Invited / Send failed).
Вход по одноразовому кодуВход в мобильное приложение без пароля: одноразовый код отправляется на телефон или адрес электронной почты пользователя.
Переопределение администратором / открытие администраторомОткрытие, запущенное администратором из Performance Hub (вкладка Doors → Open или Unlock door на панели двери). Каждое открытие администратором записывается в журналы доступа с указанием учётной записи администратора.
Блокировка приложенияОбязательная на уровне объекта повторная аутентификация на устройстве (Face ID / Touch ID / биометрия Android / код-пароль) перед использованием приложения.
Сообщение в приложенииКарточка с объявлением на панели приложения — для всего объекта, персональная или заданная автоматически правилом App Messaging.
Событие доступаОдна запись в журналах доступа: попытка открытия и её результат.