Синхронизация и интеграции

Синхронизация автоматически переносит людей из ваших других систем в раздел Users, поэтому доступ к дверям соответствует данным внешних источников без ручного ввода. На этой странице описаны три источника синхронизации, синхронизация сотрудников Performance Hub, идентификаторы, окна доступа (Access Time Windows), принадлежащие источнику, актуальность данных и сопоставление областей, удаления, разрешение дубликатов, панель активности синхронизации, приглашения и массовое удаление. Всё настраивается в разделе Settings → Sync settings.

Синхронизация Performance Hub staff включена по умолчанию. Синхронизация из интеграций и Computer Vision по умолчанию отключена, чтобы на существующих объектах сохранялся список, управляемый вручную; из этих источников ничего не синхронизируется, пока вы не включите источник.

Источники синхронизации

Рисунок 1. Настройки синхронизации

У каждого блока есть собственный переключатель включения, а также отображаются время последнего запуска и счётчики (или Never run).

Для источника «Интеграции» также можно включать или исключать отдельные интеграции в разделе Sync from these integrations — «Отключите интеграцию, чтобы прекратить перенос её людей. Уже синхронизированные люди остаются, пока вы их не удалите». Кнопка Show all integrations раскрывает полный список.

Обязательный идентификатор

Пользователи входят в мобильное приложение с помощью одноразового кода, отправляемого на их телефон или электронную почту, поэтому запись без телефона и электронной почты бесполезна для доступа к дверям. Раскрывающийся список Require identifier определяет, какие записи синхронизируются:

Записи, не соответствующие требованию, пропускаются (и отображаются в панели активности синхронизации как пропущенные из-за отсутствия идентификатора).

Сопоставление окон доступа и актуальность источника

У каждой интеграции, предоставляющей окна доступа (Access Time Windows), есть собственные настройки:

• Access Time Window mapping — «Сопоставьте каждый ключ области партнёра с дверями объекта или областями доступа. Неизвестные и несопоставленные ключи блокируют доступ». Для каждой интеграции можно задать до 50 сопоставлений, включая ключ default. Добавьте ключ с помощью Add partner scope key.
• Source freshness policy — параметр безопасности: «Выберите, насколько устаревшим может быть снимок партнёра, прежде чем все его окна начнут блокировать доступ». Установите значение в соответствии с тем, как часто интеграция обещает отправлять обновления, чтобы окна интеграции, переставшей обновляться, не продолжали предоставлять доступ.

О том, как обновляются окна интеграций, см. в разделе Снимки окон доступа.

Сотрудники Performance Hub

Рисунок 2. Источник Performance Hub staff

«Все, чьи роли в Performance Hub охватывают этот объект, автоматически добавляются в Users и синхронизируются с Performance Hub IAM». Например, сотрудники магазинов розничной сети получают доступ к служебной двери без ручного добавления.

• Сотрудники (пользователи Performance Hub) синхронизируются с тегами Performance Hub staff, Role: … (по одному на роль) и, для администраторов организации, Organisation admin.
• Для каждого объекта один раз создаётся редактируемая политика доступа Performance Hub staff, которая пропускает владельцев этого тега через любую дверь в любое время. На карточке показано, активна ли политика, и есть кнопка Edit policy. Изменяйте или отключайте её так же, как любую политику доступа.
• В разделе Роли показано, какие роли включены. Включаемые и исключаемые роли задаёт администратор организации в разделе Organisation Settings; другие администраторы видят сообщение «Попросите администратора организации изменить это в Organisation Settings».
• При отключении синхронизации запрашивается подтверждение («Turn off Performance Hub staff sync?»).

Данные сотрудников управляются в Performance Hub IAM и в Users доступны только для чтения. О том, как прекратить доступ сотрудника к дверям, см. в разделе Users → Сотрудники Performance Hub.

Когда выполняется синхронизация

Что обновляет синхронизация и чего она никогда не касается

При каждом проходе синхронизированные строки обновляются из источника:

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

Отвязка: если отключить Track source updates на панели пользователя, синхронизация полностью пропускает эту строку — изменения имени и контактных данных сохраняются, а удаления в источнике больше на неё не влияют. См. Users.

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

Удаления

Когда участник удаляется в интеграции, его доступ к дверям отзывается (Removed by integration). Его строка в Users не удаляется, поэтому история сохраняется.

Если синхронизация должна удалить необычно большое количество людей сразу, эти удаления задерживаются для проверки (N removals held back for review). Удаления по инициативе интеграции сверх порога безопасности ждут проверки администратором перед применением, поэтому ошибочная выгрузка из интеграции не может отозвать доступ сразу у всех.

Снимки окон доступа

Каждая интеграция обновляет только собственный раздел источника. Её обновление участников представляет собой полный снимок окон с монотонно возрастающими ревизиями:

• Если данные окон не переданы, текущий снимок источника не меняется.
• Более новый снимок заменяет весь список этого источника.
• Та же ревизия с той же нормализованной полезной нагрузкой считается идемпотентным повтором.
• Та же ревизия с другими данными считается конфликтом; более старая ревизия пропускается как устаревшая.
• Более новый пустой снимок явно отзывает окна этого источника.
• При неудачном или неполном получении данных из исходной системы снимок не должен отправляться вовсе — ни пустой, ни частичный.

Каждый стабильный ключ источника scope_key (включая default) сопоставляется с целями на уровне всего объекта, двери или области доступа в разделе Сопоставление окон доступа. Неизвестные или отключённые сопоставления блокируют доступ. В настройках также отображаются возраст источника и политика актуальности источника для интеграции.

Разрешение дубликатов

Рисунок 3. Разрешение дубликатов

«Если у двух людей совпадает адрес электронной почты или номер телефона, в Users может синхронизироваться только один из них. Выберите, кто сохранит место; другой будет помечен как конфликт и не будет синхронизирован».

• Prefer the active person — «Человек с активным статусом всегда имеет приоритет перед человеком с истёкшим статусом. Отключите, чтобы применять дополнительный критерий независимо от статуса».
• Tiebreaker — используется, когда статус не определяет победителя, например Oldest By Date Of Birth, Then Earliest Start Date.

Другая запись отображается в Users как Not synced – duplicate и учитывается в плитке Not synced. Например, медицинская клиника может сохранить одну запись, когда врач одновременно является сотрудником и участником-пациентом.

Автоматические приглашения в приложение

В разделе App invitations параметр Auto-send app invitations отправляет электронные письма подходящим синхронизированным пользователям, которые ещё не получали приглашение, а Advanced recipient rules позволяют ограничить круг получателей. Кнопка Send invitations… выполняет массовую отправку существующим пользователям после проверки списка получателей. Подробнее см. в разделе Приглашения.

Активность синхронизации и устранение неполадок

Разверните Sync activity & troubleshooting, чтобы «узнать, почему недавние записи были или не были синхронизированы». Можно искать по имени, идентификатору или причине и обновлять список кнопкой Refresh. У каждой записи есть значок результата:

Возможные причины пропуска:

Щелчок по записи открывает Sync activity detail с полной информацией: имя, внешний идентификатор, источник, интеграция, причина и идентификаторы для передачи в службу поддержки.

Массовое удаление синхронизированных пользователей

Чтобы удалить пользователей, поступивших из интеграции (например, после её отключения), используйте Bulk delete synced users. Перед удалением вы проверяете точный список.

1. В разделе Bulk delete synced users нажмите Bulk delete…
2. Выберите область: All integration-synced users или отдельная интеграция. Нажмите Preview.
3. Проверьте: в диалоговом окне указано точное количество удаляемых пользователей (с примером списка). Обратите внимание на предупреждение — This cannot be undone, и все изменения администратора в этих строках (разрешения, пользовательские теги, заметки) будут потеряны. История журналов доступа пользователей сохраняется.
4. Параметр Also turn off syncing from this integration (recommended) отмечен по умолчанию — оставьте его включённым, иначе те же пользователи будут созданы заново при следующем проходе синхронизации (без прежних изменений).
5. Установите флажок I understand this is permanent and customisations will be lost, затем нажмите Delete N.

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

Связанные страницы

• Users — источники, отвязка, панель пользователя
• Расписания политик доступа — расписания и настройки Access Time Windows
• Приглашения
• Устранение неполадок — пошаговые инструкции для случаев «пользователь отсутствует или устарел»