Підтримувані пристрої та режими підключення

Які термінали підтримує шлюз, як підключається кожен із них (Native Push чи Hybrid Push) і які операції API доступні в кожному режимі.

Вступ

Сумісність пристроїв

Cams Biometric Gateway підтримує всі біометричні термінали обліку відвідуваності та контролю доступу. Вам потрібно лише обрати режим підключення, що підходить для вашої інфраструктури.

Native Push

Термінали Cams

Усі термінали на camsbiometrics.com/product. Повний API — усі 38 операцій, налаштування не потрібне.

Native Push

Перевірені пристрої

Пристрої, перевірені на developer.camsbiometrics.com. Повний API — усі 38 операцій.

Hybrid Push

Усі інші бренди

Будь-який інший термінал працює через Hybrid Push. Ви обираєте режим підключення, що відповідає вашій інфраструктурі, — можливості API залежать від обраного режиму.

Підтримувані бренди пристроїв

Cams Biometrics ZKTeco Suprema Hikvision Anviz Morpho / IDEMIA Virdi Mantra Nitgen Realtime / Startek Biomax Secugen eSSL Matrix COSEC + Будь-який інший бренд

Підтримувані способи автентифікації

Відбиток пальця Розпізнавання обличчя Вени долоні RFID-картка PIN-код / пароль QR / штрихкод GPS-відстеження

Біометричні термінали Cams: SlimBeast (i34), Macronium (i35), Hawking Plus (f38+), Hawking (f38), Ultron MultiFaceFP (f34), Ultron MultiFace (f35), Galaxy (f36), Ultron GPS (f37), CanBio34, GymBio34, RSP10i3, RSP10f1 та інші.

Вступ

Режими підключення та доступність API

Кожен біометричний термінал підключається до Cams Biometric Gateway в одному з двох push-режимів. Режим визначається типом вашого пристрою.

Native Push Пристрої Cams і перевірені пристрої

Усі термінали Cams Biometrics і пристрої, перевірені на developer.camsbiometrics.com, підключаються через Native Push. Додаткове налаштування не потрібне — пристрій обмінюється даними з Biometric Gateway напряму через інтернет.

Повна підтримка API. Усі 38 операцій працюють без обмежень — і Callback API, і RESTful API. Нульова затримка для callback, ~15 секунд для RESTful-команд.

Hybrid Push Усі інші термінали

Для терміналів не від Cams і неперевірених ви обираєте режим підключення Hybrid Push, що підходить для вашого середовища. Набір доступних функцій API визначається поєднанням способу обміну даними та топології розгортання.

Способи обміну даними

(a) SDK пристроюШлюз взаємодіє з обладнанням через SDK виробника пристрою. Через API доступні всі функції, які підтримує SDK. Найкращий варіант для повного доступу до API.

(b) Зчитування з БДШлюз зчитує дані з локальної бази даних, встановленої на комп'ютері на об'єкті (де ПЗ пристрою зберігає відвідуваність). Підтримується лише надсилання журналу відвідуваності/відміток на ваш сервер. Без RESTful API (немає додавання й видалення користувачів, завантаження журналу тощо).

(c) Обробка файлуУказаний файл відвідуваності на локальному комп'ютері перебуває під постійним наглядом. Щоразу, коли ПЗ пристрою оновлює файл, нові записи відвідуваності автоматично виявляються, зчитуються й надсилаються на ваш Callback URL у реальному часі. Обмеження API ті самі, що й для зчитування з БД -- лише надсилання відвідуваності, без RESTful API.

Топології розгортання

(X) ПрямаКомп'ютер на об'єкті має публічну IP-адресу з прокиданням портів до локальної мережі. Biometric Gateway підключається до пристрою/БД/файлів напряму через інтернет.

(Y) НепрямаНа локальний комп'ютер встановлюється Hybrid Connector. Він слугує мостом між локальним пристроєм/БД/файлами та Biometric Gateway — публічна IP-адреса на стороні клієнта не потрібна.

Hybrid Push — матриця доступних функцій

Режим	Спосіб обміну даними	Топологія	Callback API	RESTful API
Прямий пристрій	(a) SDK	(X) Публічний IP	Повний	Повний (у межах SDK)
Непрямий пристрій	(a) SDK	(Y) Hybrid Connector	Повний	Повний (у межах SDK)
Пряма БД	(b) Зчитування з БД	(X) Публічний IP	Лише відвідуваність	Не підтримується
Непряма БД	(b) Зчитування з БД	(Y) Hybrid Connector	Лише відвідуваність	Не підтримується
Прямий файл	(c) Файл	(X) Публічний IP	Лише відвідуваність	Не підтримується
Непрямий файл	(c) Файл	(Y) Hybrid Connector	Лише відвідуваність	Не підтримується

Який режим обрати? Якщо ваш пристрій не від Cams має SDK, що підтримується шлюзом, оберіть режим SDK пристрою (a) для повного доступу до API. Якщо ні, дані про відвідуваність усе одно надходитимуть через зчитування з БД (b) або обробку файлу (c). Для топології обирайте непряму (Y) з Hybrid Connector, якщо не можете налаштувати публічний IP, — її найпростіше розгорнути.

Апаратні обмеження можуть додатково звужувати функції API. Навіть у режимі SDK пристрою окремі API можуть не працювати залежно від прошивки моделі чи можливостей SDK. Завжди тестуйте на своєму обладнанні та уточнюйте в служби підтримки Cams.