지원 장비 및 연결 모드
게이트웨이가 지원하는 장비, 각 장비의 연결 방식(Native Push 또는 Hybrid Push), 그리고 모드별로 사용할 수 있는 API 오퍼레이션을 설명합니다.
소개
장비 호환성
Cams Biometric Gateway는 모든 생체인식 근태 및 출입 통제 장비를 지원합니다. 사용자가 결정할 것은 사용 환경에 맞는 연결 모드뿐입니다.
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에 연결됩니다. 장비 유형에 따라 사용할 모드가 결정됩니다.
Native Push Cams 및 검증된 장비
모든 Cams Biometrics 장비와 developer.camsbiometrics.com에서 검증된 장비는 Native Push로 연결됩니다. 추가 설정이 필요 없으며, 장비가 인터넷을 통해 Biometric Gateway와 직접 통신합니다.
전체 API 지원. 콜백 API와 RESTful API 모두에서 38개 오퍼레이션이 제한 없이 동작합니다. 콜백은 지연이 없고 RESTful 명령은 약 15초입니다.
Hybrid Push 기타 모든 장비
Cams 장비가 아니거나 검증되지 않은 장비는 사용 환경에 맞는 Hybrid Push 연결 모드를 선택합니다. 통신 방식과 배포 토폴로지의 조합에 따라 사용 가능한 API 기능이 결정됩니다.
통신 방식
(a) 장비 SDK게이트웨이가 장비 제조사의 SDK를 통해 하드웨어와 통신합니다. SDK가 지원하는 모든 기능을 API로 사용할 수 있습니다. 전체 API를 사용하기에 가장 좋은 방법입니다.
(b) DB 풀게이트웨이가 현장 PC에 설치된 로컬 데이터베이스(장비 소프트웨어가 근태를 저장하는 곳)에서 데이터를 읽습니다. 사용자 서버로의 근태/기록 로그 푸시만 지원됩니다. RESTful API는 지원되지 않습니다(사용자 추가/삭제, 로그 불러오기 등 불가).
(c) 파일 처리로컬 PC의 지정된 근태 파일을 지속적으로 감시합니다. 장비 소프트웨어가 파일을 업데이트할 때마다 새 근태 레코드가 자동으로 감지·수집되어 콜백 URL로 실시간 푸시됩니다. API 제한은 DB 풀과 동일하며, 근태 푸시만 지원되고 RESTful API는 지원되지 않습니다.
배포 토폴로지
(X) 직접 연결현장 PC에 로컬 네트워크로 포트 포워딩이 설정된 공인 IP가 있습니다. Biometric Gateway가 인터넷을 통해 장비/DB/파일에 직접 연결합니다.
(Y) 간접 연결로컬 PC에 Hybrid Connector를 설치합니다. 로컬 장비/DB/파일과 Biometric Gateway 사이의 브리지 역할을 하며, 고객 측에 공인 IP가 필요 없습니다.
Hybrid Push — 기능 지원 매트릭스
| 모드 | 통신 방식 | 토폴로지 | 콜백 API | RESTful API |
|---|---|---|---|---|
| 직접 연결 장비 | (a) SDK | (X) 공인 IP | 전체 지원 | 전체 지원 (SDK 제한 있음) |
| 간접 연결 장비 | (a) SDK | (Y) Hybrid Connector | 전체 지원 | 전체 지원 (SDK 제한 있음) |
| 직접 연결 DB | (b) DB 풀 | (X) 공인 IP | 근태만 지원 | 지원 안 됨 |
| 간접 연결 DB | (b) DB 풀 | (Y) Hybrid Connector | 근태만 지원 | 지원 안 됨 |
| 직접 연결 파일 | (c) 파일 | (X) 공인 IP | 근태만 지원 | 지원 안 됨 |
| 간접 연결 파일 | (c) 파일 | (Y) Hybrid Connector | 근태만 지원 | 지원 안 됨 |
어떤 모드를 선택해야 하나요? Cams 장비가 아닌 장비에 게이트웨이가 지원하는 SDK가 있다면 전체 API를 사용할 수 있는 장비 SDK 모드 (a)를 선택하세요. 그렇지 않더라도 DB 풀 (b) 또는 파일 처리 (c)로 근태 데이터를 수집할 수 있습니다. 토폴로지는 공인 IP를 설정할 수 없다면 Hybrid Connector를 사용하는 간접 연결 (Y)이 가장 배포하기 쉽습니다.
하드웨어 제한으로 인해 API 기능이 추가로 제한될 수 있습니다. 장비 SDK 모드에서도 장비 모델의 펌웨어나 SDK 기능에 따라 특정 API가 동작하지 않을 수 있습니다. 반드시 사용 중인 하드웨어로 테스트하고 Cams 지원팀에 확인하세요.