Support Hub/API & Integrations/공인 IP 없이 생체인식 장치 연결하기: Hybrid Connector 설명
Translated from the English article and reviewed by a person. Read the English original
Developer

공인 IP 없이 생체인식 장치 연결하기: Hybrid Connector 설명

공인 IP 없이 생체인식 장치 연결하기: Hybrid Connector 설명

많은 생체인식 연동 프로젝트가 생체인식과는 무관해 보이는 질문에서 막힙니다. 바로 사무실 라우터 뒤에 있는 장치에 클라우드가 어떻게 접근하느냐는 문제입니다. 공인 IP 주소가 없는 현장, 매일 바뀌는 IP, 방화벽에서 인바운드 포트를 열어 주지 않는 IT 팀이 많으며, 이들이 신중한 태도를 보이는 것은 타당합니다. 전통적인 해결책인 포트 포워딩은 번거롭고 내부 네트워크를 외부에 노출시킵니다. Cams Biometrics는 작은 소프트웨어인 Hybrid Connector로 이 문제를 해결합니다. 이 Connector는 현장 내부에서 밖으로 Gateway에 연결하는 방식으로 동작합니다. 이 가이드에서는 많은 장치에 접근하기 어려운 이유, Hybrid Connector의 동작 원리를 쉽게 설명하고, 이를 통해 할 수 있는 작업과 설정 방법을 안내합니다.

01 · 네트워크 문제

많은 생체인식 장치에 접근하기 어려운 이유

로컬 네트워크에 있는 생체인식 장치는 사유 도로에 있는 집과 같습니다. 안에 있는 사람은 언제든 나갈 수 있지만, 누군가 문을 열어주지 않는 한 밖에서는 들어올 수 없습니다. 클라우드 플랫폼이 장치에 직접 접근하려면 현장에 공인 주소와 장치로 이어지는 방화벽 개방 설정이 필요합니다. 많은 현장에는 여러 합당한 이유로 이것이 없습니다.

상황 의미 직접 접근이 실패하는 이유
공인 IP 없음 인터넷 제공업체가 하나의 공인 주소를 여러 고객이 공유함 현장으로 연결되는 고유한 주소가 없음
변경되는 IP 주소 현장의 공인 IP가 주기적으로 바뀜 오늘 작동하는 주소가 내일은 다른 곳을 가리킬 수 있음
엄격한 방화벽 정책 IT 부서가 인터넷에서 들어오는 연결을 허용하지 않음 클라우드가 장치와 먼저 통신을 시작할 수 없음
포트 포워딩 불가 라우터를 건물주, ISP 또는 본사에서 관리함 현장의 누구도 문을 열 수 없음
보안 우려 포트를 열면 내부 시스템이 인터넷에 노출됨 가능하더라도 많은 조직이 이런 위험을 받아들이지 않음

소매 지점, 건설 현장, 창고, 학교, 소규모 사무실 모두 이러한 한계에 부딪힙니다. 그러나 이는 클라우드 생체인식 연동을 포기할 이유가 아닙니다. 다른 방식으로 연결해야 한다는 신호일 뿐입니다.

02 · 직접 방식과 간접 방식

Hybrid Push 장치를 연결하는 두 가지 방식

Cams 장치와 developer.camsbiometrics.com에서 검증된 장치는 Native Push를 통해 Gateway에 연결되며, 인터넷을 통해 Gateway와 직접 통신합니다. 그 밖의 장치는 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

로컬 컴퓨터에서 실행되며 장치와 로컬에서 통신함

→

아웃바운드 연결

Connector가 Gateway를 향해 연결함

→

Cams Gateway

이 연결을 통해 ERP/HRMS와 데이터를 주고받음

연결이 현장 네트워크 내부에서 시작되므로, 이는 해당 컴퓨터의 웹 브라우저가 동작하는 방식과 같습니다. 현장에는 공인 IP가 필요하지 않고, 방화벽은 새로운 인바운드 연결을 허용할 필요가 없습니다. Hybrid Connector는 한쪽의 로컬 장치, 데이터베이스 또는 파일과 다른 쪽의 Biometric Gateway 사이를 잇는 다리 역할을 합니다.

포트 포워딩은 네트워크 안으로 들어가는 문을 엽니다. Hybrid Connector는 문을 닫은 상태로 유지하고, 안쪽에서 먼저 연결을 겁니다.

허용할 포트 확인하기

아웃바운드 연결도 여전히 방화벽에서 허용되어야 합니다. 대부분의 네트워크는 일반적인 아웃바운드 웹 트래픽을 이미 허용하고 있지만, 엄격한 네트워크에서는 이를 제한할 수 있습니다. 설치 전에 Cams Web API 문서의 Ports Supported 섹션을 확인하고 IT 팀과 공유하세요.

04 · 기능과 제한 사항

Hybrid Connector로 할 수 있는 작업

Hybrid Connector는 현장이 어떻게 연결되는지를 결정합니다. 할 수 있는 작업이 무엇인지는 결정하지 않습니다. 이는 장치와 통신하는 데 사용하는 통신 방식에 따라 정해지며, 선택할 수 있는 방식은 세 가지입니다.

모드 통신 방식 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의 경우, Connector가 로컬에서 접근해야 하므로 장치 소프트웨어가 데이터베이스나 출근 파일을 저장하는 컴퓨터여야 합니다.

2

아웃바운드 접근 확인하기

Cams 문서의 Ports Supported 세부 정보를 IT 팀과 공유하고, 해당 컴퓨터가 필요한 아웃바운드 연결을 할 수 있는지 확인하세요.

3

Hybrid Connector 설치하기

해당 컴퓨터에 Connector를 설치하고 계정 설정 안내에 따라 Cams 계정에 연결하세요.

4

통신 방식 선택하기

Gateway가 장치의 SDK를 지원한다면 Device SDK를 선택하세요. 그렇지 않다면 출근 데이터를 위해 DB Pull 또는 File Processing을 선택하세요.

5

Callback URL 설정하기

출근 이벤트가 전달될 곳이 있도록, 수신 시스템, HRMS, ERP 또는 자동화 도구의 HTTPS 주소를 Callback URL로 설정하세요.

6

엔드 투 엔드 테스트하기

장치에서 지문 또는 얼굴을 스캔하고, 이벤트가 Callback URL에 도착하는지 확인하세요. Device SDK 모드에서는 테스트 사용자 추가 등 RESTful 작업도 시도해 보세요.

이벤트를 전송할 수신 시스템이 필요하신가요? Cams AI Code Generator Prompts를 사용하면 Python, Node.js, PHP 등 여러 언어로 완전한 콜백 수신 코드를 생성할 수 있습니다.

06 · 모범 사례

연결 상태 유지하기

설치가 끝나면 Hybrid Connector는 현장 인프라의 일부가 됩니다. 몇 가지 간단한 습관으로 안정적으로 유지할 수 있습니다.

실천 사항 중요한 이유
항상 켜져 있는 컴퓨터 사용하기 컴퓨터가 절전 모드에 들어가거나 종료되면 현장과 Gateway 사이의 연결이 일시 중단됨
절전 및 최대 절전 모드 해제하기 절전 설정은 눈에 띄지 않는 연결 끊김의 가장 흔한 원인임
Connector 자동 시작하기 재시작이나 정전 후에도 누군가 로그인하지 않아도 연결이 복구되어야 함
정전 대비하기 소형 UPS를 사용하면 짧은 정전 중에도 컴퓨터와 네트워크가 계속 작동함
컴퓨터를 최신 상태로 안전하게 유지하기 네트워크에 연결되어 있으므로 다른 관리 대상 기기와 같이 관리해야 함
이벤트 누락 확인하기 출입이 많은 현장에서 갑자기 이벤트가 전혀 없다면, 먼저 컴퓨터와 연결 상태를 확인하세요

연결이 끊기면 어떻게 되나요

출근 기록은 장치에 저장되며, Gateway의 오프라인 캐시와 대기열은 연결 중단을 처리하도록 설계되어 있습니다. 연결이 복구되면 기록은 원래의 타임스탬프와 함께 전달되므로, 중단 중에 이루어진 스캔도 올바른 시간에 표시됩니다. DB Pull과 File Processing의 경우, Connector가 읽기 전까지 기록은 장치 소프트웨어의 데이터베이스나 파일에 남아 있습니다.

자주 묻는 질문

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나 공인 IP가 필요하지 않습니다.

Hybrid Connector를 통해 여전히 사용자를 추가하고 삭제할 수 있나요?

네, Device SDK 모드에서 장치 SDK의 제한 범위 내에서 가능합니다. DB Pull과 File Processing은 RESTful 작업 없이 출근 콜백만 지원합니다.

Hybrid Connector는 우리 HRMS 또는 ERP와 함께 작동하나요?

네. Connector는 현장과 Gateway 사이의 연결을 처리합니다. HRMS, ERP 또는 자동화 도구는 다른 연결 모드와 완전히 동일하게 Callback API를 통해 이벤트를 수신합니다.

결론: 네트워크가 연동 가능 여부를 결정해서는 안 됩니다

수년 동안 장치가 설치된 위치의 네트워크가 어떤 생체인식 연동이 가능한지 조용히 결정해 왔습니다. 공인 IP가 없으면 클라우드 연결도 불가능했습니다. 엄격한 방화벽은 IT 팀과의 긴 협상을 의미했습니다. 바뀌는 IP 주소는 예고 없이 깨지는 연동을 뜻했습니다.

Hybrid Connector는 이러한 제약을 없앱니다. 안에서 밖으로 연결함으로써, 일반 사무실 라우터, 엄격한 방화벽, 공유 인터넷 연결 뒤에 있는 장치도 인바운드 포트를 단 하나도 열지 않고 다른 장치와 동일한 실시간 연동에 참여할 수 있습니다.

Cams Biometrics Gateway는 장치가 어디에 있든 온라인으로 연결합니다. Native Push는 Cams 및 검증된 장치를 직접 연결합니다. Hybrid Push는 Device SDK, DB Pull 또는 File Processing을 통해 다른 브랜드의 장치를 연결하며, 공인 IP를 사용할 수 없는 경우 직접 토폴로지 또는 Hybrid Connector를 선택할 수 있습니다. 모든 이벤트는 인증 토큰 검증과 선택 사항인 AES-256 암호화를 거쳐 동일한 Callback API를 통해 시스템에 전달됩니다. CamsBiometrics.com에서 플랫폼을 살펴보고, developer.camsbiometrics.com에서 연결 모드와 지원 포트를 포함한 전체 문서를 읽어보세요. 또한 AI Code Generator Prompts로 수신 코드를 생성할 수 있습니다.

Was this article helpful?