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

Мобильное приложение Door & Gate Access

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

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

Обзоры каждой платформы со снимками экрана приведены на сопутствующих страницах: Приложение для iPhone и Android, Apple Watch и Wear OS и CarPlay.

Установка приложения

Загрузите в App Store Доступно в Google Play

Приложение доступно на следующих устройствах:

  • iPhone и iPad (iOS/iPadOS 18 или новее)
  • Телефоны на Android
  • Apple Watch (watchOS 11 или новее) и часы на Wear OS — открытие с запястья, не доставая телефон
  • CarPlay — открытие ворот и гаражных дверей с экрана автомобиля
  • Виджет на экране «Домой» и элемент управления в Пункте управления (iOS)

Функции и пользовательский интерфейс одинаковы на iOS и Android — снимки экрана в этой документации сделаны на iOS, но в равной мере относятся и к приложению для Android. Письма с приглашениями, отправляемые из раздела Users, содержат ссылки для загрузки.

Вход

Паролей нет — для входа используется одноразовый код (OTP), отправляемый на номер телефона или адрес электронной почты из записи участника в Users.

  1. При первом запуске приложение показывает несколько вводных экранов и запрашивает разрешение на точную геолокацию (нужно для открытия дверей с геозоной) и разрешение на уведомления.
  2. На экране Welcome участник выбирает Email или Phone, вводит адрес или номер и нажимает Send code.
  3. Участник вводит 6-значный код (через 30 секунд появляется вариант Resend code).
  4. После этого участник остаётся в системе — вводить код при каждом запуске не нужно.

Проблемы со входом, о которых могут сообщать участники:

Сообщение в приложенииПричинаДействия администратора
No record found — "No record could be found matching the … you provided."Телефон или адрес электронной почты не совпадает ни с одной записью Users ни на одном объектеПроверьте точный телефон или адрес электронной почты в Users; исправьте опечатки или добавьте недостающий идентификатор
Too many attemptsОграничение частоты входа (на уровне сети или 5 запросов кода в час на один контакт)Попросите подождать — ограничение на контакт является мерой безопасности и не может быть снято
Код приходит, но проверка не проходитКод введён с ошибкой или истёкЗапросите новый код

Вход лишь подтверждает личность. Каждая дверь по-прежнему авторизуется на основе Access Policies и суммирующихся разрешений.

Выбор объекта

Участники, привязанные к нескольким объектам (один и тот же телефон или адрес электронной почты в Users на нескольких объектах), могут переключаться, нажав на название объекта в верхней части панели (Switch Location). Приложение также может предложить переключиться, если обнаружит, что участник находится на другом из привязанных объектов, а необязательный параметр Auto-switch to nearest location переключает объект автоматически в пределах 250 m.

Панель

На вкладке Doors & Gates перечислены все двери выбранного объекта, которые видит участник:

  • Двери сгруппированы по расположению (метке Door location, заданной на портале администратора), а вверху находится большая карточка основной двери — участники с несколькими дверьми могут закрепить любимую звёздочкой.
  • Для каждой двери отображаются значок, выбранный администратором, её название и индикатор текущего статуса.
  • Сообщения отображаются в виде карточек вверху: сначала персональное сообщение участника, затем сообщение для всего объекта; цвет зависит от важности (INFORMATION / NOTICE / URGENT). См. раздел Сообщения в приложении.
  • Контакты поддержки (позвонить или написать на объект) отображаются в соответствии с параметром безопасности приложения — по умолчанию, когда дверь не в сети или информации недостаточно.
  • Участник без дверей видит: "You don't have access to any doors at this location yet. Please contact the location or your site administrator and they'll get you set up."

Индикаторы статуса дверей

ИндикаторЗначение
UnlockГотово — нажмите, чтобы открыть
Unlocked / Re-lockingДверь только что открыта; идёт обратный отсчёт времени удержания до повторного запирания
Move closer to open / Not at siteУчастник находится за пределами геозоны двери (может отображаться значок расстояния, например "250 m away")
Door offlineДверной контроллер не выходит на связь — команды открытия не могут быть доставлены
Under maintenance / MaintenanceДверь находится в режиме обслуживания Force closed
OpenДверь удерживается открытой (Force open или расписание автоматического открытия)
Outside hours / Available {hours}Ожидание будущего окна Access Policy, разрешения или интеграции; показывает доступность, переданную сервером
No accessНи одна политика Access Policy, постоянное разрешение или окно администратора либо интеграции не распространяется на этого участника для данной двери

Открытие двери

  1. Нажмите кнопку открытия двери.
  2. Для дверей с геозоной приложение сначала заново получает точные GPS-координаты.
  3. Запрос отправляется на сервер, который принимает полное решение о доступе.
  4. При успехе дверь открывается, а приложение показывает Unlocked и обратный отсчёт Re-locking на время удержания двери.

Если в открытии отказано, приложение объясняет причину:

Причина на сервереСообщение, которое видит участник
За пределами геозоны"Move closer — you're outside the location's geofence." (а также окно с пояснением о геозонах и расстоянием до объекта)
Недостаточная точность GPS"Couldn't pin down your location accurately. Try again outdoors."
Местоположение недоступно"Couldn't read your location. Make sure Location is enabled and set to Precise, then try again."
Дверь не в сети"Door is offline. Please contact the facility."
Нет подходящей политики или разрешения"You don't have access to this door."
Доступ отключён"Your access has been suspended — please contact the facility."
Вне окна Access Time WindowДверь остаётся неактивной и показывает следующее время доступности, если оно передано
Нет разрешения на геолокациюОкно "Location is needed" с ярлыком Open Settings — для дверей с геозоной параметр Location должен иметь значение Precise

Каждая попытка — разрешённая или отклонённая — отображается в журналах доступа администратора с указанием причины.

Доступность по расписанию Access Policy

Для политики с будущим расписанием поддерживаемые клиенты используют структурированные данные сервера — начало и конец, метку, вид и часовой пояс, — чтобы дверь оставалась видимой и показывала, когда доступ станет возможным. Точные моменты времени используют границы [from, to). Доступность Weekly определяется сервером с использованием часового пояса IANA окна политики и правил перехода на летнее время; приложение только форматирует наступление окна.

Для совместимости старые клиенты могут получать outside_access_hours, а более новые получатели — подробность outside_access_time_window и структурированные данные о доступности.

Access Policies только разрешают доступ и объединяются по ИЛИ, но в пределах одной политики по-прежнему должны совпасть Who И Where И When. Постоянные разрешения и окна, выданные администратором или интеграцией, остаются отдельными и суммируются. blockAllAccess, отключение пользователя, режим обслуживания и геозоны по-прежнему имеют приоритет.

Блокировка приложения

Если объект требует блокировку приложения (или участник сам включил её в разделе Profile → App Lock), перед использованием приложение требует аутентификации на устройстве:

  • Если доступны Face ID / Touch ID / код-пароль устройства, используются они; на устройствах без них участнику предлагается создать 4-значный PIN-код ("Required by {facility} — managed by your site administrator.").
  • Повторный запрос выполняется в соответствии с настроенным льготным периодом; при холодном запуске и длительном отсутствии запрос выполняется всегда.
  • Участник, вошедший на нескольких объектах, получает самую строгую политику из всех.
  • После 5 неудачных попыток ввода PIN-кода приложение блокируется, и для продолжения нужно очистить данные и войти заново.

История

На вкладке History отображаются собственные действия участника по доступу на выбранном объекте, сгруппированные по дням, с фильтром по дверям. Нажатие на запись открывает окно Access Details с датой, временем, дверью, устройством, IP-адресом и картой места открытия. Это повторяет то, что администраторы видят в журналах доступа, но только для событий самого участника.

Профиль и настройки

На вкладке Profile участники могут:

  • Изменить имя и фамилию (адрес электронной почты и телефон доступны только для чтения — "To change your email or phone number, please contact your location or site administrator — these details are managed centrally for security." Администраторы изменяют их в разделе Users).
  • Просмотреть привязанные расположения.
  • Настроить App Lock (если блокировка не обязательна по решению администратора), уведомления о прибытии, автоматическое переключение расположения и оформление (светлое, тёмное или автоматическое).
  • Get Support — поддержку оказывает администратор расположения, а не центральная служба поддержки.
  • Нажать Sign Out from App или отправить запрос Delete Account & Data, который уведомляет администратора расположения и очищает данные на устройстве.

Дополнительные возможности

  • Виджет на экране «Домой» и элемент управления в Пункте управления (iOS): открытие основной двери одним касанием.
  • Приложение для Apple Watch / Wear OS: открытие с запястья; требуется вход на телефоне — см. раздел Apple Watch и Wear OS.
  • CarPlay: открытие ворот и гаражных дверей с экрана автомобиля — удобно для въездов транспорта. См. раздел CarPlay.
  • Уведомления о прибытии: если включено фоновое определение местоположения, приложение может показать уведомление "You've arrived. Tap to unlock a door.", когда участник прибывает на объект.