Support Hub/API & Integrations/Подключение биометрических устройств без публичного IP:…
Translated from the English article and reviewed by a person. Read the English original
Developer

Подключение биометрических устройств без публичного IP: объяснение Hybrid Connector

Подключение биометрических устройств без публичного IP: объяснение Hybrid Connector

Многие проекты интеграции биометрических систем останавливаются из-за вопроса, который не имеет отношения к биометрии: как облако получает доступ к устройству, находящемуся за офисным маршрутизатором? Во многих организациях нет публичного IP-адреса, IP-адрес меняется каждый день или IT-отдел не открывает входящие порты в межсетевом экране, и такая осторожность оправдана. Традиционное решение, переадресация портов (port forwarding), сложно в настройке и открывает доступ к локальной сети. Cams Biometrics решает эту задачу с помощью Hybrid Connector — небольшой программы, которая подключает вашу площадку к Gateway изнутри наружу. В этом руководстве объясняется, почему многие устройства трудно сделать доступными, как работает Hybrid Connector простыми словами, какие задачи можно выполнять через него и как его настроить.

01 · Сетевая проблема

Почему многие биометрические устройства трудно сделать доступными

Биометрическое устройство в локальной сети похоже на дом на частной дороге. Люди внутри могут выехать в любое время, но снаружи никто не попадёт внутрь, пока кто-то не откроет ворота. Чтобы облачная платформа могла напрямую обратиться к устройству, площадке нужен публичный адрес и намеренно открытое отверстие в межсетевом экране, ведущее к устройству. Во многих организациях этого просто нет, и на то есть веские причины.

Ситуация Что это значит Почему прямой доступ не работает
Нет публичного IP Интернет-провайдер использует один публичный адрес для многих клиентов Нет уникального адреса, который ведёт на вашу площадку
Изменяющийся IP-адрес Публичный IP площадки регулярно меняется Адрес, который работает сегодня, завтра может указывать на другое место
Строгая политика межсетевого экрана IT-отдел не разрешает входящие подключения из интернета Облако не может инициировать соединение с устройством
Переадресация портов невозможна Маршрутизатор управляется арендодателем, провайдером или головным офисом Никто на площадке не может открыть ворота
Вопросы безопасности Открытые порты делают внутренние системы доступными из интернета Даже если это технически возможно, многие организации не готовы принять такой риск

С этими ограничениями сталкиваются филиалы розничной торговли, строительные площадки, склады, школы и небольшие офисы. Ни одно из них не является причиной отказаться от облачной биометрической интеграции. Это причина подключать устройства иначе.

02 · Прямое и косвенное подключение

Два способа подключить устройство с Hybrid Push

Устройства Cams и устройства, прошедшие проверку на developer.camsbiometrics.com, подключаются к Gateway по Native Push и взаимодействуют с ним напрямую через интернет. Другие устройства подключаются по Hybrid Push, и Hybrid Push предлагает две топологии развёртывания. Подходящая топология полностью зависит от сети вашей площадки.

Прямая топология Косвенная топология (Hybrid Connector)
Как выполняется подключение Gateway подключается к устройству, базе данных или файлам через интернет Hybrid Connector на локальном компьютере подключается наружу к Gateway
Нужен публичный IP Да, на компьютере площадки Нет
Нужна переадресация портов Да Нет
Программное обеспечение на площадке Не требуется Hybrid Connector на локальном компьютере
Лучше подходит для Площадок с публичным IP и IT-командами, которые умеют работать с переадресацией портов Площадок за маршрутизаторами, со строгими межсетевыми экранами или без публичного IP

Самый простой выбор для большинства площадок

Если вы не можете настроить публичный IP и переадресацию портов, выберите косвенную топологию с Hybrid Connector. Она полностью исключает сетевую настройку на стороне клиента, поэтому обычно это самый простой путь для развёртывания.

03 · Изнутри наружу, а не снаружи внутрь

Как работает Hybrid Connector

Hybrid Connector меняет направление подключения. Вместо того чтобы облако пыталось попасть на вашу площадку, что-то внутри площадки само обращается к облаку. Возвращаясь к дому на частной дороге: вместо того чтобы просить кого-то открыть ворота, житель выезжает наружу и поддерживает линию связи от внешнего мира обратно к дому.

Без Hybrid Connector

Cams Gateway

Пытается достучаться до устройства из интернета

→

Маршрутизатор или межсетевой экран площадки

Блокирует входящее подключение

→

Устройство

Запрос так и не поступает

С Hybrid Connector

Устройство, база данных или файл

Остаётся в локальной сети

→

Hybrid Connector

Работает на локальном компьютере и взаимодействует с устройством локально

→

Исходящее подключение

Коннектор обращается к Gateway

→

Cams Gateway

Обменивается данными с вашей ERP/HRMS через это подключение

Поскольку подключение начинается изнутри вашей сети, оно работает так же, как веб-браузер на этом компьютере. Площадке не нужен публичный IP, а межсетевому экрану не нужно принимать какое-либо новое входящее подключение. Hybrid Connector выступает мостом между локальным устройством, базой данных или файлами с одной стороны и биометрическим Gateway с другой.

Переадресация портов открывает дверь в вашу сеть. Hybrid Connector оставляет дверь закрытой и совершает вызов изнутри.

Проверьте, какие порты разрешить

Исходящие подключения всё равно должны быть разрешены вашим межсетевым экраном. В большинстве сетей уже разрешён стандартный исходящий веб-трафик, но строгие сети могут его ограничивать. Ознакомьтесь с разделом Ports Supported в документации Cams Web API и передайте его своей IT-команде до установки.

04 · Возможности и ограничения

Что можно делать через Hybrid Connector

Hybrid Connector определяет how — то есть способ подключения вашей площадки. Он не определяет, что вы можете делать. Это задаётся способом связи, используемым для работы с устройством, и доступны три варианта.

Режим Способ связи Callback API RESTful API
Indirect Device Device SDK Полный Полный, в пределах возможностей SDK
Indirect DB DB Pull из локальной базы данных программного обеспечения устройства Только посещаемость Не поддерживается
Indirect File File Processing файла посещаемости программного обеспечения устройства Только посещаемость Не поддерживается
Способ связи Как это работает
Device SDK Gateway взаимодействует с оборудованием через SDK производителя, поэтому все функции, которые поддерживает SDK, доступны через API. Это лучший вариант для полного доступа к API
DB Pull Gateway считывает новые записи посещаемости из локальной базы данных, где их хранит программное обеспечение устройства, и отправляет их на ваш Callback URL
File Processing Назначенный файл посещаемости на локальном компьютере отслеживается непрерывно. При каждом обновлении файла программным обеспечением устройства новые записи обнаруживаются и в режиме реального времени отправляются на ваш Callback URL

Топология и возможности — это отдельные решения

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

Даже в режиме Device SDK прошивка или SDK конкретной модели устройства может ограничивать некоторые операции. Всегда проверяйте работу на реальном оборудовании и уточняйте нестандартные случаи у команды Cams.

05 · Пошагово

Настройка Hybrid Connector

Точный вид экранов зависит от вашей учётной записи Cams, но любая настройка Hybrid Connector следует одному и тому же порядку.

1

Выберите подходящий локальный компьютер

Выберите компьютер в той же локальной сети, что и устройство. Для DB Pull или File Processing это должен быть компьютер, на котором программное обеспечение устройства хранит свою базу данных или файл посещаемости, поскольку Коннектору нужен локальный доступ к ним.

2

Подтвердите исходящий доступ

Передайте сведения из раздела Ports Supported документации Cams своей IT-команде и убедитесь, что компьютер может устанавливать необходимые исходящие подключения.

3

Установите Hybrid Connector

Установите Коннектор на этот компьютер и привяжите его к своей учётной записи Cams, следуя инструкциям по настройке для вашей учётной записи.

4

Выберите способ связи

Выберите Device SDK, если Gateway поддерживает SDK вашего устройства. В противном случае выберите DB Pull или File Processing для данных посещаемости.

5

Укажите Callback URL

Укажите HTTPS-адрес вашего приёмника, HRMS, ERP или инструмента автоматизации в качестве Callback URL, чтобы события посещаемости имели куда поступать.

6

Проверьте работу от начала до конца

Приложите палец или лицо к устройству и убедитесь, что событие доходит до вашего Callback URL. В режиме Device SDK также попробуйте выполнить операцию RESTful, например добавить тестового пользователя.

Нужен приёмник для отправки событий? Промпты Cams AI Code Generator могут создать полноценный приёмник callback-событий на Python, Node.js, PHP и нескольких других языках.

06 · Рекомендации

Поддержание стабильного соединения

После установки Hybrid Connector становится частью инфраструктуры вашей площадки. Несколько простых правил помогут обеспечить его надёжную работу.

Практика Почему это важно
Используйте компьютер, который постоянно включён Если компьютер уходит в спящий режим или выключается, связь между площадкой и Gateway приостанавливается
Отключите спящий режим и гибернацию Настройки энергосбережения — самая частая причина незаметных отключений
Запускайте Коннектор автоматически После перезагрузки или отключения питания подключение должно восстанавливаться без входа в систему
Защититесь от отключений питания Небольшой ИБП (UPS) поддерживает работу компьютера и сети во время коротких перебоев
Своевременно обновляйте компьютер и поддерживайте его защиту Он находится в вашей сети, поэтому относитесь к нему как к любому другому управляемому компьютеру
Следите за пропусками в событиях Если на загруженной площадке внезапно перестают поступать события, в первую очередь проверьте компьютер и его подключение

Что происходит при разрыве соединения

Посещаемость фиксируется на устройстве, а офлайн-кэш и очередь Gateway предназначены для обработки перерывов в связи. Когда соединение восстанавливается, записи доставляются с исходными временными метками, поэтому отметки, сделанные во время сбоя, всё равно отображаются с правильным временем. При DB Pull и File Processing записи остаются в базе данных или файле программного обеспечения устройства до тех пор, пока Коннектор их не прочитает.

Часто задаваемые вопросы

Нужен ли устройствам Cams Hybrid Connector?

Нет. Устройства Cams и устройства, прошедшие проверку на developer.camsbiometrics.com, подключаются по Native Push и взаимодействуют с Gateway напрямую через интернет. Hybrid Connector используется для устройств с Hybrid Push.

Безопаснее ли Hybrid Connector, чем переадресация портов?

Он не требует открывать входящие порты в вашу локальную сеть, что устраняет распространённый источник риска. Связь работает по HTTP/HTTPS с проверкой токена авторизации, также доступно дополнительное шифрование AES-256.

IP-адрес нашей площадки меняется каждый день. Может ли это вызвать проблемы?

При косвенной топологии — нет. Поскольку Hybrid Connector подключается наружу к Gateway, площадке не нужен фиксированный или публичный IP-адрес.

Могу ли я по-прежнему добавлять и удалять пользователей через Hybrid Connector?

Да, в режиме Device SDK, в пределах возможностей SDK устройства. DB Pull и File Processing поддерживают только callback-события посещаемости, без операций RESTful.

Работает ли Hybrid Connector с моей HRMS или ERP?

Да. Коннектор обеспечивает соединение между вашей площадкой и Gateway. Ваша HRMS, ERP или инструмент автоматизации получает события через Callback API точно так же, как и при любом другом режиме подключения.

Заключение: сеть не должна определять вашу интеграцию

Долгое время сеть в месте расположения устройства незаметно определяла, какие биометрические интеграции возможны. Отсутствие публичного IP означало отсутствие облачного подключения. Строгий межсетевой экран означал долгие согласования с IT. Изменяющийся IP-адрес означал интеграции, которые ломались без предупреждения.

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

Cams Biometrics Gateway подключает устройства к сети в любом месте. Native Push напрямую подключает устройства Cams и прошедшие проверку устройства. Hybrid Push подключает устройства других брендов через Device SDK, DB Pull или File Processing, используя либо прямую топологию, либо Hybrid Connector, если публичный IP недоступен. Каждое событие поступает в ваши системы через один и тот же Callback API, с проверкой токена авторизации и дополнительным шифрованием AES-256. Изучите платформу на CamsBiometrics.com, ознакомьтесь с полной документацией, включая режимы подключения и поддерживаемые порты, на developer.camsbiometrics.com, а создать свой приёмник можно с помощью промптов AI Code Generator.

Was this article helpful?