Support Hub/API & Integrations/Native Push 대 Hybrid 모드: 기술 의사결정 트리
Translated from the English article and reviewed by a person. Read the English original
Developer

Native Push 대 Hybrid 모드: 기술 의사결정 트리

Native Push 대 Hybrid 모드: 기술 의사결정 트리

Cams Biometric Gateway에 연결되는 모든 생체인식 장치는 두 가지 push 모드 중 하나를 통해 연결됩니다. 장치가 사용하는 모드에 따라 사용 가능한 API, 이벤트 전달 방식, 그리고 인프라 구성 방법이 결정됩니다. 이 가이드는 장치 유형, 통신 방식, 배포 토폴로지에 이르기까지 결정에 영향을 주는 모든 변수를 차례로 설명하므로, 구축을 시작하기 전에 올바른 경로를 선택할 수 있습니다.

첫 번째 질문: 연결하려는 장치는 어떤 종류인가?

통신 방식이나 배포 토폴로지를 선택하기 전에 먼저 답해야 할 더 근본적인 질문이 있습니다. 장치가 Cams Biometrics 장치인지, 아니면 Cams 개발자 포털에서 검증된 장치인지 확인하는 것입니다.

이 질문에 대한 답에 따라 push 모드가 전적으로 결정됩니다. 답이 예라면 Native Push를 사용하며 추가 결정은 필요하지 않습니다. 답이 아니요라면 Hybrid Push 범주에 해당하므로 추가 결정을 순서대로 진행해야 합니다.

모드 1
Native Push
모든 Cams Biometrics 기기 및 developer.camsbiometrics.com에서 검증된 것으로 표시된 모든 장치에 적용됩니다. 장치는 인터넷을 통해 Biometric Gateway와 직접 통신하며, 추가 설정은 필요하지 않습니다.

All 38 operations
Full Callback API
Full RESTful API

모드 2
Hybrid Push
검증되지 않은 기타 모든 장치에 적용됩니다. 환경에 맞는 통신 방식과 배포 토폴로지를 선택할 수 있습니다. API 사용 가능 여부는 선택한 조합에 따라 달라집니다.

3 communication methods
2 topology options
Variable API access

Native Push: 전체 개요

Native Push 장치는 장치를 인터넷에 연결하는 것 이외의 추가 설정 없이 Gateway의 38개 작업 전체에 대한 전체 액세스 권한을 얻습니다. Callback API는 지연 없이 이벤트를 전달합니다. RESTful API 명령은 약 15초 내에 실행됩니다. SDK, 로컬 소프트웨어, 토폴로지 결정은 필요하지 않습니다.

Hybrid Push 이해하기: 세 가지 통신 방식

사용하는 장치가 Cams 장치 또는 검증된 장치가 아니라면, 다음 결정은 Gateway가 실제로 하드웨어와 통신하는 방식입니다. 사용 가능한 통신 방식은 세 가지이며, 각 방식은 요구 사항이 다르고 사용할 수 있는 API 기능에도 서로 다른 영향을 줍니다.

통신 방식은 네트워크 구성과 관련이 없습니다. Gateway가 특정 장치에서 데이터를 읽고 장치로 명령을 보내는 데 사용하는 기술적 메커니즘에 관한 것입니다. 이 선택은 하드웨어가 지원하는 기능에 의해 제한됩니다.

a
Device SDK
전체 API 액세스에 가장 적합한 옵션
Gateway는 장치 제조사의 SDK를 사용하여 하드웨어와 통신합니다. SDK가 하위 수준의 장치 프로토콜을 처리하며, Gateway는 SDK가 지원하는 모든 기능을 API를 통해 노출합니다. 이는 Hybrid Push에서 RESTful API 작업을 사용할 수 있게 하는 유일한 통신 방식입니다.
Full Callback API + Full RESTful API (SDK 기능 범위 내)
b
DB Pull
출석 데이터 전용
Gateway는 장치 자체 관리 소프트웨어가 출석 기록을 기록하는 로컬 데이터베이스에서 데이터를 읽습니다. Gateway는 이 데이터베이스를 모니터링하고 새 기록을 실시간으로 callback URL에 전송합니다. 장치와의 직접 통신은 발생하지 않으므로 장치로 명령을 보낼 수 없습니다. 사용자 추가, 기록 삭제, 로그 적재와 같은 작업은 사용할 수 없습니다.
Callback API: 출석 및 타각 로그만 지원. RESTful API: 지원되지 않음.
c
File Processing
출석 데이터 전용
로컬 컴퓨터에 있는 지정된 출석 파일이 지속적으로 감시됩니다. 장치 소프트웨어가 이 파일을 새 출석 기록으로 업데이트할 때마다 Gateway가 변경 사항을 감지하고, 새 기록을 추출하여 실시간으로 callback URL에 전송합니다. DB Pull과 마찬가지로 이 방식은 장치 관점에서 읽기 전용이며 동일한 API 제한 사항이 적용됩니다.
Callback API: 출석 및 타각 로그만 지원. RESTful API: 지원되지 않음.
통신 방식을 선택하는 방법

장치에 Cams Gateway가 지원하는 제조사 SDK가 있다면 Device SDK (a)를 선택하십시오. 이는 Hybrid Push 장치에 대해 RESTful API 작업을 활성화하는 유일한 방식입니다. SDK가 지원되지 않거나 사용할 수 없는 경우에도 DB Pull (b) 또는 File Processing (c)을 사용하면 출석 데이터를 callback 엔드포인트로 실시간 전달할 수 있으며, 이는 많은 사용 사례에 충분합니다.

Hybrid Push 이해하기: 두 가지 배포 토폴로지

통신 방식을 선택한 후 두 번째 결정은 Gateway가 장치, 데이터베이스 또는 파일에 어디에서 연결되는지입니다. 이것이 토폴로지 결정이며, 장치의 물리적 위치에 있는 네트워크 환경에 따라 달라집니다.

토폴로지 X

직접 방식
장치가 연결되어 있거나 장치 관리 소프트웨어가 실행되는 현장 컴퓨터에 공인 IP 주소가 있으며, 로컬 네트워크로 포트 포워딩이 구성되어 있습니다. Biometric Gateway는 인터넷을 통해 장치, 데이터베이스 또는 파일에 직접 연결합니다.
필요 사항: 현장의 공인 IP + 포트 포워딩
토폴로지 Y

간접 방식
현장의 로컬 컴퓨터에 Hybrid Connector 애플리케이션이 설치됩니다. 이 애플리케이션은 로컬 머신과 Biometric Gateway 사이의 아웃바운드 브리지 역할을 하며, 외부에서 인바운드 연결을 요구하지 않고 내부에서 연결을 설정합니다. 고객 측에는 공인 IP가 필요하지 않습니다.
필요 사항: 로컬 컴퓨터에 Hybrid Connector 설치. 공인 IP 불필요.
토폴로지 권장 사항

현장에서 공인 IP 또는 포트 포워딩을 구성할 수 없다면, Hybrid Connector와 함께 간접 토폴로지(Y)를 선택하십시오. 이는 가장 간단한 배포 경로이며 고객 측 네트워크 구성을 완전히 피할 수 있습니다. 공인 IP를 사용할 수 있고 구성되어 있다면, 직접 토폴로지(X)도 작동하며 현장에 추가 소프트웨어를 설치할 필요가 없습니다.

의사결정 트리: 어떤 모드를 선택해야 하는가?

이 의사결정 트리를 위에서 아래로 따라가십시오. 상황에 맞는 첫 번째 답에서 멈추십시오.

의사결정 트리, 위에서부터 시작
1. 장치가 Cams Biometrics 장치이거나 developer.camsbiometrics.com에서 검증된 것으로 표시되어 있습니까?
예 Native Push를 사용하십시오. 전체 API 액세스가 가능합니다. 추가 결정은 필요하지 않습니다.
아니요 질문 2로 진행하십시오.
2. Cams Gateway가 장치 제조사의 SDK를 지원합니까?
예 Hybrid Push, Device SDK (a)를 사용하십시오. SDK 제한 범위 내에서 전체 Callback 및 RESTful API 액세스가 가능합니다. 토폴로지를 위해 질문 3으로 진행하십시오.
아니요 질문 2b로 진행하십시오.
2b. 장치 관리 소프트웨어가 출석 기록을 로컬 데이터베이스에 기록합니까?
예 Hybrid Push, DB Pull (b)를 사용하십시오. 출석 Callback만 가능합니다. 토폴로지를 위해 질문 3으로 진행하십시오.
3. 현장 컴퓨터에 공인 IP 주소와 사용 가능한 포트 포워딩이 있습니까?
예 직접 토폴로지(X)를 사용하십시오. 현장에 추가 소프트웨어는 필요하지 않습니다.
아니요 간접 토폴로지(Y)를 사용하십시오. 현장의 로컬 컴퓨터에 Hybrid Connector를 설치하십시오.

Hybrid Push 기능 사용 가능성 매트릭스

아래 표는 통신 방식과 배포 토폴로지의 모든 조합을 보여 주며, 각 경우에 사용할 수 있는 API 기능을 나타냅니다. 선택한 구성이 지원하는 내용을 확인하려면 의사결정 트리와 함께 사용하십시오.

모드 통신 토폴로지 Callback API RESTful API
직접 장치 (a) Device SDK (X) 공인 IP 전체 전체 (SDK 제한 적용)
간접 장치 (a) Device SDK (Y) Hybrid Connector 전체 전체 (SDK 제한 적용)
직접 DB (b) DB Pull (X) 공인 IP 출석만 지원 지원되지 않음
간접 DB (b) DB Pull (Y) Hybrid Connector 출석만 지원 지원되지 않음
직접 파일 (c) File Processing (X) 공인 IP 출석만 지원 지원되지 않음
간접 파일 (c) File Processing (Y) Hybrid Connector 출석만 지원 지원되지 않음
중요한 하드웨어 유의 사항

하드웨어 제한으로 인해 Device SDK 모드에서도 API 기능이 추가로 제한될 수 있습니다. 장치 모델의 펌웨어 버전이나 제조사 SDK가 노출하는 기능에 따라 특정 API가 작동하지 않을 수 있습니다. 위 매트릭스는 Gateway 아키텍처가 지원하는 내용을 설명하며, 개별 장치 모델이 반드시 지원한다는 것을 보장하지는 않습니다. 프로덕션 배포 전에 반드시 사용 중인 하드웨어로 테스트하고, 예외 상황은 Cams 지원팀과 함께 확인하십시오.

토폴로지 결정이 영향을 주는 것과 주지 않는 것

흔히 혼동되는 부분은 토폴로지와 API 사용 가능 여부의 관계입니다. 직접 방식이든 간접 방식이든 토폴로지 선택은 사용할 수 있는 API 기능에 영향을 주지 않습니다. API 기능 집합은 전적으로 통신 방식에 의해 결정됩니다.

토폴로지가 영향을 주는 것은 Gateway와 로컬 환경 사이의 네트워크 연결이 어떻게 설정되는지입니다. 직접 토폴로지는 현장에 공인 IP와 포트 포워딩이 필요합니다. 간접 토폴로지는 로컬 머신에 Hybrid Connector가 설치되어 있어야 합니다. 사용할 수 있는 API 기능은 Direct Device SDK와 Indirect Device SDK에서 동일하며, Direct DB Pull과 Indirect DB Pull에서도 동일합니다.

“통신 방식은 연동에 필요한 API 기능에 따라 선택하십시오. 토폴로지는 네트워크 환경이 지원하는 범위에 따라 선택하십시오. 이 두 가지는 서로 독립적인 결정입니다.”

자주 묻는 질문

DB Pull 또는 File Processing을 RESTful API 명령과 함께 사용할 수 있습니까?
아니요. DB Pull과 File Processing은 읽기 전용 연동 방식입니다. Gateway가 장치 자체 소프트웨어가 생성한 출석 데이터를 관찰할 수 있게 해 주지만, 장치로 명령을 다시 보낼 수 있는 채널을 설정하지는 않습니다. 사용자 추가, 기록 삭제, 로그 적재와 같은 RESTful API 작업은 양방향 통신 채널을 만드는 Device SDK 모드가 필요합니다.
Hybrid Connector를 장치 소프트웨어와 같은 머신에 설치해야 합니까?
예. Hybrid Connector는 장치가 연결되어 있거나 장치 관리 소프트웨어가 실행되는 동일한 로컬 컴퓨터에 설치되어야 합니다. 이는 통신 방식에 따라 장치, 로컬 데이터베이스 또는 출석 파일에 로컬로 접근해야 하기 때문입니다. 이후 Connector가 Gateway로 향하는 아웃바운드 터널을 생성하므로, 해당 위치에 공인 IP가 필요하지 않습니다.
Native Push와 Hybrid Push의 지연 시간 차이는 무엇입니까?
Native Push의 경우 Callback API 이벤트는 지연 없이 전달되며 RESTful API 명령은 약 30초 내에 실행됩니다. Device SDK를 사용하는 Hybrid Push의 경우 지연 시간은 SDK 자체의 통신 주기에 따라 달라지며 장치 제조사마다 다릅니다. DB Pull과 File Processing의 지연 시간은 로컬 소프트웨어가 새 기록을 기록하는 빈도와 Gateway가 변경 사항을 감지하는 속도에 따라 달라지며, 일반적으로 장치가 이벤트를 기록한 후 몇 초 이내입니다.

결론: 모드를 제약 조건에 맞추십시오

Cams Biometric Gateway의 연결 모드 결정은 선호도의 문제가 아니라 제약 조건의 문제입니다. 장치가 자격을 갖추고 있다면 Native Push가 올바른 선택입니다. 최소한의 구성으로 가장 많은 기능을 제공하기 때문입니다. 그 외의 경우에는 Hybrid Push가 답이며, 그 안에서 Device SDK 모드는 API 액세스 측면에서 Native Push에 가장 가까운 기능을 제공합니다.

전체 SDK 액세스가 불가능한 경우, DB Pull과 File Processing은 여전히 출석 데이터를 시스템에 실시간으로 전달하는 실용적인 경로입니다. 이 경우 토폴로지 결정은 API가 수행할 수 있는 기능을 바꾸지 않는, 인프라 수준의 별도 선택입니다.

의사결정 트리로 시작하고, 기능 매트릭스로 선택 사항을 확인하고, 사용 중인 하드웨어로 테스트하며, 프로덕션 환경으로 전환하기 전에 예외 상황을 Cams 지원팀과 함께 확인하십시오.

Was this article helpful?