Support Hub/API & Integrations/생체인식 장치 배포: Native Push와 Hybrid Push 비교
Translated from the English article and reviewed by a person. Read the English original
Developer

생체인식 장치 배포: Native Push와 Hybrid Push 비교

생체인식 장치 배포: Native Push와 Hybrid Push 비교

개요: 생체인식 장치 연결의 과제 이해하기

생체인식 출퇴근 시스템과 출입 통제 장치는 네트워크 인프라, 연결 방식, 보안 요구 사항이 서로 다른 다양한 환경에서 운영됩니다. 조직은 중대한 과제에 직면합니다. 지문 인식기, 얼굴 인식 단말기, 홍채 인식기, 손바닥 정맥 인식기 등 생체인식 장치가 서로 호환되지 않는 통신 프로토콜을 가진 여러 제조사의 제품일 때, 이를 기존 HRMS(인사 관리 시스템), ERP(전사적 자원 관리) 플랫폼 또는 출퇴근 관리 소프트웨어에 어떻게 연동할 것인가 하는 문제입니다.

Biometric Gateway는 적응형 배포 아키텍처를 통해 이 근본적인 연동 과제를 해결합니다. 이 아키텍처는 장치 기능, 네트워크 토폴로지, 인프라 제약에 따라 최적의 통신 방식을 자동으로 선택하여, 제조사, 모델, 연식, 연결 능력에 관계없이 모든 생체인식 장치를 어떤 출퇴근 관리 시스템이나 인력 관리 플랫폼과도 연동할 수 있게 합니다.

장치 호환성 과제: 범용 지원이 중요한 이유

생체인식 하드웨어의 제조사 분산

전 세계 생체인식 장치 시장에는 수백 개 제조사가 수천 가지 장치 모델을 생산하고 있습니다.

  • ZKTeco 장치: F18, K40, InBio 출입 통제 컨트롤러, SpeedFace 시리즈 포함
  • Suprema BioStar: BioEntry, BioLite, FaceStation 얼굴 인식 단말기
  • Anviz 생체인식 단말기: FacePass, CrossChex, VF30 Pro 얼굴 및 지문 장치
  • eSSL (Matrix Comsec): X990, K21 Pro, MB360 다중 생체인식 리더
  • Realtime (Startek): T502, T9, T52 지문 및 RFID 출퇴근 단말기
  • Virdi: AC-2100, AC-5000 출입 통제 및 근태 관리 시스템
  • Nitgen: eNBioAccess, Fingkey Hamster 지문 인식기
  • Morpho (IDEMIA): MSO 1300, Sigma 시리즈 지문 인증 장치
  • Mantra: MFS100, MFS110 지문 센서 및 MADT50 태블릿
  • Secugen: Hamster Plus, OptiMouse 지문 리더
  • Hikvision: DS-K1T 시리즈 얼굴 인식 단말기
  • Time Watch: SG-100, SG-300 출퇴근 단말기
  • Biomax: N-BM180, Bio5000 손바닥 정맥 및 지문 장치

각 제조사는 고유한 통신 프로토콜, 데이터 형식, 연동 방식을 개발합니다. 기존의 연동 방식은 제조사마다 별도의 개발이 필요해 벤더 종속을 만들고 하드웨어 선택에서 고객의 선택권을 제한합니다.

네트워크 인프라의 차이

조직은 근본적으로 서로 다른 네트워크 아키텍처에 생체인식 시스템을 배포합니다.

  • 클라우드 연결 환경: 장치가 WiFi, 이더넷 또는 셀룰러 연결을 통해 인터넷에 직접 접속합니다
  • 에어갭(air-gapped) 네트워크: 제조 시설, 국방 시설 또는 보안 정부 기관처럼 생체인식 장치가 인터넷이 없는 격리된 네트워크에서 운영됩니다
  • DMZ(비무장지대) 배포: 생체인식 출입 통제 장치가 내부 네트워크와 공용 인터넷 모두로부터 분리된 네트워크 구간에 위치하는 기업 보안 아키텍처입니다
  • VPN 전용 접속: 장치가 가상 사설망(VPN)을 통해 연결되는 원격지, 지사 또는 소매점입니다
  • 프록시 제한 네트워크: 모든 외부 연결이 인증이 필요한 프록시 서버를 거쳐야 하는 기업 환경입니다
  • 방화벽으로 보호되는 환경: 인바운드 연결을 차단하거나 아웃바운드 트래픽을 특정 포트와 프로토콜로 제한하는 엄격한 방화벽 정책을 가진 조직입니다

기존 생체인식 연동 솔루션은 특정 네트워크 구성을 전제로 하기 때문에, 조직이 장치 연결 요구 사항에 맞춰 인프라를 수정해야 합니다. 이는 보안 위험, 규정 위반, 구현 지연을 초래합니다.

장치 호환성 검증: 첫 번째 단계

Cams Biometrics 네이티브 장치

Cams Biometrics가 제조한 모든 생체인식 장치에는 내장 네이티브 푸시 기능이 포함되어 있습니다. 지문 출퇴근 단말기, 얼굴 인식 시스템, 다중 방식 생체인식 리더를 포함한 이 장치들은 사전 구성된 클라우드 연결과 함께 출고되며, 추가 소프트웨어 설치나 프로토콜 업데이트 없이 전체 Biometric Web API를 지원합니다.

네이티브 기능은 다음과 같습니다.

  • HTTPS 웹훅을 통한 실시간 트랜잭션 푸시
  • 장치 관리를 위한 양방향 REST API 통신
  • 자동 오프라인 데이터 큐잉 및 동기화
  • 생체 템플릿 전송을 통한 원격 사용자 등록
  • 클라우드 기반 장치 설정 및 펌웨어 업데이트

타사 장치 검증 절차

다른 제조사의 생체인식 장치(Cams가 아닌 하드웨어)는 developer.camsbiometrics.com 플랫폼을 통해 호환성 검증이 이루어집니다. 이 검증 포털은 공식 제휴 제조사 장치와의 통신 호환성을 테스트합니다.

검증 절차:

  1. 장치 등록: 장치 모델 번호, 시리얼 번호, 제조사 정보를 입력합니다
  2. 프로토콜 테스트: 자동화된 테스트로 표준화된 생체인식 데이터 교환 프로토콜을 사용하여 장치가 통신할 수 있는지 확인합니다
  3. 통신 검증: 시스템이 상호 프로토콜 합의에 따라 장치가 출퇴근 트랜잭션을 전송하고, 사용자 등록 데이터를 수신하며, 설정 명령에 응답할 수 있는지 확인합니다
  4. 호환성 판정: 테스트 결과를 바탕으로 시스템이 장치가 Native Push 배포에 적합한지, 또는 Hybrid 배포가 필요한지 판정합니다

검증 결과:

  • 검증 성공: 장치가 프로토콜을 완전히 준수함 → Native Push 배포 활성화
  • 검증 실패 또는 문제 감지: 장치가 프로토콜 요구 사항을 충족하지 못하거나, 호환되지 않는 펌웨어를 사용하거나, 통신 오류가 발생함 → Hybrid 배포 권장

이 검증은 장치 사양이나 제조사의 주장에 대한 가정이 아니라, 실제로 테스트된 기술 역량에 근거하여 배포 모드를 선택하도록 보장합니다.

일부 장치에 Hybrid 배포가 필요한 이유

장치가 호환성 검증에 실패하는 데에는 여러 기술적 이유가 있습니다.

  • 독자 프로토콜: 장치가 표준화된 푸시 프로토콜과 호환되지 않는 제조사 고유의 통신 방식을 사용합니다
  • 펌웨어 한계: 오래된 펌웨어 버전에는 클라우드 연결 기능이나 웹훅 지원이 없습니다
  • 하드웨어 제약: 장치의 프로세서나 메모리가 지속적인 클라우드 연결을 유지하기에 부족합니다
  • 인증서 검증 문제: 장치의 SSL/TLS 구현이 최신 인증서 요구 사항과 호환되지 않습니다
  • 데이터 형식 비호환: 장치가 변환이 필요한 비표준 형식으로 출퇴근 데이터를 전송합니다
  • 연결 한계: 장치의 네트워크 스택이 필요한 프로토콜(HTTP/2, WebSocket 등)을 지원하지 않습니다

장치가 검증을 통과하지 못하면, Hybrid Push Service가 장치의 실제 기능과 한계 내에서 작동하는 대체 통신 경로를 제공합니다.

배포 아키텍처 옵션 1: Native Push (전체 기능 Web API)

Native Push 배포란?

Native Push는 생체인식 장치가 Biometric Web API를 사용하여 Biometric Gateway 클라우드 플랫폼과 직접 통신하는 직접 클라우드 연동 방식입니다. 이 배포 방식은 최고 성능과 최소 지연 시간으로 전체 기능을 제공합니다.

Native Push는 장치 자체가 다음을 수행한다는 의미입니다.

  • 클라우드 API 엔드포인트에 직접 HTTPS 연결을 설정합니다
  • 출퇴근 트랜잭션이 발생하는 즉시 푸시합니다
  • 사용자 관리와 장치 설정을 위한 REST API 명령을 수신합니다
  • 실시간 제어를 위해 양방향 통신을 유지합니다
  • 자체적으로 오프라인 데이터 큐잉과 자동 동기화를 처리합니다

Native Push의 기술 아키텍처

통신 흐름:

Biometric Device (Fingerprint/Face Terminal) 
    ↓ [HTTPS/TLS 1.2+]
    ↓ [Real-time webhook POST requests]
    ↓
Cloud API Gateway (api.camsbiometrics.com)
    ↓ [Webhook delivery to partner endpoint]
    ↓
Partner Application (HRMS/ERP/Attendance System)

프로토콜 세부 정보:

  • 전송: TLS 1.2 이상 암호화를 사용한 TCP/IP 기반 HTTPS
  • 인증: 요청 서명을 포함한 API 키 기반 인증
  • 데이터 형식: 트랜잭션 데이터와 API 요청용 JSON 페이로드
  • 웹훅 전달: 파트너가 설정한 콜백 URL로의 POST 요청
  • API 메서드: 장치 작업을 위한 RESTful HTTP 인터페이스

Native Push 기능: 전체 기능 세트

실시간 출퇴근 트랜잭션 전달

장치가 온라인(인터넷에 연결)일 때:

  • 출퇴근 이벤트 발생 (지문 스캔, 얼굴 인식, RFID 카드 태그)
  • 장치가 타임스탬프, 사용자 ID, 생체 일치 점수가 포함된 트랜잭션 기록을 생성합니다
  • 장치가 즉시 클라우드 API로 HTTPS POST 요청을 전송합니다 (지연 시간 < 1초)
  • 클라우드 API가 트랜잭션을 검증하고 데이터를 처리한 뒤 파트너 애플리케이션으로 웹훅을 트리거합니다
  • 파트너 애플리케이션이 출퇴근 기록을 실시간으로 수신하여 즉시 처리합니다

장치가 오프라인(인터넷 연결 없음)일 때:

  • 장치가 출퇴근 트랜잭션을 로컬 메모리에 저장합니다 (내부 저장 용량은 모델에 따라 다르며 일반적으로 50,000~100,000건)
  • 장치는 중단 없이 생체 출퇴근을 수집하며 정상적으로 계속 작동합니다
  • 인터넷 연결이 복구되면 (WiFi 재연결, 이더넷 케이블 재연결, 셀룰러 신호 복귀)
  • 장치가 연결 복구를 자동으로 감지합니다
  • 장치가 저장된 모든 오프라인 트랜잭션을 큐에 넣고 시간순으로 클라우드 API에 푸시합니다
  • 수동 개입이 필요 없고, 데이터 손실이 없으며, 완전 자동 동기화됩니다

양방향 REST API 통신

Native Push 배포는 프로그램 방식의 장치 관리를 위한 완전한 REST API 접근을 제공합니다. Biometric Web API documentation에 따라 다음 작업을 사용할 수 있습니다.

실시간 데이터 전달 작업:

  • 출퇴근 트랜잭션 웹훅: 직원 식별 정보, 타임스탬프, 인증 방식, 장치 위치, 일치 품질 점수와 함께 생체 인증 이벤트(출근, 퇴근, 휴식 시작, 휴식 종료)를 자동으로 푸시합니다
  • 이벤트 알림: 변조 감지, 배터리 부족 경고, 문 강제 개방 알림, 잘못된 출입 시도, 시스템 오류 등 장치 이벤트에 대한 실시간 알림입니다
  • 상태 업데이트: 온라인/오프라인 상태 변경, 메모리 사용률, 네트워크 연결 상태, 운영 알림을 포함한 지속적인 장치 상태 모니터링입니다

사용자 등록 및 관리 작업:

  • 장치에 새 사용자 추가: 직원 ID, 성명, 부서 배정, 역할 분류, 출입 권한 등 인적 정보와 함께 직원을 등록합니다
  • 생체 템플릿 원격 등록: 중앙 등록 스테이션에서 분산된 장치로 지문 패턴, 얼굴 인식 데이터, 홍채 스캔 또는 손바닥 정맥 템플릿을 업로드합니다
  • 사용자 데이터베이스 조회: 등록 상태, 부여된 출입 수준, 활성/비활성 상태, 마지막 인증 타임스탬프를 포함한 전체 직원 목록을 장치에서 조회합니다
  • 사용자 정보 업데이트: 직원 세부 정보 수정, 부서 배정 변경, 출입 권한 조정, 유효 기간 갱신, 인증 요구 사항 변경을 수행합니다
  • 사용자 등록 삭제: 장치에서 직원을 제거하고, 생체 템플릿을 삭제하며, 출입 권한을 취소하고, 인증 기록을 지웁니다
  • 대량 사용자 작업: 여러 직원 기록을 동시에 업로드하고, 장치 전체에 걸쳐 출입 권한을 일괄 업데이트하며, 퇴사한 직원을 일괄 삭제하고, 여러 위치의 사용자 데이터베이스를 동기화합니다
  • 출입 수준 설정: 시간 기반 출입 규칙을 정의하고, 인증 모드(지문만, 얼굴+지문 조합, 카드+생체 인증)를 설정하며, 인증 임계값을 구성하고, 예외 권한을 설정합니다

장치 설정 및 제어 작업:

  • 장치 상태 조회: 펌웨어 버전, 시리얼 번호, 모델 식별 정보, 메모리 용량, 현재 사용자 수, 템플릿 저장소 사용률, 네트워크 설정, 마지막 통신 타임스탬프 등 실시간 정보를 가져옵니다
  • 운영 매개변수 설정: 인증 민감도 임계값을 조정하고, 인증 제한 시간을 설정하고, 다중 인증 요구 사항을 구성하고, 실패 시도 후 잠금 정책을 정의하며, 보안 매개변수를 설정합니다
  • 출퇴근 규칙 관리: 근무 일정 설정, 교대 시간 정의, 초과근무 계산 구성, 휴식 시간 규칙 설정, 공휴일 달력 지정을 수행합니다
  • 출입 권한 제어: 도어 잠금 해제 시간을 정의하고, 재잠금 시간을 설정하고, 안티패스백 규칙을 구성하고, 시간대별 출입 구역(시간 기반 권한)을 설정하며, 방문자 출입 절차를 관리합니다
  • 자동 작업 예약: 교대 시간 변경용 벨/알람 일정을 구성하고, 음성 안내 시간을 설정하고, 자동 도어 잠금/해제 일정을 정의하며, 정기 상태 보고를 설정합니다
  • 화면 표시 설정 사용자 지정: 화면 밝기를 조정하고, 제한 시간을 설정하고, 언어 환경설정을 구성하고, 사용자 로고를 업로드하며, 환영 메시지를 정의합니다
  • 통신 설정 관리: 네트워크 매개변수(IP 주소, 서브넷 마스크, 게이트웨이, DNS 서버)를 구성하고, WiFi 자격 증명을 설정하고, 연결 모드를 조정하며, 장애 조치 프로토콜을 설정합니다

출퇴근 데이터 조회 작업:

  • 과거 기록 조회: 날짜 범위별로 출퇴근 트랜잭션을 가져오고, 직원 ID로 필터링하고, 부서별로 검색하고, 특정 장치를 조회하며, 인증 유형별로 기록을 추출합니다
  • 트랜잭션 로그 다운로드: 타임스탬프, 직원 식별자, 출근/퇴근 상태, 인증 모드, 장치 위치, 일치 점수가 포함된 전체 출퇴근 기록을 내보냅니다
  • 감사 추적 접근: 시스템 이벤트를 검토하고, 설정 변경을 추적하고, 사용자 등록 활동을 모니터링하며, 출입 통제 결정을 검토합니다
  • 출퇴근 요약 생성: 근무 시간을 계산하고, 부서별 출퇴근을 집계하고, 초과근무를 산정하고, 지각을 추적하며, 조퇴를 식별합니다

시스템 관리 작업:

  • 펌웨어 관리: 현재 버전을 확인하고, 원격 업데이트를 시작하고, 유지보수 시간대를 예약하며, 업데이트 완료를 검증합니다
  • 진단 작업: 시스템 로그를 가져오고, 오류 메시지에 접근하고, 네트워크 연결 이력을 검토하고, 인증 실패를 조사하며, 성능 지표를 분석합니다
  • 백업 및 복원: 장치 설정을 내보내고, 사용자 데이터베이스를 저장하고, 시스템 설정을 백업하며, 이전 상태로 복원합니다
  • 다중 장치 조정: 장치 전체의 시간을 동기화하고, 장치 그룹에 설정을 배포하고, 사용자 데이터베이스 업데이트를 조정하며, 중앙 집중식 출입 정책을 관리합니다

전체 생체 등록 워크플로

원격 등록(클라우드에서 장치로):

  1. 파트너 애플리케이션이 임의의 위치(HR 사무실, 원격 등록 스테이션, 모바일 앱)에서 생체 데이터(지문 스캔, 얼굴 사진)를 수집합니다
  2. 애플리케이션이 직원 식별 정보와 템플릿 품질 지표와 함께 생체 템플릿을 클라우드 API에 업로드합니다
  3. 클라우드 API가 템플릿 품질을 검증하고, 신원 충돌을 방지하기 위해 전체 데이터베이스에서 중복 등록 여부를 확인합니다
  4. 클라우드 API가 직원에게 배정된 위치를 기준으로 검증된 템플릿을 대상 생체인식 장치에 푸시합니다
  5. 장치가 템플릿을 수신해 로컬 메모리에 저장하고, 빠른 인증을 위해 색인한 뒤 사용자가 즉시 인증 가능하도록 합니다
  6. 직원은 사전에 현장에 방문하지 않고도 장치에서 인증할 수 있어 당일 출입 권한 부여가 가능합니다

로컬 등록(장치 직접):

  1. 관리자가 로컬 장치 인터페이스(키패드, 터치스크린 또는 연결된 등록 단말기)를 통해 장치에 사용자를 추가합니다
  2. 사용자가 생체인식 단말기에서 지문을 여러 번(일반적으로 3회) 스캔하거나 얼굴을 직접 등록합니다
  3. 장치가 생체 템플릿을 수집하고, 품질 평가를 수행하며, 템플릿의 고유성을 확인합니다
  4. 장치가 템플릿을 로컬 비휘발성 메모리에 저장하고 즉시 사용자 등록 데이터를 클라우드로 푸시합니다
  5. 구성된 경우 클라우드 API가 여러 장치에 걸쳐 사용자 등록을 동기화합니다 (자동 템플릿 배포)
  6. 파트너 애플리케이션이 직원 ID, 등록 타임스탬프, 장치 위치, 템플릿 품질 점수가 포함된 사용자 등록 알림을 웹훅으로 수신합니다

장치 제어 및 설정

원격 작업:

  • 펌웨어 업데이트: 예약된 유지보수 시간대에 클라우드에서 장치로 업데이트된 펌웨어를 푸시하고, 버전 호환성을 확인하고, 업데이트 진행 상황을 모니터링하며, 설치 성공을 확인합니다
  • 출입 통제 규칙: 직원 그룹별 허용 시간대를 업데이트하고, 부서별 제한을 설정하고, 공휴일 출입 정책을 구성하며, 방문자 인증 절차를 설정합니다
  • 벨/알람 일정: 제조 현장의 교대 변경 신호를 구성하고, 휴식 시간 알람을 설정하고, 학교 종 일정을 정의하며, 오디오 안내 방송을 사용자 지정합니다
  • 음성 안내: 언어 환경설정을 선택하고, 사용자 음성 메시지를 업로드하고, 안내 트리거(인증 성공, 출입 거부, 시스템 알림)를 구성하며, 음량을 조정합니다
  • 화면 표시 사용자 지정: 시간대에 따라 화면 밝기를 설정하고, 절전을 위한 제한 시간을 구성하고, 언어와 날짜 형식을 조정하고, 회사 로고를 업로드하며, 환영 메시지를 정의합니다
  • 인증 모드: 1:1 인증(카드 + 생체)과 1:N 식별(생체만)을 전환하고, 보안과 편의성의 균형을 위해 일치 임계값을 조정하고, 다중 인증을 활성화하며, 백업 인증 방식을 구성합니다

다중 장치 관리:

  • 중앙 집중식 장치 제어: 개별 장치에 접근하지 않고 단일 API 인터페이스에서 수백, 수천 대의 장치를 관리합니다
  • 대량 사용자 등록: 새 직원을 모든 관련 위치에 동시에 추가하여 시설 전체 또는 조직 전체에서 즉시 출입할 수 있게 합니다
  • 동기화된 설정: 장치 그룹(모든 로비 단말기, 모든 제조 현장 장치, 모든 임원 출입 지점)에 동일한 설정을 푸시하여 일관성을 유지합니다
  • 원격 진단: 현장 방문 없이 연결 문제를 해결하고, 오류 로그를 검토하고, 메모리 사용률을 확인하며, 오작동 장치를 식별합니다
  • 자동 모니터링: 장치 오프라인 이벤트, 배터리 부족 상태, 메모리 가득 참 경고, 인증 이상에 대한 사전 알림을 수신합니다

Native Push 네트워크 요구 사항

인터넷 연결:

  • 장치에 인터넷 접근이 필요합니다 (WiFi, 이더넷, 4G/5G 셀룰러 또는 기타 IP 연결)
  • 연결은 간헐적이어도 됩니다 – 장치는 자동 큐잉을 통해 일시적인 연결 끊김을 원활하게 처리합니다
  • 최소 대역폭: 장치당 10-50 Kbps (일반적인 출퇴근 트랜잭션은 1-2 KB)
  • 지연 시간 허용 범위: 위성 연결, 3G/4G 셀룰러, 일반 사무실 WiFi에서 작동합니다 (최대 5000ms까지 허용)

방화벽 설정:

  • 장치 서브넷에서 api.camsbiometrics.com으로 나가는 HTTPS(포트 443)를 허용해야 합니다
  • 인바운드 연결은 필요하지 않습니다 (장치가 클라이언트로서 모든 연결을 시작합니다)
  • 포트 포워딩이 필요하지 않습니다 (아웃바운드 전용 통신 모델)
  • NAT(네트워크 주소 변환)와 호환됩니다 – NAT 라우터 뒤의 장치도 정상적으로 작동합니다
  • 표준 아웃바운드 웹 접근 정책을 가진 기업 방화벽 뒤에서도 작동합니다

DNS 확인:

  • 장치가 api.camsbiometrics.com 도메인 이름을 IP 주소로 확인할 수 있어야 합니다
  • 표준 DNS 서버를 사용할 수 있습니다 (Google DNS 8.8.8.8, 조직 DNS, ISP DNS 등)
  • 안정성을 위해 보조 DNS로의 폴백을 권장합니다

Native Push 배포를 사용해야 하는 경우

Native Push에 이상적인 시나리오:

  • 클라우드 연결이 가능한 최신 장치를 사용하는 신규 생체인식 시스템 구축
  • 장치 설치 위치에 표준 인터넷 연결이 있는 조직
  • SaaS(Software-as-a-Service) 아키텍처를 선호하는 클라우드 우선 IT 전략
  • 다중 지점 배포 (소매 체인, 분산 사무실, 지점 네트워크)
  • 실시간 출퇴근 가시성이 필요한 모바일 인력 애플리케이션
  • 장치가 (직접 또는 기업 네트워크를 통해) 인터넷에 접속할 수 있는 환경
  • 전체 API 기능(원격 사용자 관리, 장치 설정)이 필요한 상황

Native Push를 사용하는 조직:

  • 각 매장에 지문 출퇴근 단말기를 둔 소매 체인
  • 건물 출입구에 얼굴 인식 출입 통제를 설치한 기업 사무실
  • 교실에 생체인식 출퇴근 시스템을 갖춘 교육 기관
  • 관리 의약품 출입을 위해 손바닥 정맥 인증을 사용하는 의료 시설
  • 창고 하역장에 지문 단말기를 둔 물류 회사
  • 다중 방식 출퇴근 시스템을 사용하는 BPO(업무 프로세스 아웃소싱) 센터
  • 객실 관리 및 프런트 직원의 근무 시간을 생체인식으로 기록하는 호텔 체인

배포 아키텍처 옵션 2: Hybrid Push Service

Hybrid Push 배포란?

Hybrid Push Service는 생체인식 장치가 Native Push 배포를 지원할 수 없을 때 사용하는 대체 연동 아키텍처입니다. 이는 장치가 developer.camsbiometrics.com에서 호환성 검증에 실패하거나, 네트워크 인프라로 인해 장치가 직접 클라우드 연결을 유지할 수 없을 때 발생합니다.

Hybrid Push는 중간 구성 요소를 도입합니다.

  • 컴퓨터, 서버 또는 엣지 장치(Windows PC, Linux 서버, Raspberry Pi 등)가 생체인식 장치와 클라우드 사이에 위치합니다
  • 이 중간 장치는 장치가 지원하는 프로토콜로 통신하는 소프트웨어(SDK, 로컬 서비스 또는 데이터베이스 커넥터)를 실행합니다
  • 중간 장치는 인터넷에 연결되어 있으며 클라우드 API와 통신합니다
  • 생체인식 장치 자체는 인터넷에 접속할 수도, 접속하지 않을 수도 있습니다

핵심 아키텍처 차이:

  • Native Push: 장치가 클라우드와 직접 통신
  • Hybrid Push: 장치가 중간 컴퓨터와 통신하고, 중간 컴퓨터가 클라우드와 통신

Hybrid Push가 존재하는 이유: 비호환 문제 해결

장치 수준의 비호환:

  • 클라우드 연결 펌웨어가 없는 구형 생체인식 단말기 (5-10년 이상)
  • RS232, RS485, Wiegand 또는 기타 레거시 통신 프로토콜을 사용하는 장치
  • 로컬 PC 연결용으로만 설계된 지문 인식기 (USB 연결 데스크톱 리더)
  • 독자 네트워크 프로토콜을 사용하는 출입 통제 패널
  • 표준화된 API 지원이 없는 제조사의 장치

네트워크 인프라 제약:

  • 보안상의 이유로 장치가 인터넷에 접속할 수 없는 에어갭 제조 네트워크
  • 장치의 인터넷 연결을 금지하는 정부 또는 국방 시설
  • HIPAA 네트워크 격리 요건이 있는 의료 환경
  • PCI-DSS 네트워크 분리 의무가 있는 금융 기관
  • OT(운영 기술) 네트워크가 IT 네트워크와 분리된 산업 시설

보안 정책 제한:

  • 보안 정책으로 IoT 장치의 인터넷 접속을 금지하는 조직
  • 온프레미스 데이터 처리를 의무화하는 규정 준수 요건
  • 클라우드 데이터 전송을 막는 데이터 주권 규정
  • 장치에서 인터넷으로의 통신을 차단하는 제로 트러스트 네트워크 아키텍처

Hybrid Push 아키텍처: 네 가지 연결 모드

Hybrid Push 배포는 네 가지 고유한 모드를 통해 서로 다른 인프라 구성에 적응합니다. 모드 선택은 네트워크 토폴로지가 허용하는 것과 연동이 가능한 위치에 따라 달라집니다.

Mode A: 포트 포워딩을 통한 하드웨어 연결 (SDK 기반)

이 모드의 의미:

이 배포는 인터넷에 연결된 중간 컴퓨터에서 실행되는 Cams Biometrics SDK(소프트웨어 개발 키트)를 사용합니다. SDK는 장치의 고유 프로토콜을 사용하여 생체인식 장치 하드웨어와 직접 통신합니다. 네트워크 라우터의 포트 포워딩을 통해 장치가 서로 다른 네트워크 구간에 있어도 SDK가 장치에 접근할 수 있습니다.

기술 아키텍처:

Biometric Device (on local network 192.168.1.x)
    ↓ [Device native protocol: TCP/IP, RS485, etc.]
    ↓ [Direct hardware communication]
    ↓
Intermediary Computer with SDK (has internet access)
    ↑ [Port forwarding: router forwards port 4370 to device IP]
    ↓ [HTTPS to cloud every 30 seconds]
    ↓
Cloud API Gateway (api.camsbiometrics.com)
    ↓ [Webhook to partner]
    ↓
Partner Application (HRMS/ERP)

데이터 흐름:

  1. 직원이 생체인식 장치에서 지문을 스캔합니다
  2. 장치가 트랜잭션을 로컬에 저장합니다 (즉시 클라우드 푸시 없음 – 장치가 클라우드를 지원하지 않음)
  3. 중간 컴퓨터에서 실행되는 SDK가 30초마다 장치를 폴링합니다. “새 트랜잭션이 있나요?”
  4. 장치가 마지막 폴링 이후 수집된 트랜잭션으로 응답합니다
  5. SDK가 트랜잭션 데이터를 수신하고 형식을 변환한 뒤 클라우드 API로 HTTPS 요청을 보냅니다
  6. 클라우드 API가 데이터를 검증하고 파트너 애플리케이션 엔드포인트로 웹훅 POST를 트리거합니다
  7. 파트너는 실제 스캔 시점으로부터 최대 30초 지연된 출퇴근 기록을 수신합니다

온라인 동작 (중간 컴퓨터가 인터넷에 연결된 경우):

  • SDK가 30초마다 장치를 폴링합니다
  • 새 트랜잭션이 수집되어 30초 지연으로 클라우드에 푸시됩니다
  • 웹훅이 30초마다 파트너 애플리케이션에 전달됩니다 (새 데이터가 있는 경우)

오프라인 동작 (중간 컴퓨터의 인터넷이 끊긴 경우):

  • SDK는 30초마다 장치를 계속 폴링하며 트랜잭션을 수집합니다
  • SDK가 수집한 트랜잭션을 중간 컴퓨터의 로컬 큐에 저장합니다
  • 컴퓨터의 인터넷 연결이 복구되면 SDK가 큐에 쌓인 트랜잭션을 자동으로 클라우드에 푸시합니다
  • 큐에 쌓인 모든 데이터가 배치 간 30초 간격으로 웹훅을 통해 전달됩니다
  • 데이터 손실 없이 완전 자동 복구됩니다

데이터 가용성 의존 요소:

  • 컴퓨터-장치 간 연결: SDK가 트랜잭션을 수집하려면 장치에 접근할 수 있어야 합니다 (LAN, WiFi 또는 포트 포워딩)
  • 장치-컴퓨터 간 연결: 장치가 컴퓨터와의 네트워크 연결을 잃으면(이더넷 분리, WiFi 중단) 연결이 복구될 때까지 SDK가 트랜잭션을 수집할 수 없습니다
  • 컴퓨터-클라우드 간 연결: 클라우드 전달을 위해 중간 컴퓨터에 인터넷이 필요합니다

Mode A 사용 사례:

  • 로컬 서버와 포트 포워딩 기능이 있는 지사 사무실
  • 백오피스 PC가 출퇴근 단말기에 연결된 소매점
  • 장치가 사무실 컴퓨터와 같은 LAN에 있는 소규모 사업장
  • 라우터 설정에서 포트 포워딩이 허용되는 분산 위치

Mode B: 포트 포워딩을 통한 데이터베이스 연결

이 모드의 의미:

이 배포는 생체인식 하드웨어와 직접 연동하는 대신 데이터베이스 수준에서 연동합니다. 많은 생체인식 장치가 출퇴근 트랜잭션을 로컬 데이터베이스(Microsoft SQL Server, MySQL, SQLite, Access 등)에 저장합니다. 중간 컴퓨터가 포트 포워딩을 통해 이 데이터베이스에 연결하여 트랜잭션 기록을 읽고 클라우드로 푸시합니다.

기술 아키텍처:

Biometric Device (writes to database)
    ↓ [Device-to-DB: whatever protocol device uses]
    ↓
Database Server (SQL Server, MySQL, etc.)
    ↑ [Port forwarding: allows intermediary to reach DB]
    ↓ [SQL queries every 30 seconds]
    ↓
Intermediary Computer with DB Connector (has internet)
    ↓ [HTTPS to cloud every 30 seconds]
    ↓
Cloud API Gateway (api.camsbiometrics.com)
    ↓ [Webhook to partner]
    ↓
Partner Application (HRMS/ERP)

데이터 흐름:

  1. 직원이 생체인식 장치에서 지문을 스캔합니다
  2. 장치가 (장치 자체의 데이터베이스 연결을 사용하여) 데이터베이스 테이블에 출퇴근 기록을 씁니다
  3. 중간 컴퓨터가 30초마다 데이터베이스를 폴링하는 데이터베이스 커넥터 소프트웨어를 실행합니다
  4. 커넥터가 SQL 쿼리를 실행하여 데이터베이스에서 아직 동기화되지 않은 새 출퇴근 기록을 가져옵니다
  5. 커넥터가 새 기록을 가져와 데이터 형식을 변환하고 HTTPS로 클라우드 API에 전송합니다
  6. 커넥터가 중복 전송을 방지하기 위해 데이터베이스의 기록을 동기화됨으로 표시합니다
  7. 클라우드 API가 데이터를 수신하고 파트너 애플리케이션으로 웹훅을 트리거합니다

온라인 동작 (중간 컴퓨터가 인터넷에 연결된 경우):

  • 데이터베이스 커넥터가 30초마다 폴링합니다
  • 새 데이터베이스 기록이 30초 지연으로 클라우드에 푸시됩니다
  • 웹훅이 폴링 간격만큼의 지연으로 파트너 애플리케이션에 전달됩니다

오프라인 동작 (중간 컴퓨터의 인터넷이 끊긴 경우):

  • 커넥터는 30초마다 데이터베이스를 계속 폴링합니다
  • 커넥터가 데이터베이스에서 기록을 “pending sync”로 표시합니다
  • 인터넷이 복구되면 커넥터가 보류 중인 모든 기록을 클라우드에 푸시합니다
  • 큐에 쌓인 데이터가 웹훅을 통해 자동으로 전달됩니다

데이터 가용성 의존 요소:

  • 장치-데이터베이스 간 연결: 장치가 데이터베이스에 정상적으로 기록할 수 있어야 합니다 (장치가 DB 연결을 잃으면 트랜잭션이 저장되지 않음)
  • 컴퓨터-데이터베이스 간 연결: 커넥터가 네트워크(포트 포워딩 또는 로컬 네트워크)를 통해 데이터베이스 서버에 접근할 수 있어야 합니다
  • 데이터베이스-컴퓨터 간 연결: 데이터베이스 서버에 접근할 수 없으면(네트워크 문제, 서버 다운) 커넥터가 새 기록을 읽을 수 없습니다
  • 컴퓨터-클라우드 간 연결: 웹훅 전달을 위해 중간 컴퓨터에 인터넷이 필요합니다

제한 사항: REST API 미지원

Mode B는 트랜잭션 데이터 흐름만 제공합니다. 연동이 데이터베이스 수준에서 이루어지므로 시스템은 생체인식 장치로 명령을 다시 보낼 수 없습니다. REST API 작업(사용자 추가, 장치 설정, 등록 삭제)은 이 모드에서 사용할 수 없습니다.

이 제한이 존재하는 이유:

장치에 명령을 보내려면 하드웨어 수준의 통신 프로토콜이 필요합니다. 데이터베이스 연동은 트랜잭션 기록만 읽을 수 있으며, 장치 동작을 제어하거나 데이터베이스를 통해 사용자 등록 데이터를 장치에 다시 쓸 수 없습니다.

Mode B 사용 사례:

  • 장치 제조사가 SQL 데이터베이스 출력을 제공하는 레거시 시스템
  • 데이터베이스 접근은 허용되지만 장치 접근은 제한되는 환경
  • 데이터베이스 중심의 기존 출퇴근 소프트웨어와의 연동
  • DBA(데이터베이스 관리자)가 데이터 접근을 통제하는 조직

Mode C: 로컬 서비스를 통한 하드웨어 연결

이 모드의 의미:

이 배포는 생체인식 장치와 같은 네트워크 내의 중간 컴퓨터에 로컬 서비스(Windows 서비스 또는 Linux 데몬)를 설치합니다. 이 서비스는 포트 포워딩 없이 장치 하드웨어와 직접 통신합니다. 외부 접근이 허용되지 않는 완전히 격리된 네트워크에서도 작동합니다.

기술 아키텍처:

Biometric Device (on isolated network, no internet)
    ↓ [LAN/WiFi: 192.168.1.x local network]
    ↓ [Device native protocol communication]
    ↓
Intermediary Computer with Local Service
    ↑ [Same local network, no port forwarding needed]
    ↓ [HTTPS to cloud every 30 seconds]
    ↓
Cloud API Gateway (api.camsbiometrics.com)
    ↓ [Webhook to partner]
    ↓
Partner Application (HRMS/ERP)

데이터 흐름:

  1. 제조 현장 직원이 출퇴근 단말기에서 지문을 스캔합니다
  2. 장치가 트랜잭션을 로컬 메모리에 저장합니다 (장치는 격리된 생산 네트워크에 있음)
  3. 중간 컴퓨터(마찬가지로 생산 네트워크에 있음)에서 실행되는 로컬 서비스가 30초마다 장치를 폴링합니다
  4. 서비스가 장치의 통신 프로토콜을 사용하여 새 트랜잭션을 수집합니다
  5. 서비스가 중간 컴퓨터의 인터넷 연결을 통해 수집한 데이터를 클라우드 API로 전송합니다
  6. 클라우드 API가 파트너의 클라우드 기반 HRMS로 웹훅을 트리거합니다

온라인 동작 (중간 컴퓨터가 인터넷에 연결된 경우):

  • 로컬 서비스가 30초마다 장치를 폴링합니다
  • 트랜잭션이 수집되어 30초 지연으로 클라우드에 푸시됩니다
  • 웹훅이 폴링 간격으로 파트너 애플리케이션에 전달됩니다

오프라인 동작 (중간 컴퓨터의 인터넷이 끊긴 경우):

  • 서비스는 장치를 계속 폴링하며 트랜잭션을 로컬에서 수집합니다
  • 서비스가 중간 컴퓨터 저장소에 데이터를 큐잉합니다
  • 인터넷이 복구되면 서비스가 큐에 쌓인 데이터를 클라우드에 자동으로 동기화합니다
  • 모든 출퇴근 기록이 수동 개입 없이 웹훅을 통해 전달됩니다

데이터 가용성 의존 요소:

  • 컴퓨터-장치 간 연결: 서비스가 로컬 네트워크의 장치에 접근할 수 있어야 합니다 (스위치 장애, WiFi 중단 또는 케이블 분리 시 수집이 중단됨)
  • 장치 동작: 네트워크 문제가 있어도 장치는 로컬에서 출퇴근 기록을 계속 수집합니다
  • 컴퓨터-클라우드 간 연결: 클라우드 전달을 위해 중간 컴퓨터에 인터넷이 필요합니다 (장치 자체는 인터넷이 필요하지 않음)

Mode C 사용 사례:

  • 에어갭 생산 네트워크를 갖춘 제조 시설
  • 장치의 인터넷 접속을 금지하는 정부 시설
  • 의료 기기 네트워크가 격리된 의료 시설
  • 보안 구역이 분리된 금융 기관
  • OT 네트워크가 IT 네트워크와 격리된 산업 환경

Mode D: 로컬 서비스를 통한 데이터베이스 연결

이 모드의 의미:

로컬 서비스가 로컬 네트워크의 데이터베이스 서버에 연결하여 생체인식 장치가 데이터베이스에 기록한 출퇴근 트랜잭션을 읽습니다. 이는 데이터베이스 연동과 온프레미스 배포를 결합한 것으로, 매우 제한된 환경에 적합합니다.

기술 아키텍처:

Biometric Device (writes to local database server)
    ↓ [Device database connection protocol]
    ↓
Database Server (on isolated network, no internet)
    ↓ [SQL queries every 30 seconds]
    ↓
Intermediary Computer with Local Service
    ↑ [Same local network, reads from database]
    ↓ [HTTPS to cloud every 30 seconds]
    ↓
Cloud API Gateway (api.camsbiometrics.com)
    ↓ [Webhook to partner]
    ↓
Partner Application (HRMS/ERP)

데이터 흐름:

  1. 직원이 출입 통제 단말기에서 얼굴 인식으로 인증합니다
  2. 장치가 로컬 SQL Server 데이터베이스에 출입 이벤트를 기록합니다
  3. 로컬 서비스가 SQL 쿼리로 30초마다 데이터베이스를 폴링합니다
  4. 서비스가 새 기록을 가져와 데이터 형식을 변환합니다
  5. 서비스가 중간 컴퓨터의 인터넷 연결을 통해 클라우드 API로 데이터를 전송합니다
  6. 클라우드 API가 파트너의 클라우드 애플리케이션으로 웹훅을 전달합니다

온라인 동작 (중간 컴퓨터가 인터넷에 연결된 경우):

  • 서비스가 30초마다 데이터베이스를 폴링합니다
  • 새 데이터베이스 기록이 30초 지연으로 클라우드에 푸시됩니다
  • 웹훅이 폴링 간격으로 전달됩니다

오프라인 동작 (중간 컴퓨터의 인터넷이 끊긴 경우):

  • 서비스는 데이터베이스를 계속 폴링하며 기록을 보류 상태로 표시합니다
  • 인터넷이 복구되면 클라우드 동기화를 위해 데이터가 큐에 쌓입니다
  • 자동 복구되며 데이터 손실이 없습니다

데이터 가용성 의존 요소:

  • 장치-데이터베이스 간 연결: 장치가 데이터베이스에 정상적으로 기록해야 합니다 (장치가 DB 연결을 잃으면 트랜잭션이 저장되지 않음)
  • 데이터베이스-서비스 간 연결: 서비스가 로컬 네트워크의 데이터베이스 서버에 접근할 수 있어야 합니다 (데이터베이스 서버가 다운되면 기록을 읽을 수 없음)
  • 컴퓨터-클라우드 간 연결: 웹훅 전달을 위해 중간 컴퓨터에 인터넷이 필요합니다 (데이터베이스와 장치는 인터넷이 필요하지 않음)

제한 사항: REST API 미지원

Mode B와 마찬가지로 Mode D도 트랜잭션 데이터 흐름만 제공합니다. 데이터베이스 수준 연동의 제약으로 인해 장치 제어, 사용자 관리, 설정 API를 사용할 수 없습니다.

Mode D 사용 사례:

  • 데이터 주권 요건이 있는 고도로 규제되는 산업
  • 온프레미스 전용 데이터 처리 의무
  • 네트워크가 격리된 데이터베이스 중심의 레거시 시스템
  • 장치의 인터넷 연결을 일체 금지하는 조직

Hybrid Push 기능 비교

기능Mode A: 하드웨어 포트 포워딩Mode B: 데이터베이스 포트 포워딩Mode C: 하드웨어 로컬 서비스Mode D: 데이터베이스 로컬 서비스
트랜잭션 전달✅ 30초 폴링✅ 30초 폴링✅ 30초 폴링✅ 30초 폴링
오프라인 큐잉✅ 컴퓨터에서✅ 컴퓨터에서✅ 컴퓨터에서✅ 컴퓨터에서
사용자 추가✅ 생체 정보 제외*❌ 지원 안 함✅ 생체 정보 제외*❌ 지원 안 함
사용자 데이터 조회❌ 지원 안 함❌ 지원 안 함❌ 지원 안 함❌ 지원 안 함
장치 설정⚠️ 제한적❌ 지원 안 함⚠️ 제한적❌ 지원 안 함
생체 정보 등록⚠️ 로컬 장치에서만⚠️ 로컬 장치에서만⚠️ 로컬 장치에서만⚠️ 로컬 장치에서만
포트 포워딩 필요✅ 예✅ 예❌ 아니요❌ 아니요
장치 인터넷 필요❌ 아니요❌ 아니요❌ 아니요❌ 아니요
컴퓨터 인터넷 필요✅ 예✅ 예✅ 예✅ 예

*“생체 정보 제외 사용자 추가”에 대한 중요 설명:

Hybrid Mode A와 C에서는 시스템이 생체인식 장치에 사용자 기록(이름, 직원 ID, 카드 번호, 부서, 출입 권한)을 생성할 수 있지만 생체 템플릿을 원격으로 업로드할 수는 없습니다. 직원은 지문, 얼굴 또는 홍채를 등록하려면 장치를 직접 방문해야 합니다. 이 제한은 Hybrid로 배포된 장치에 원격 생체 템플릿 전송에 필요한 클라우드 연결이 없기 때문에 존재합니다.

30초 지연 이해하기

실시간이 아니라 30초인 이유는?

Hybrid 배포는 푸시 아키텍처 대신 폴링 아키텍처를 사용합니다.

  • Native Push (실시간): 이벤트가 발생하면 장치가 즉시 능동적으로 클라우드에 데이터를 보냅니다
  • Hybrid Push (30초): 중간 컴퓨터가 30초마다 장치에 “새 데이터가 있나요?”라고 반복해서 묻습니다

폴링 메커니즘:

Second 0: Service checks devices - finds 3 new transactions - sends to cloud
Second 30: Service checks devices - finds 1 new transaction - sends to cloud
Second 60: Service checks devices - finds 0 new transactions - no webhook sent
Second 90: Service checks devices - finds 5 new transactions - sends to cloud

1초마다 폴링하지 않는 이유는?

더 빠른 폴링은 네트워크 대역폭을 더 많이 소모하고 장치 프로세서 부하를 높이며, 일반적인 출퇴근 사용 사례에서는 얻는 이점이 미미합니다. 출퇴근 시스템은 일반적으로 1초 미만의 정밀도가 필요하지 않으며, 30초 지연이면 급여 처리, 근무 추적, 출입 기록에 충분합니다.

폴링 간격을 사용자 지정할 수 있나요?

폴링 주기는 요구 사항에 따라 조정할 수 있지만(10초, 60초 등), 30초가 준실시간 성능과 시스템 자원 효율 사이의 최적 균형입니다.

Hybrid 모드에서의 생체 정보 등록 제한 이해하기

Hybrid 모드에서 생체 정보를 원격으로 등록할 수 없는 이유는?

생체 템플릿 수집에는 다음이 필요합니다.

  1. 고품질 센서 하드웨어 (광학 지문 리더, IR 얼굴 카메라, 홍채 스캐너)
  2. 올바른 손가락 배치, 얼굴 위치 또는 눈 정렬을 위한 물리적 현장 참석
  3. 템플릿 품질 검증을 위한 다중 캡처 (일반적으로 손가락당 3-5회 스캔)
  4. 위조 방지를 위한 생체 감지 (진짜와 가짜 생체 정보 확인)

Hybrid로 배포된 장치는 오프라인이거나 제한된 연결로 작동합니다. 다음과 같은 이유로 클라우드에서 생체 템플릿을 수신할 수 없습니다.

  • 보안: 네트워크를 통해 전송되는 생체 템플릿은 가로채기 위험을 만듭니다
  • 품질: 원격 템플릿 업로드로는 생체 정보 수집 품질을 검증할 수 없습니다
  • 장치 기능: Hybrid로 배포된 장치에는 원격 템플릿 수신용 펌웨어가 없는 경우가 많습니다
  • 프로토콜 제한: 레거시 장치는 표준화된 템플릿 형식을 지원하지 않습니다

Hybrid 배포에서의 사용자 등록 워크플로:

  1. 관리자가 사용자 기록을 생성합니다 (Mode A/C만 해당): 시스템이 생체 데이터 없이 직원 이름, ID, 부서를 장치에 추가합니다
  2. API가 생체 템플릿 없이 생체인식 장치에 사용자 기록을 생성합니다
  3. 직원이 생체인식 단말기를 직접 방문합니다
  4. 로컬 등록: 직원이 장치에서 지문을 3회 스캔하거나 얼굴을 등록합니다
  5. 장치가 생체 템플릿을 수집하여 로컬에 저장합니다
  6. 장치가 템플릿 품질을 확인하고 비휘발성 메모리에 저장합니다
  7. 이제 직원은 출퇴근 기록을 위해 장치에서 인증할 수 있습니다

데이터베이스 모드(B/D) 등록:

데이터베이스 모드에는 사용자 관리 API가 없으므로 사용자 등록은 전적으로 장치의 로컬 인터페이스에서 이루어집니다.

  1. 관리자가 장치 키패드/터치스크린으로 사용자를 추가합니다
  2. 직원이 장치에서 직접 생체 정보를 등록합니다
  3. 장치가 데이터베이스에 등록 기록을 씁니다
  4. 중간 서비스가 데이터베이스에서 사용자 등록 정보를 읽고, 필요하면 파트너 애플리케이션에 동기화합니다

전체 기능 비교: Native Push 대 Hybrid Push

상세 기능 매트릭스

기능 범주Native Push (Web API)Hybrid Mode A/C (하드웨어)Hybrid Mode B/D (데이터베이스)
출퇴근 트랜잭션 전달
장치 온라인, 인터넷 사용 가능즉시 (< 1초)30초 폴링 간격30초 폴링 간격
장치 온라인, 인터넷 사용 불가장치에 큐잉, 재연결 시 자동 푸시컴퓨터에 큐잉, 컴퓨터 재연결 시 자동 푸시컴퓨터에 큐잉, 컴퓨터 재연결 시 자동 푸시
장치 오프라인 (전원 꺼짐)전원이 켜지면 장치에 큐잉장치 전원이 켜질 때까지 수집 불가장치가 DB에 기록할 때까지 수집 불가
웹훅/콜백 전달
전달 방식실시간 HTTPS POST폴링 기반 HTTPS POST폴링 기반 HTTPS POST
웹훅 URL파트너가 설정한 엔드포인트파트너가 설정한 엔드포인트파트너가 설정한 엔드포인트
데이터 형식전체 트랜잭션 세부 정보가 포함된 JSON전체 트랜잭션 세부 정보가 포함된 JSON전체 트랜잭션 세부 정보가 포함된 JSON
재시도 메커니즘실패 시 자동 재시도실패 시 자동 재시도실패 시 자동 재시도
사용자 관리 작업
인적 정보가 포함된 사용자 추가✅ 전체 지원✅ 기본 지원❌ 사용 불가
생체 템플릿 원격 등록✅ 클라우드에서 업로드❌ 로컬 등록만 가능❌ 로컬 등록만 가능
장치에서 사용자 데이터베이스 조회✅ 전체 목록❌ 사용 불가❌ 사용 불가
사용자 정보 업데이트✅ 전체 수정⚠️ 장치를 통해 제한적❌ 사용 불가
사용자 등록 삭제✅ 클라우드에서 제거⚠️ 장치를 통해 제한적❌ 사용 불가
대량 사용자 업로드✅ 대량 작업❌ 사용 불가❌ 사용 불가
장치 간 동기화✅ 자동 동기화❌ 사용 불가❌ 사용 불가
장치 관리 작업
장치 상태 및 건강 상태 조회✅ 전체 진단⚠️ 제한된 데이터❌ 사용 불가
장치 매개변수 설정✅ 완전 제어⚠️ 기본 설정만❌ 사용 불가
원격 펌웨어 업데이트✅ 지원❌ 사용 불가❌ 사용 불가
장치 시스템 로그 조회✅ 전체 접근❌ 사용 불가❌ 사용 불가
장치 명령 전송✅ 모든 명령⚠️ 제한된 명령❌ 사용 불가
출입 일정 관리✅ 전체 일정 관리⚠️ 기본 지원❌ 사용 불가
출퇴근 데이터 작업
실시간 트랜잭션 웹훅✅ 즉시 푸시✅ 30초 내 전달✅ 30초 내 전달
과거 출퇴근 기록 조회✅ 전체 범위 조회⚠️ 웹훅을 통해서만⚠️ 웹훅을 통해서만
출퇴근 수동 입력✅ API 지원❌ 사용 불가❌ 사용 불가
기록 삭제/수정✅ 지원❌ 사용 불가❌ 사용 불가
네트워크 요구 사항
장치 인터넷 접속 필요✅ 예 (간헐적이어도 가능)❌ 아니요❌ 아니요
중간 컴퓨터 필요❌ 아니요✅ 예✅ 예
중간 컴퓨터 인터넷 필요❌ 해당 없음✅ 예✅ 예
포트 포워딩 필요❌ 아니요✅ Mode A/B만❌ Mode C/D
방화벽 설정아웃바운드 443만컴퓨터에서 아웃바운드 443컴퓨터에서 아웃바운드 443
오프라인 복원력
오프라인 중 데이터가 큐잉되는 위치장치 내부 메모리중간 컴퓨터 저장소중간 컴퓨터 저장소
재연결 시 자동 동기화✅ 예✅ 예✅ 예
최대 오프라인 저장 용량50,000-100,000건 (장치에 따라 다름)컴퓨터 디스크 공간에 의해 제한컴퓨터 디스크 공간에 의해 제한
성능 특성
평균 지연 시간 (온라인)< 1초약 30초약 30초
장치당 대역폭10-50 Kbps최소 (컴퓨터-클라우드 구간만)최소 (컴퓨터-클라우드 구간만)
확장성수천 대의 장치컴퓨터 성능에 의해 제한컴퓨터 성능에 의해 제한

사용 사례별 권장 사항

다음의 경우 Native Push를 선택하세요:

  • ✅ 최신 장치로 신규 생체인식 시스템을 구축하는 경우
  • ✅ 장치가 developer.camsbiometrics.com의 호환성 검증을 통과한 경우
  • ✅ 장치가 (직접 또는 기업 네트워크를 통해) 인터넷에 접속할 수 있는 경우
  • ✅ 실시간 출퇴근 가시성이 중요한 경우
  • ✅ 원격 사용자 관리 기능이 필요한 경우
  • ✅ 클라우드 우선 IT 전략인 경우
  • ✅ 다중 지점 배포 (소매점, 지사 사무실)
  • ✅ SaaS(Software-as-a-Service)를 선호하는 경우
  • ✅ IT 인프라 투자를 최소화하려는 경우

다음의 경우 Hybrid Mode A(하드웨어 포트 포워딩)를 선택하세요:

  • ⚠️ 장치가 호환성 검증에 실패한 경우
  • ⚠️ 클라우드 펌웨어가 없는 레거시 장치
  • ⚠️ 네트워크에서 포트 포워딩 설정이 허용되는 경우
  • ⚠️ 장치 수준 연동이 가능한 경우
  • ⚠️ 기본적인 사용자 관리가 필요한 경우
  • ⚠️ 30초 지연이 허용되는 경우
  • ⚠️ 중간 컴퓨터를 사용할 수 있는 경우

다음의 경우 Hybrid Mode B(데이터베이스 포트 포워딩)를 선택하세요:

  • ⚠️ 장치가 데이터베이스(SQL Server, MySQL 등)에 기록하는 경우
  • ⚠️ 데이터베이스 접근은 허용되지만 장치 접근은 제한되는 경우
  • ⚠️ 데이터베이스 서버로의 포트 포워딩이 가능한 경우
  • ⚠️ 트랜잭션 데이터 흐름만 필요한 경우 (장치 제어 불필요)
  • ⚠️ 데이터베이스 중심의 기존 출퇴근 소프트웨어가 있는 경우
  • ⚠️ DBA가 모든 데이터 접근을 통제하는 경우

다음의 경우 Hybrid Mode C(하드웨어 로컬 서비스)를 선택하세요:

  • ⚠️ 에어갭 네트워크 또는 격리된 장치
  • ⚠️ 보안 정책이 장치의 인터넷 접속을 금지하는 경우
  • ⚠️ 포트 포워딩이 허용되지 않거나 불가능한 경우
  • ⚠️ 인터넷에 접속 가능한 온프레미스 서버/PC를 사용할 수 있는 경우
  • ⚠️ 장치 수준 연동이 가능한 경우
  • ⚠️ 네트워크가 격리된 제조, 정부, 의료 환경
  • ⚠️ 기본적인 장치 제어가 필요한 경우

다음의 경우 Hybrid Mode D(데이터베이스 로컬 서비스)를 선택하세요:

  • ⚠️ 데이터베이스만으로 연동해야 하는 경우
  • ⚠️ 완전히 격리된 네트워크 (장치와 데이터베이스)
  • ⚠️ 데이터 주권 또는 규정 준수 의무가 있는 경우
  • ⚠️ 온프레미스 처리 요건이 있는 경우
  • ⚠️ 트랜잭션 흐름만 필요한 경우 (API 제어 불필요)
  • ⚠️ 현대화 경로가 없는 레거시 시스템

인프라 요구 사항 및 네트워크 의존성

Native Push 인프라 요구 사항

장치 위치에서:

  • 인터넷 연결 (WiFi, 이더넷, 4G/5G 셀룰러 또는 위성)
  • 네트워크 연결은 간헐적이어도 됩니다 (연결이 끊기는 동안 장치가 데이터를 큐잉)
  • 최소 대역폭: 장치당 10-50 Kbps
  • 네트워크 지연 시간: < 5000ms 허용 (위성에서도 작동)

방화벽 규칙:

  • 장치 서브넷에서 api.camsbiometrics.com으로 나가는 HTTPS(TCP 포트 443)를 허용합니다
  • 인바운드 규칙은 필요하지 않습니다 (장치가 모든 연결을 시작)
  • NAT/PAT(네트워크/포트 주소 변환)와 호환됩니다

DNS 요구 사항:

  • 장치가 api.camsbiometrics.com 도메인을 확인할 수 있어야 합니다
  • 표준 기업 DNS 서버를 사용할 수 있습니다
  • 대안: 고정 DNS 설정 (8.8.8.8 Google DNS 등)

네트워크 토폴로지 호환성:

  • ✅ 직접 인터넷 접속
  • ✅ 기업 프록시 서버 (인증 포함)
  • ✅ 아웃바운드 HTTPS가 허용된 NAT/방화벽
  • ✅ VPN 터널
  • ✅ 인터넷 게이트웨이가 있는 클라우드 VPC(Virtual Private Cloud)
  • ❌ 에어갭 네트워크 (Hybrid 모드 사용)
  • ❌ 모든 아웃바운드 연결을 차단하는 네트워크 (Hybrid 모드 사용)

Hybrid Mode A 인프라 요구 사항

중간 컴퓨터 사양:

  • OS: Windows 10/11, Windows Server 2016+, Ubuntu 20.04+, CentOS 8+ 또는 Debian 11+
  • CPU: 최소 듀얼 코어 2.0 GHz (장치 50대 이상은 쿼드 코어 권장)
  • RAM: 최소 4 GB (8 GB 권장)
  • Storage: 사용 가능 20 GB (SDK 및 데이터 큐잉용)
  • Network: 안정적인 연결의 이더넷 또는 WiFi

네트워크 토폴로지:

Internet (Cloud API)
    ↑
    | [HTTPS outbound]
    |
Intermediary Computer (has internet access)
    ↑
    | [Port forwarding through router/firewall]
    |
Router/Firewall (forwards port 4370 to device)
    ↑
    | [Local network or cross-subnet routing]
    |
Biometric Device(s) (no internet required)

포트 포워딩 설정:

  • 라우터가 TCP 포트(일반적으로 4370, 장치에 따라 다름)를 장치 IP 주소로 전달하도록 설정합니다
  • 생체인식 장치에는 고정 IP 또는 DHCP 예약을 권장합니다
  • WAN(광역 네트워크) 인터페이스에서의 포트 포워딩은 필요하지 않습니다 – 내부 포워딩만 사용합니다

컴퓨터-장치 간 연결:

  • 장치가 중간 컴퓨터와 같은 LAN 서브넷에 있는 경우: 직접 통신
  • 장치가 다른 서브넷에 있는 경우: 포트 포워딩 또는 라우팅 필요
  • 지원 프로토콜: TCP/IP, RS485 (컨버터 사용), USB (로컬 연결)

컴퓨터-클라우드 간 연결:

  • 중간 컴퓨터의 안정적인 인터넷 연결
  • api.camsbiometrics.com으로 나가는 HTTPS(포트 443)
  • 최소 대역폭: 100 Kbps (장치 수에 따라 증가)

Hybrid Mode B 인프라 요구 사항

중간 컴퓨터 사양:

  • OS: Windows 10/11, Windows Server 2016+, Ubuntu 20.04+, CentOS 8+
  • CPU: 최소 듀얼 코어 2.0 GHz
  • RAM: 최소 4 GB (대용량 데이터베이스는 8 GB)
  • Storage: 사용 가능 10 GB
  • 데이터베이스 클라이언트: SQL Server 도구, MySQL Connector, PostgreSQL 클라이언트 (데이터베이스 유형에 따라)

네트워크 토폴로지:

Internet (Cloud API)
    ↑
    | [HTTPS outbound]
    |
Intermediary Computer (has internet access)
    ↑
    | [SQL connection via port forwarding]
    |
Router/Firewall (forwards SQL port to database server)
    ↑
    | [Database network]
    |
Database Server (SQL Server: 1433, MySQL: 3306, etc.)
    ↑
    | [Device-specific database protocol]
    |
Biometric Device(s) (write to database)

데이터베이스 접근 요구 사항:

  • 데이터베이스 자격 증명: SELECT 및 UPDATE 권한이 있는 사용자 이름과 비밀번호
  • 데이터베이스 연결 문자열: 서버 IP, 포트, 데이터베이스 이름
  • 포트 포워딩: 라우터가 데이터베이스 포트(1433, 3306 등)를 데이터베이스 서버로 전달
  • 지원 데이터베이스: SQL Server, MySQL, PostgreSQL, Oracle, SQLite, MS Access

컴퓨터-데이터베이스 간 연결:

  • 중간 컴퓨터에서 데이터베이스 서버까지의 네트워크 경로
  • 데이터베이스 포트에 (직접 또는 포트 포워딩을 통해) 접근 가능
  • 데이터베이스 방화벽 규칙이 컴퓨터 IP 주소를 허용

컴퓨터-클라우드 간 연결:

  • 중간 컴퓨터의 인터넷 접속
  • 아웃바운드 HTTPS(포트 443) 허용

중요: 장치-데이터베이스 의존성

데이터 가용성은 장치가 데이터베이스에 정상적으로 기록하는지에 달려 있습니다.

  • 장치가 데이터베이스 서버와의 네트워크 연결을 잃으면 트랜잭션이 저장되지 않습니다
  • 데이터베이스 서버가 충돌하면 복구될 때까지 트랜잭션이 유실됩니다
  • 장치가 트랜잭션을 기록할 수 있도록 데이터베이스에 접근할 수 있어야 합니다
  • 데이터베이스 서버의 백업/이중화를 권장합니다

Hybrid Mode C 인프라 요구 사항

중간 컴퓨터 사양:

  • OS: Windows 10/11, Windows Server 2016+, Ubuntu 20.04+, CentOS 8+
  • CPU: 최소 듀얼 코어 2.0 GHz (장치 100대 이상은 쿼드 코어)
  • RAM: 최소 4 GB (8 GB 권장)
  • Storage: 사용 가능 20 GB
  • Network: 듀얼 네트워크 인터페이스 권장 (하나는 로컬 장치용, 하나는 인터넷용)

네트워크 토폴로지:

Internet (Cloud API)
    ↑
    | [HTTPS outbound via internet-connected interface]
    |
Intermediary Computer (dual-homed: local network + internet)
    |
    | [Local network interface - no port forwarding required]
    ↓
Local Network Switch/WiFi (isolated from internet)
    ↓
Biometric Device(s) (on isolated network, no internet)

듀얼 홈(Dual-Homed) 컴퓨터 구성:

옵션 1: 물리적 네트워크 인터페이스 2개

  • NIC 1: 생체인식 장치가 있는 격리된 로컬 네트워크에 연결 (192.168.1.x)
  • NIC 2: 인터넷 접속이 가능한 기업 네트워크에 연결 (10.0.0.x)
  • 로컬 서비스가 NIC 1에서 장치와 통신합니다
  • 로컬 서비스가 NIC 2를 통해 클라우드로 데이터를 전송합니다

옵션 2: WiFi + 이더넷

  • 이더넷: 격리된 장치 네트워크에 연결
  • WiFi: 인터넷이 가능한 무선 네트워크에 연결
  • 서비스가 각 통신에 맞는 인터페이스에 바인딩됩니다

컴퓨터-장치 간 연결:

  • 같은 로컬 네트워크 서브넷 (라우팅 불필요)
  • LAN을 통해 장치에 접근 가능 (ping 테스트: ping 192.168.1.100)
  • 포트 포워딩이 필요하지 않음 (직접 로컬 접근)
  • 지원 프로토콜: TCP/IP, RS485 (USB 컨버터 사용), Wiegand (컨트롤러 사용)

컴퓨터-클라우드 간 연결:

  • 별도의 네트워크 인터페이스를 통한 인터넷 접속
  • api.camsbiometrics.com으로 나가는 HTTPS(포트 443)
  • 기업 네트워크 또는 직접 인터넷 연결

에어갭 네트워크 고려 사항:

  • 생체인식 장치가 완전히 격리된 네트워크에 있음 (인터넷 접속 없음)
  • 중간 컴퓨터가 격리된 네트워크와 인터넷을 연결함
  • IoT 장치의 인터넷 접속을 금지하는 보안 정책 준수를 보장함
  • 데이터 흐름: 장치 → 로컬 네트워크 → 컴퓨터 → 인터넷 → 클라우드

Hybrid Mode D 인프라 요구 사항

중간 컴퓨터 사양:

  • OS: Windows 10/11, Windows Server 2016+, Ubuntu 20.04+
  • CPU: 최소 듀얼 코어 2.0 GHz
  • RAM: 최소 4 GB (대용량 데이터베이스는 8 GB)
  • Storage: 사용 가능 10 GB
  • 데이터베이스 클라이언트: 데이터베이스 유형에 맞는 도구

네트워크 토폴로지:

Internet (Cloud API)
    ↑
    | [HTTPS outbound via internet-connected interface]
    |
Intermediary Computer (dual-homed: local network + internet)
    |
    | [Local network interface - direct database access]
    ↓
Local Network (isolated from internet)
    ↓
Database Server (no internet access)
    ↑
    | [Device database protocol]
    |
Biometric Device(s) (isolated network, no internet)

데이터베이스 접근:

  • 격리된 로컬 네트워크의 데이터베이스 서버
  • 같은 네트워크의 중간 컴퓨터 (직접 SQL 접근)
  • 포트 포워딩 불필요 (같은 서브넷)
  • SELECT 및 UPDATE 권한이 있는 데이터베이스 자격 증명

컴퓨터-데이터베이스 간 연결:

  • 데이터베이스 서버에 대한 로컬 네트워크 접근
  • 데이터베이스 포트에 접근 가능 (1433, 3306 등)
  • 데이터베이스 방화벽이 로컬 컴퓨터 IP를 허용

컴퓨터-클라우드 간 연결:

  • 별도의 네트워크 인터페이스를 통한 인터넷
  • 아웃바운드 HTTPS(포트 443) 허용

장치-데이터베이스 의존성:

  • 장치가 로컬 데이터베이스 서버에 트랜잭션을 기록합니다
  • 로컬 네트워크의 장치가 데이터베이스에 접근할 수 있어야 합니다
  • 장치가 데이터베이스 연결을 잃으면 트랜잭션이 저장되지 않습니다
  • 데이터 가용성에는 데이터베이스 서버의 가동 시간이 매우 중요합니다

연결 의존성과 데이터 흐름

핵심 의존성 이해하기

각 배포 모드에는 데이터 가용성을 결정하는 고유한 연결 의존성이 있습니다.

Native Push 연결 의존성

단일 의존 지점:

Biometric Device ←→ Internet ←→ Cloud API

데이터 흐름을 위해 작동해야 하는 것:

  1. 장치에 인터넷 연결이 있어야 합니다
  2. 장치가 api.camsbiometrics.com에 도달할 수 있어야 합니다 (DNS 확인, 방화벽의 HTTPS 허용)

장애 시나리오:

  • 장치 오프라인 (전원 꺼짐, 네트워크 케이블 분리): 장치가 트랜잭션을 내부에 큐잉하고, 전원이 켜지고 연결되면 자동으로 푸시합니다
  • 인터넷 다운 (ISP 장애, 라우터 고장): 장치가 트랜잭션을 큐잉하고, 인터넷이 복구되면 자동으로 푸시합니다
  • 클라우드 API 사용 불가 (극히 드묾, 예정된 유지보수): 장치가 연결을 재시도하고 API에 접근할 수 있을 때까지 데이터를 큐잉합니다

데이터 손실 방지:

  • 장치가 내부 메모리에 50,000-100,000건의 트랜잭션을 저장합니다
  • 지수 백오프를 사용하는 자동 재시도 메커니즘
  • 전원을 껐다 켜도 데이터가 유지됩니다 (비휘발성 저장소)

Hybrid Mode A/C 연결 의존성

두 개의 의존 지점:

Device ←→ Intermediary Computer ←→ Internet ←→ Cloud API

데이터 흐름을 위해 작동해야 하는 것:

  1. 장치-컴퓨터: 컴퓨터가 장치에 도달할 수 있어야 합니다 (LAN 연결, 포트 포워딩 또는 로컬 네트워크 접근)
  2. 컴퓨터-클라우드: 컴퓨터가 웹훅을 전달하려면 인터넷에 접속할 수 있어야 합니다

장애 시나리오:

장치 전원이 꺼진 경우:

  • 장치가 트랜잭션 수집을 중단합니다
  • 컴퓨터가 장치를 폴링할 수 없습니다
  • 장치 전원이 켜지면 컴퓨터가 폴링을 재개하고 큐잉된 트랜잭션을 수집합니다

컴퓨터가 장치와의 연결을 잃은 경우:

  • 컴퓨터가 새 트랜잭션을 수집할 수 없습니다
  • 장치는 로컬에서 계속 수집하고 저장합니다
  • 연결이 복구되면 컴퓨터가 폴링하여 누적된 트랜잭션을 가져옵니다

컴퓨터가 인터넷을 잃은 경우:

  • 컴퓨터는 장치를 계속 폴링하며 트랜잭션을 수집합니다
  • 컴퓨터가 수집한 트랜잭션을 로컬에 큐잉합니다
  • 인터넷이 복구되면 컴퓨터가 큐에 쌓인 데이터를 자동으로 클라우드에 푸시합니다

장치와 컴퓨터가 모두 오프라인인 경우:

  • 데이터 수집이나 전송이 없습니다
  • 장치가 트랜잭션을 내부에 큐잉합니다
  • 둘 다 복구되면 컴퓨터가 장치 데이터를 수집하여 클라우드에 푸시합니다

데이터 가용성 제한: 장치가 오프라인이거나 컴퓨터가 접근할 수 없는 경우, 둘 사이의 연결이 복구될 때까지 컴퓨터는 해당 장치의 트랜잭션을 수집할 수 없습니다. 컴퓨터는 장치에서 성공적으로 수집한 것만 클라우드에 푸시할 수 있습니다.

Hybrid Mode B/D 연결 의존성

세 개의 의존 지점:

Device ←→ Database ←→ Intermediary Computer ←→ Internet ←→ Cloud API

데이터 흐름을 위해 작동해야 하는 것:

  1. 장치-데이터베이스: 장치가 트랜잭션을 데이터베이스에 정상적으로 기록해야 합니다
  2. 데이터베이스-컴퓨터: 컴퓨터가 데이터베이스에서 읽을 수 있어야 합니다 (쿼리 접근)
  3. 컴퓨터-클라우드: 컴퓨터가 웹훅을 전달하려면 인터넷이 있어야 합니다

장애 시나리오:

장치가 데이터베이스와의 연결을 잃은 경우:

  • 장치가 트랜잭션을 데이터베이스에 저장할 수 없습니다
  • 트랜잭션이 유실되거나 장치에 큐잉됩니다 (장치에 따라 동작이 다름)
  • 컴퓨터는 데이터베이스에 기록된 적 없는 데이터를 가져올 수 없습니다

데이터베이스 서버가 충돌한 경우:

  • 장치가 새 트랜잭션을 기록할 수 없습니다
  • 컴퓨터가 기존 트랜잭션을 읽을 수 없습니다
  • 충돌 이전에 데이터베이스에 있던 데이터는 데이터베이스가 복구되면 사용할 수 있을 수 있습니다

컴퓨터가 데이터베이스 접근을 잃은 경우:

  • 컴퓨터가 새 트랜잭션을 읽을 수 없습니다
  • 장치는 (장치가 데이터베이스에 접근 가능하다면) 데이터베이스에 계속 기록합니다
  • 컴퓨터-데이터베이스 연결이 복구되면 컴퓨터가 누적된 기록을 읽습니다

컴퓨터가 인터넷을 잃은 경우:

  • 컴퓨터는 데이터베이스에서 계속 읽습니다
  • 컴퓨터가 데이터베이스 기록을 로컬에 큐잉합니다
  • 인터넷이 복구되면 컴퓨터가 큐에 쌓인 데이터를 클라우드에 푸시합니다

Mode B/D에 대한 핵심 이해:

데이터베이스는 장치와 컴퓨터 사이의 중간 저장소 역할을 합니다. 데이터 흐름은 다음에 달려 있습니다.

  1. 장치가 데이터베이스에 정상적으로 기록함
  2. 데이터베이스가 컴퓨터에서 계속 접근 가능함
  3. 컴퓨터가 데이터베이스에서 읽어 클라우드에 푸시함

장치가 데이터베이스에 기록할 수 없으면(네트워크 문제, 데이터베이스 다운) 트랜잭션이 저장되지 않으며 나중에 가져올 수 없습니다. 이것이 데이터베이스 의존 모드의 핵심 제한입니다.

오프라인 데이터 처리 및 자동 복구

Native Push 오프라인 처리:

예시 시나리오 – 소매점 인터넷 장애:

9:00 AM - Internet outage begins
9:05 AM - Employee scans fingerprint → Device stores locally (queue: 1 transaction)
9:15 AM - Employee scans fingerprint → Device stores locally (queue: 2 transactions)
9:30 AM - Employee scans fingerprint → Device stores locally (queue: 3 transactions)
11:00 AM - Internet restored
11:00:05 AM - Device detects connectivity, automatically pushes all 3 queued transactions
11:00:06 AM - Cloud API receives transactions, triggers webhooks
11:00:07 AM - Partner application receives all 3 attendance records

수동 개입이 필요 없습니다. 장치가 큐잉, 연결 복구 감지, 자동 동기화를 처리합니다.

Hybrid Mode A/C 오프라인 처리:

예시 시나리오 – 서버 연결이 간헐적인 제조 시설:

2:00 PM - Intermediary computer loses internet (local network still operational)
2:05 PM - Service polls devices, collects 5 new transactions, queues locally
2:35 PM - Service polls devices, collects 3 new transactions, queues locally (total: 8)
3:05 PM - Service polls devices, collects 2 new transactions, queues locally (total: 10)
4:00 PM - Internet restored to computer
4:00:10 PM - Service detects connectivity, pushes first batch of queued transactions
4:00:40 PM - Service pushes second batch
4:01:10 PM - Service pushes third batch
4:01:40 PM - All queued data delivered, service resumes normal 30-second polling

컴퓨터 저장소에 자동 큐잉, 인터넷 복구 자동 감지, 큐에 쌓인 데이터의 자동 일괄 전달.

Hybrid Mode B/D 오프라인 처리:

예시 시나리오 – 데이터베이스 서버를 유지보수하는 의료 시설:

10:00 PM - Database server taken offline for maintenance
10:30 PM - Devices cannot write to database (transactions lost if not stored on device)
11:00 PM - Database server brought back online
11:00:05 PM - Devices resume writing to database
11:30 PM - Computer polls database, retrieves transactions written since 11:00 PM
11:30:05 PM - Computer pushes retrieved transactions to cloud via webhooks

핵심 차이: 데이터베이스를 사용할 수 없는 동안(오후 10:00 – 11:00) 발생한 트랜잭션은 장치의 동작에 따라 달라집니다.

  • 내부 큐잉이 있는 장치: 트랜잭션을 저장했다가 접근 가능해지면 DB에 기록합니다 (손실 없음)
  • 내부 큐잉이 없는 장치: 데이터베이스 중단 시간 동안 트랜잭션이 유실됩니다

이 때문에 Mode B/D는 장치 기능과 데이터베이스 안정성에 대한 신중한 평가가 필요합니다.

실제 배포 시나리오와 사례

시나리오 1: 전국 소매 체인 – Native Push

조직 개요:

  • 전국 500개 이상의 소매 매장
  • 각 매장에 ZKTeco MultiBio 800 얼굴 + 지문 단말기
  • 클라우드 기반 기업 HRMS (SAP SuccessFactors)
  • 요구 사항: 교대 관리를 위한 실시간 출퇴근 가시성

인프라:

  • 각 매장에 인터넷 접속이 가능한 WiFi 네트워크가 있음
  • 기업 방화벽이 아웃바운드 HTTPS를 허용함
  • 장치가 developer.camsbiometrics.com에서 호환성이 검증됨

배포:

  • 모드: 전체 Web API를 사용하는 Native Push
  • 장치 설정: 장치에 클라우드 API 엔드포인트와 위치별 고유 API 키를 설정
  • 네트워크: 장치가 매장 WiFi로 연결되어 클라우드와 직접 통신
  • 사용자 관리: HR 팀이 API로 직원 데이터를 업로드하고, 직원은 매장 장치에서 생체 정보를 등록

데이터 흐름:

Employee scans face at 9:00:00 AM
    ↓ [< 1 second]
Device pushes to cloud at 9:00:00.5 AM
    ↓ [< 0.5 seconds]
Cloud triggers webhook at 9:00:01 AM
    ↓ [< 1 second]
SAP SuccessFactors receives attendance at 9:00:02 AM
Total latency: 2 seconds from scan to HRMS

실현된 이점:

  • 매장 관리자가 교대 일정 수립을 위해 실시간 출퇴근을 확인
  • 지각이나 무단 결근에 대한 즉시 알림
  • 본사에서 500개 이상의 장치를 중앙 제어
  • 원격 문제 해결 및 설정 업데이트
  • 수동 데이터 동기화가 전혀 필요 없음

매장 인터넷 장애 처리:

  • 오전 10시에 매장 인터넷이 끊김
  • 장치가 로컬에서 출퇴근을 계속 수집 (장치 메모리에 저장)
  • 오후 2시에 인터넷이 복구됨
  • 장치가 큐에 쌓인 4시간 분량의 출퇴근 데이터를 몇 초 만에 자동으로 푸시
  • 데이터 손실 없음, 수동 개입 없음

시나리오 2: 제조 시설 – Hybrid Mode C (에어갭)

조직 개요:

  • 자동차 부품 제조 공장
  • 3교대 근무 직원 200명
  • 생산 현장이 격리된 네트워크에 있음 (보안을 위한 에어갭)
  • 레거시 Suprema BioEntry Plus 장치 (10년 이상, 클라우드 기능 없음)
  • 기업 ERP(Oracle)에 출퇴근 연동이 필요함

인프라:

  • 생산 네트워크: 192.168.10.x (완전히 격리됨, 인터넷 없음)
  • 기업 네트워크: 10.0.5.x (인터넷 사용 가능)
  • 듀얼 네트워크 인터페이스를 갖춘 게이트웨이 서버가 두 네트워크를 연결함
  • 보안 정책상 모든 생산 장치의 인터넷 접속이 금지됨

배포:

  • 모드: Hybrid Mode C (하드웨어에 대한 로컬 서비스)
  • 중간 장치: 듀얼 NIC(네트워크당 하나)를 갖춘 Windows Server 2019
  • 로컬 서비스: Cams Local Service를 설치하여 30초마다 장치를 폴링
  • 장치 접근: 생산 네트워크에서 직접 TCP/IP 통신 (포트 포워딩 불필요)

네트워크 토폴로지:

Production Floor (Air-Gapped: 192.168.10.x)
    |
    |- Biometric Device 1: 192.168.10.101
    |- Biometric Device 2: 192.168.10.102
    |- Biometric Device 3: 192.168.10.103
    |- Gateway Server NIC 1: 192.168.10.200
          |
          |- (Same physical server)
          |
    Gateway Server NIC 2: 10.0.5.50
    |
Corporate Network (Internet-Enabled: 10.0.5.x)
    |
Internet → Cloud API → Oracle ERP

데이터 흐름:

9:00:00 AM - Employee scans fingerprint at Device 1 (192.168.10.101)
9:00:00 AM - Device stores transaction locally
9:00:15 AM - Local Service polls Device 1: "Any new transactions?"
9:00:15.5 AM - Device responds with transaction data
9:00:16 AM - Service sends transaction to cloud via NIC 2 (10.0.5.50)
9:00:17 AM - Cloud triggers webhook to Oracle ERP
9:00:18 AM - ERP receives attendance record
Total latency: ~18 seconds (within 30-second polling window)

실현된 이점:

  • 에어갭 보안 정책 유지 (장치가 인터넷에 전혀 접촉하지 않음)
  • 업그레이드할 수 없었던 레거시 장치에서도 작동
  • 네트워크 격리에도 불구하고 출퇴근 데이터 중앙 집중화
  • 게이트웨이 서버가 보안 경계 간 전달을 처리
  • IT 보안팀이 배포를 승인 (정책 위반 없음)

게이트웨이 서버 오프라인 처리:

  • 오후 2시에 게이트웨이 서버의 인터넷이 끊김 (생산 네트워크는 정상 운영)
  • 장치가 격리된 네트워크에서 출퇴근을 계속 수집
  • Local Service가 장치를 계속 폴링하며 트랜잭션을 수집
  • 서비스가 수집한 데이터를 게이트웨이 서버 저장소에 큐잉
  • 오후 4시에 인터넷이 복구됨
  • 서비스가 큐에 쌓인 2시간 분량의 데이터를 클라우드에 자동으로 푸시
  • ERP가 모든 출퇴근 기록을 수신하며 데이터 손실 없음

시나리오 3: 다중 지점 기업 사무실 – Hybrid Mode A (포트 포워딩)

조직 개요:

  • 50개 지사를 둔 전문 서비스 기업
  • 혼합 장치: eSSL K21 Pro, Anviz FacePass, 구형 ZKTeco F18 모델
  • 일부 장치는 호환성이 검증되었고, 다른 장치는 검증에 실패함
  • 회사 정책: 모든 장치가 동일한 연동 방식을 사용해야 함 (일관성)
  • 클라우드 기반 HR 플랫폼 (Workday)

인프라:

  • 각 지사에 로컬 서버(Windows Server 또는 Linux)가 있음
  • 기업 VPN이 모든 위치를 연결함
  • 각 지사의 로컬 네트워크에 장치가 있음 (192.168.x.x)
  • 로컬 서버는 인터넷에 접속할 수 있음
  • 지사 라우터에 포트 포워딩이 설정됨

배포:

  • 모드: Hybrid Mode A (SDK를 사용한 포트 포워딩 방식 하드웨어 연결)
  • 중간 장치: 각 지사에서 Cams SDK를 실행하는 서버
  • SDK 설정: 포트 포워딩을 통해 장치에 연결
  • Hybrid를 선택한 이유: 호환 장치와 비호환 장치가 혼재함. 모든 위치에 표준화된 배포

네트워크 설정 예시 – 지사 사무실:

Branch Office Network (192.168.1.x)
    |
    |- Device 1: 192.168.1.50 (eSSL K21 Pro - compatible but using hybrid for consistency)
    |- Device 2: 192.168.1.51 (Anviz FacePass - failed verification, requires hybrid)
    |- Branch Server: 192.168.1.100 (runs SDK, has internet)
    |
Branch Router (port forwarding)
    |- Forwards port 4370 → 192.168.1.50
    |- Forwards port 4371 → 192.168.1.51
    |
Internet → Cloud API → Workday

SDK 폴링 설정:

SDK polls Device 1 every 30 seconds at 192.168.1.50:4370
SDK polls Device 2 every 30 seconds at 192.168.1.51:4371

데이터 흐름:

10:30:00 AM - Employee scans at Device 2 (Anviz FacePass)
10:30:00 AM - Device stores transaction
10:30:15 AM - SDK polls Device 2, retrieves transaction
10:30:16 AM - SDK sends to cloud API
10:30:17 AM - Cloud triggers webhook to Workday
10:30:18 AM - Workday receives attendance
Latency: ~18 seconds

사용자 관리 워크플로:

HR adds new employee in Workday
Workday triggers system to create user
    ↓
System adds user on Device 2 (without biometric)
    ↓
Employee visits branch office, enrolls fingerprint locally at Device 2
    ↓
Device stores template, employee can now authenticate

실현된 이점:

  • 장치 호환성이 혼재함에도 50개 전 지사에 표준화된 연동
  • 클라우드 검증에 실패한 장치에서도 작동
  • 본사에서 중앙 관리
  • HR 팀에 일관된 사용자 경험 제공
  • 장치 유형과 연식에 관계없이 단일 연동 유지

시나리오 4: 의료 캠퍼스 – Hybrid Mode D (데이터베이스, 규정 준수)

조직 개요:

  • 건물 5개, 직원 1,000명 이상의 병원
  • Realtime T502 지문 단말기 (총 15대)
  • 장치가 로컬 SQL Server 데이터베이스에 기록
  • HIPAA 준수를 위해 온프레미스 데이터 처리가 필요함
  • 어떤 생체인식 장치도 인터넷 접속이 허용되지 않음 (보안 정책)
  • 병원 인력 관리 시스템과의 연동이 필요함

인프라:

  • 모든 장치가 병원 내부 네트워크에 있음 (172.16.x.x)
  • 병원 데이터 센터의 SQL Server 2019 데이터베이스 (172.16.10.50)
  • 장치가 데이터베이스 테이블에 출퇴근 기록을 씀
  • 클라우드 연동을 위해 인터넷에 접속할 수 있는 애플리케이션 서버 (172.16.20.100)
  • 데이터 주권 요건: 생체 데이터는 구내를 벗어나지 않음

배포:

  • 모드: Hybrid Mode D (데이터베이스에 대한 로컬 서비스)
  • 중간 장치: Cams Local Service를 실행하는 애플리케이션 서버
  • 데이터베이스 접근: 서비스가 30초마다 SQL Server에서 읽음
  • 장치 제어 불가: 서비스는 읽기만 하며 장치를 관리할 수 없음

네트워크 토폴로지:

Hospital Internal Network (172.16.x.x)
    |
    |- Biometric Devices (15 devices, various buildings)
    |    ↓ [Write attendance to SQL Server]
    |
    |- SQL Server: 172.16.10.50
    |    ↑ [Service reads attendance table]
    |
    |- Application Server: 172.16.20.100 (has internet)
         ↓ [HTTPS to cloud]
         |
Internet → Cloud API → Workforce Management System

데이터베이스 폴링:

-- Service executes every 30 seconds
SELECT 
    PunchID, EmployeeID, PunchTime, DeviceID, VerifyMode
FROM AttendanceDB.dbo.PunchLog
WHERE SyncStatus = 'Pending'
ORDER BY PunchTime ASC;

-- After successful cloud push
UPDATE AttendanceDB.dbo.PunchLog
SET SyncStatus = 'Synced', SyncTime = GETDATE()
WHERE PunchID IN (...);

데이터 흐름:

7:00:00 AM - Nurse scans fingerprint at Building A device
7:00:00.5 AM - Device writes to SQL Server attendance table
7:00:15 AM - Local Service polls database, finds new record
7:00:16 AM - Service sends transaction to cloud
7:00:17 AM - Cloud triggers webhook to workforce system
7:00:18 AM - Workforce system receives attendance
Latency: ~18 seconds from scan to system

HIPAA 준수 유지:

  • 생체 템플릿이 병원 네트워크를 벗어나지 않음 (장치에만 저장)
  • 출퇴근 트랜잭션(타임스탬프, 직원 ID)만 클라우드로 전송
  • 출퇴근 데이터에 PHI(보호 대상 건강 정보)가 없음
  • 장치가 인터넷에서 격리됨 (원격 접근 불가)
  • 감사 추적을 위해 데이터베이스 접근 로그를 유지

수용한 제한 사항:

  • 사용자 관리 기능 없음 (사용자는 장치의 로컬 인터페이스에서 관리)
  • 원격 장치 설정 불가
  • 트랜잭션 데이터 흐름만 제공 (병원 요구 사항에는 충분)

실현된 이점:

  • 의료 데이터 보안 정책 완전 준수
  • 정책 위반 없이 클라우드 인력 시스템과 연동
  • 기존 데이터베이스 인프라와 함께 작동
  • 장치 배포나 사용자 워크플로 변경 없음
  • 모든 데이터 동기화 이벤트의 감사 추적

시나리오 5: 정부 시설 – Hybrid Mode C (최고 수준 보안)

조직 개요:

  • 기밀 구역이 있는 방위 산업체 시설
  • 보안 인가를 받은 직원 50명
  • 출입 통제 지점의 Morpho MSO 1300 지문 인식기
  • 시설이 격리된 네트워크에 있음 (SCIF – 민감 구획 정보 시설 요건)
  • 보안 구역에는 인터넷에 연결된 장치가 허용되지 않음
  • 계약업체 관리 시스템과의 연동이 필요함

인프라:

  • 보안 구역 네트워크: 10.20.30.x (완전히 격리됨, 외부 연결 없음)
  • 관리 네트워크: 10.50.60.x (승인된 시스템에 한해 제한적 인터넷 접속)
  • 보안 정책으로 네트워크 간 에어갭을 강제함
  • 보안 구역에서 관리 네트워크로의 단방향 데이터 다이오드 (검토 후 기각 – 이 사용 사례에는 양방향이 필요)
  • 듀얼 홈 서버: 네트워크를 연결하는 유일한 승인된 시스템

배포:

  • 모드: Hybrid Mode C (하드웨어에 대한 로컬 서비스)
  • 중간 장치: 듀얼 네트워크 카드를 갖춘 보안 강화 Windows Server (크로스 도메인 운영 인증)
  • 보안 인가: 서버는 출입이 통제되는 실에 물리적으로 설치
  • 감사 로깅: 보안 규정 준수를 위해 모든 데이터 전송을 기록

네트워크 아키텍처:

Secure Area Network (10.20.30.x - NO INTERNET)
    |
    |- Access Control Point 1: 10.20.30.101
    |- Access Control Point 2: 10.20.30.102
    |- Access Control Point 3: 10.20.30.103
    |- Dual-Homed Server NIC 1: 10.20.30.200
          |
          |- (Physical server in secure control room)
          |
    Dual-Homed Server NIC 2: 10.50.60.50
    |
Administrative Network (10.50.60.x - LIMITED INTERNET)
    |
Internet (through security gateway) → Cloud API → Contractor Management System

보안 통제:

  • Local Service는 제한된 권한으로 실행됨 (정의된 장치 이외의 보안 구역에는 접근 불가)
  • 모든 데이터 전송을 SIEM(보안 정보 및 이벤트 관리)에 기록
  • 생체 템플릿은 전송되지 않음 (보안 네트워크 장치에 유지)
  • 기밀이 아닌 출퇴근 데이터(타임스탬프, 배지 번호)만 네트워크 경계를 넘음
  • 데이터 전송 로그에 대한 월간 보안 감사
  • 서비스 계정 비밀번호를 분기마다 교체

보안 로깅이 포함된 데이터 흐름:

8:00:00 AM - Employee badges in at Access Point 1 (fingerprint verification)
8:00:00.5 AM - Device stores transaction on secure network
8:00:15 AM - Service polls device on secure NIC (10.20.30.200)
              [AUDIT LOG: Service accessed device 10.20.30.101]
8:00:15.5 AM - Service receives transaction data
              [AUDIT LOG: Data retrieved: Badge 1234, Time 08:00:00]
8:00:16 AM - Service sanitizes data (removes any potentially sensitive fields)
8:00:16.5 AM - Service sends to cloud via admin NIC (10.50.60.50)
              [AUDIT LOG: Data transmitted to cloud API]
8:00:17 AM - Cloud API receives, triggers webhook
8:00:18 AM - Contractor management system receives attendance
              [AUDIT LOG: Webhook delivery confirmed]

실현된 이점:

  • SCIF 보안 요건 완전 준수
  • 생체 데이터가 격리된 보안 네트워크에 유지됨
  • 승인된 듀얼 홈 서버만 네트워크를 연결함
  • 보안 규정 준수를 위한 완전한 감사 추적
  • 보안 태세를 해치지 않고 출입 통제 시스템을 계약업체 관리 시스템과 연동

보안 사고 대응: 보안팀이 이상 징후를 감지한 경우:

  1. 관리 네트워크를 통해 서비스를 즉시 비활성화할 수 있음
  2. 감사 로그를 검토하여 접근/전송된 데이터를 식별
  3. 보안 구역 장치는 독립적으로 계속 작동 (로컬 인증)
  4. 서비스를 다시 활성화하기 전에 조사를 완료

SEO 최적화 키워드 및 개념

이 문서는 다음에 대한 솔루션을 다룹니다.

생체인식 장치 연동: 지문 출퇴근 시스템 API, 얼굴 인식 연동, 홍채 스캐너 연결, 손바닥 정맥 리더 클라우드 연동, 다중 생체인식 API, 출입 통제 시스템 연동, 근태 장치 API, 생체인식 장치 클라우드 연결, 출퇴근 단말기 API 연동, 생체인식 타임 클록 API

장치 제조사: ZKTeco API 연동, Suprema BioStar 클라우드 연동, Anviz 장치 연결, eSSL Matrix 출퇴근 API, Realtime Startek 연동, Virdi 출입 통제 API, Nitgen 지문 API, Morpho IDEMIA 연동, Mantra 장치 연결, Secugen API, Hikvision 출퇴근 연동, Biomax 연동, 생체인식 하드웨어 연동

연동 과제: 벤더 종속 해결, 독자 프로토콜 호환성, 레거시 장치 클라우드 연결, 에어갭 네트워크 생체인식 연동, 방화벽 제한 장치 연동, 격리 네트워크 출퇴근 시스템, 생체인식 장치 상호 운용성, 다중 벤더 생체인식 연동

배포 방식: 클라우드 생체인식 API, 온프레미스 생체인식 연동, 하이브리드 클라우드 배포, 생체인식용 엣지 컴퓨팅, 로컬 서비스 생체인식 커넥터, 데이터베이스 수준 출퇴근 연동, 웹훅 기반 생체인식 연동, 실시간 출퇴근 API

네트워크 아키텍처: 에어갭 생체인식 시스템, DMZ 생체인식 배포, VPN 출퇴근 연동, 프록시 제한 장치 연결, NAT 방화벽 생체인식 연동, 듀얼 홈 서버 배포, 격리 네트워크 생체인식 솔루션

규정 준수 및 보안: HIPAA 준수 생체인식 연동, PCI-DSS 출퇴근 시스템, 데이터 주권 생체인식 솔루션, SCIF 준수 출입 통제, 감사 로깅 출퇴근 연동, 제로 트러스트 생체인식 아키텍처, 안전한 생체 데이터 전송

비즈니스 애플리케이션: HRMS 생체인식 연동, ERP 출퇴근 커넥터, Workday 생체인식 API, SAP SuccessFactors 출퇴근, Oracle HCM 생체인식 연동, 급여 시스템 커넥터, 인력 관리 연동, 근무 시간 추적 API 연동

산업별 솔루션: 제조 현장 출퇴근, 소매 체인 생체인식 연동, 의료 출입 통제, 정부 시설 생체인식, 교육 기관 출퇴근, BPO 출퇴근 관리, 물류 창고 연동, 숙박업 근무 시간 추적

기술 기능: 실시간 출퇴근 웹훅, 생체 템플릿 동기화, 원격 사용자 등록, 장치 설정 API, 다중 장치 관리, 오프라인 데이터 큐잉, 자동 동기화, 출퇴근 데이터 조회

자주 묻는 질문 (FAQ)

Q: 내 장치가 Native Push를 지원하는지, Hybrid 배포가 필요한지 어떻게 알 수 있나요?

A: Cams Biometrics가 제조한 장치는 Native Push가 내장되어 있어 바로 사용할 수 있습니다. 타사 장치(ZKTeco, Suprema, Anviz 등)는 developer.camsbiometrics.com 에서 호환성 검증을 실행하세요. 장치 모델과 시리얼 번호를 입력하면 시스템이 통신 프로토콜을 테스트합니다. 검증에 성공하면 장치가 Native Push를 지원합니다. 검증에 실패하거나 오류가 표시되면 Hybrid 배포가 필요합니다.

Q: 같은 조직에서 Native Push와 Hybrid 배포를 혼합할 수 있나요?

A: 예. 조직에서는 일반적으로 호환되는 최신 장치에는 Native Push를, 레거시 또는 비호환 장치에는 Hybrid 배포를 사용합니다. Biometric Gateway는 혼합 배포를 지원하며, 기반 배포 모드와 관계없이 일관된 형식으로 웹훅을 전달합니다. HRMS 또는 ERP 연동 코드는 각 장치가 어떤 배포 모드를 사용하는지 알 필요가 없습니다.

Q: 인터넷 연결이 끊기면 출퇴근 데이터는 어떻게 되나요?

A:

  • Native Push: 장치가 트랜잭션을 내부 메모리(일반적으로 50,000-100,000건)에 큐잉합니다. 인터넷이 복구되면 장치가 큐에 쌓인 모든 데이터를 클라우드에 자동으로 푸시합니다.
  • Hybrid Mode: 중간 컴퓨터가 트랜잭션을 로컬에 큐잉합니다. 컴퓨터의 인터넷 연결이 복구되면 큐에 쌓인 데이터를 클라우드에 자동으로 푸시합니다. 참고: Hybrid 모드에서는 오프라인 기간 동안 트랜잭션을 수집하려면 컴퓨터가 장치에 접근할 수 있어야 합니다.

Q: 직원이 장치를 방문하지 않고 원격으로 생체 정보를 등록할 수 있나요?

A:

  • Native Push: 예. 생체 템플릿을 어느 위치에서든 수집하여 API로 업로드할 수 있습니다. 클라우드가 대상 장치에 템플릿을 푸시하여 원격 등록이 가능합니다.
  • Hybrid Mode: 아니요. 직원은 지문, 얼굴 또는 홍채를 로컬에서 등록하려면 생체인식 장치를 직접 방문해야 합니다. 시스템은 사용자 기록을 생성할 수 있지만 생체 정보 수집은 장치에서 이루어져야 합니다.

Q: Hybrid 배포에서 30초 지연이 있는 이유는 무엇인가요?

A: Hybrid 배포는 폴링 아키텍처를 사용합니다. 중간 컴퓨터 또는 서비스가 30초마다 장치에 “새 트랜잭션이 있나요?”라고 확인합니다. 이 간격은 준실시간 성능과 네트워크 효율의 균형을 맞춥니다. 더 빠르게(예: 5초마다) 폴링하면 대역폭과 장치 자원을 더 많이 소모하지만 일반적인 출퇴근 사용 사례에서는 이점이 미미합니다. 특정 요구 사항이 있으면 30초 간격을 사용자 지정할 수 있습니다.

Q: Hybrid 배포에서 Mode A와 Mode C의 차이는 무엇인가요?

A: 둘 다 장치 하드웨어에 연결하지만 네트워크 요구 사항이 다릅니다.

  • Mode A (포트 포워딩): 라우터/방화벽에서 포트 포워딩 설정이 필요합니다. 중간 컴퓨터와 장치가 서로 다른 네트워크 구간이나 서브넷에 있을 때 사용합니다.
  • Mode C (로컬 서비스): 포트 포워딩이 필요하지 않습니다. 중간 컴퓨터와 장치가 같은 로컬 네트워크에 있거나 네트워크 정책상 포트 포워딩이 허용되지 않을 때 사용합니다.

포트 포워딩이 가능하고 장치가 다른 네트워크에 있다면 Mode A를 선택하세요. 모든 것이 같은 로컬 네트워크에 있거나 네트워크 정책이 포트 포워딩을 금지한다면 Mode C를 선택하세요.

Q: Hybrid Mode B 또는 D로 사용자 관리와 장치 설정을 할 수 있나요?

A: 아니요. Mode B와 D는 데이터베이스 수준에서 연동되어 트랜잭션 데이터 흐름만 제공합니다. 장치에 명령을 보내거나 사용자를 관리할 수 없습니다. 사용자 등록과 장치 설정은 장치의 로컬 인터페이스 또는 장치 제조사의 소프트웨어를 통해 수행해야 합니다. 이 모드는 출퇴근 트랜잭션 데이터만 필요하고 장치 제어가 필요하지 않을 때 적합합니다.

Q: 생체인식 장치 연결에 필요한 대역폭은 얼마인가요?

A:

  • Native Push: 장치당 10-50 Kbps. 일반적인 출퇴근 트랜잭션은 1-2 KB입니다. 대규모 배포(장치 100대)도 최소한의 대역폭(총 < 5 Mbps)만 필요합니다.
  • Hybrid Mode: 컴퓨터-클라우드 연결에는 장치 수에 따라 100 Kbps ~ 1 Mbps가 필요합니다. 장치-컴퓨터 대역폭은 통신 프로토콜에 따라 다릅니다(보통 최소).

일반적인 사무실 인터넷 연결로도 수백 대의 장치를 쉽게 지원할 수 있습니다.

Q: 시스템은 시계 동기화와 시간대를 어떻게 처리하나요?

A:

  • 모든 출퇴근 트랜잭션에는 장치 현지 시간의 타임스탬프가 포함됩니다
  • 클라우드 API는 타임스탬프를 받아 저장을 위해 UTC로 변환합니다
  • 파트너 애플리케이션에 전달되는 웹훅에는 UTC와 장치 현지 시간이 모두 포함됩니다
  • 다중 지점 배포를 위한 시간대 설정은 API로 관리됩니다
  • 장치 정확도를 위해 NTP(Network Time Protocol) 동기화를 권장합니다

Q: Hybrid 배포에서 중간 컴퓨터가 고장 나면 어떻게 되나요?

A:

  • 생체인식 장치는 정상적으로 계속 작동하며 로컬에서 출퇴근을 수집합니다
  • 장치가 트랜잭션을 로컬 메모리에 저장합니다
  • 새 중간 컴퓨터가 배포되거나 (고장 난 컴퓨터가 수리되면):
    • 컴퓨터가 장치를 폴링합니다
    • 장치가 저장된 모든 트랜잭션을 제공합니다
    • 컴퓨터가 누적된 데이터를 클라우드에 푸시합니다
    • 데이터 손실 없음 (장치 저장 용량 한도 내)

권장 사항: 중간 컴퓨터의 가동 시간을 모니터링하고, 중요한 배포에는 백업/이중화를 마련하세요.

Q: 같은 생체 템플릿을 여러 장치에서 사용할 수 있나요?

A:

  • Native Push: 예. API로 생체 템플릿을 한 번 업로드하면 클라우드가 지정된 모든 장치에 배포합니다. 한 번 등록으로 여러 장치에서 인증합니다.
  • Hybrid Mode: 자동 배포가 없습니다. 직원이 각 장치에서 별도로 등록해야 하며, 조직이 장치 제조사의 도구를 사용해 장치 간에 템플릿을 수동으로 복사해야 합니다.

Q: 전송 중 데이터 보안은 어떻게 처리되나요?

A: 모든 모드는 클라우드 통신에 HTTPS(TLS 1.2+) 암호화를 사용합니다.

  • Native Push: 장치-클라우드 구간 암호화
  • Hybrid Mode: 컴퓨터-클라우드 구간 암호화
  • 파트너 애플리케이션으로의 웹훅 전달: HTTPS 권장 (설정 가능)
  • API 인증: 요청 검증을 포함한 키 기반 서명
  • 생체 템플릿: 장치에는 암호화되어 저장되고, 전송 시에는 전송 중 암호화됩니다

Q: 과거 출퇴근 데이터에 접근할 수 있나요?

A:

  • Native Push: 예. 날짜 범위, 직원, 장치 필터링 기능을 사용해 API로 과거 출퇴근 기록을 조회할 수 있습니다
  • Hybrid Mode: 과거 데이터는 웹훅을 통해서만 접근할 수 있습니다 (트랜잭션 발생 시 실시간 전달). 파트너 애플리케이션은 과거 데이터 접근을 위해 웹훅으로 전달된 데이터를 저장해야 합니다.

Q: 어떤 장치 모니터링 및 진단 기능을 사용할 수 있나요?

A:

  • Native Push: 전체 장치 상태 제공 (온라인/오프라인, 메모리 사용량, 펌웨어 버전, 오류 로그, 마지막 통신 시간, 장치 상태 지표)
  • Hybrid Mode A/C: 제한된 장치 상태 (마지막 폴링 시간, 트랜잭션 수, 기본 연결 상태)
  • Hybrid Mode B/D: 장치 진단 없음 (데이터베이스 연동만 가능)

Native Push는 포괄적인 원격 모니터링과 문제 해결 기능을 제공합니다.

기술 지원 및 구현 지원

배포 아키텍처, 장치 호환성 또는 연동 계획에 대해 궁금하신가요? 이 포럼 스레드에 구체적인 시나리오를 게시해 주세요:

질문에 포함할 내용:

  • 장치 제조사와 모델 번호
  • 현재 네트워크 토폴로지 (인터넷 접속, 방화벽 규칙, 격리된 네트워크)
  • 연동 요구 사항 (실시간 대 30초 지연 허용 여부, 장치 제어 필요 여부 대 트랜잭션 흐름만 필요)
  • 규정 준수 또는 보안 제약 (에어갭 요건, 데이터 주권 등)
  • 장치 수와 위치

Cams Biometrics 기술팀이 이 포럼을 매일 모니터링하며 인프라와 요구 사항에 맞는 구체적인 권장 사항을 제공합니다.

장치 호환성 검증은 developer.camsbiometrics.com 에서 장치를 테스트하세요.

자세한 API 문서는 다음을 참고하세요: Biometric Web API documentation.


The Biometric Gateway | 하나의 API. 모든 장치. 모든 네트워크. 모든 ERP.

적응형 아키텍처. 범용 호환성. 벤더 종속 제로.

Was this article helpful?