Support Hub/API & Integrations/Chế độ Native Push so với Hybrid: Cây quyết định kỹ thuật
Translated from the English article and reviewed by a person. Read the English original
Developer

Chế độ Native Push so với Hybrid: Cây quyết định kỹ thuật

Chế độ Native Push so với Hybrid: Cây quyết định kỹ thuật

Mọi thiết bị sinh trắc học kết nối với Cams Biometric Gateway đều thực hiện việc này thông qua một trong hai chế độ push. Chế độ mà thiết bị của bạn sử dụng sẽ quyết định những API nào khả dụng, cách các sự kiện được gửi đi và hạ tầng của bạn cần được cấu hình như thế nào. Hướng dẫn này trình bày từng yếu tố trong quyết định, từ loại thiết bị, phương thức giao tiếp đến cấu trúc triển khai, để bạn chọn đúng hướng đi trước khi bắt đầu xây dựng.

Câu hỏi đầu tiên: Bạn đang kết nối loại thiết bị nào?

Trước khi chọn phương thức giao tiếp hoặc cấu trúc triển khai, có một câu hỏi cơ bản hơn cần trả lời: thiết bị của bạn là thiết bị Cams Biometrics, hay là thiết bị đã được xác minh trên cổng nhà phát triển Cams?

Câu trả lời cho câu hỏi này hoàn toàn quyết định chế độ push của bạn. Nếu câu trả lời là có, bạn sử dụng Native Push và không cần đưa ra thêm quyết định nào. Nếu câu trả lời là không, bạn thuộc phạm vi Hybrid Push, và một loạt quyết định bổ sung sẽ tiếp theo.

Mode 1
Native Push
Dành cho tất cả máy Cams Biometrics và mọi thiết bị được liệt kê là đã xác minh tại developer.camsbiometrics.com. Thiết bị giao tiếp trực tiếp với Biometric Gateway qua internet mà không cần thiết lập bổ sung.

All 38 operations
Full Callback API
Full RESTful API

Mode 2
Hybrid Push
Dành cho tất cả các thiết bị chưa được xác minh khác. Bạn chọn phương thức giao tiếp và cấu trúc triển khai phù hợp với môi trường của mình. Khả năng sử dụng API phụ thuộc vào sự kết hợp mà bạn chọn.

3 communication methods
2 topology options
Variable API access

Native Push: bức tranh toàn cảnh

Thiết bị Native Push được truy cập đầy đủ tất cả 38 thao tác của Gateway mà không cần cấu hình gì thêm ngoài việc kết nối thiết bị với internet. Callback API gửi sự kiện với độ trễ bằng không. Lệnh RESTful API thực thi trong khoảng 15 giây. Không cần SDK, không cần phần mềm cục bộ, cũng không cần quyết định về cấu trúc triển khai.

Tìm hiểu Hybrid Push: Ba phương thức giao tiếp

Nếu thiết bị của bạn không phải là thiết bị Cams hoặc thiết bị đã xác minh, quyết định tiếp theo là cách Gateway thực sự giao tiếp với phần cứng của bạn. Có ba phương thức giao tiếp, mỗi phương thức có yêu cầu khác nhau và ảnh hưởng khác nhau đến các tính năng API bạn có thể sử dụng.

Phương thức giao tiếp không liên quan đến cấu hình mạng của bạn. Nó liên quan đến cơ chế kỹ thuật mà Gateway sử dụng để đọc dữ liệu từ thiết bị cụ thể của bạn và gửi lệnh đến thiết bị đó. Lựa chọn này bị giới hạn bởi những gì phần cứng của bạn hỗ trợ.

a
Device SDK
Lựa chọn tốt nhất để truy cập đầy đủ API
Gateway giao tiếp với phần cứng thông qua SDK của nhà sản xuất thiết bị. SDK xử lý giao thức thiết bị ở mức thấp, còn Gateway cung cấp tất cả các tính năng mà SDK hỗ trợ thông qua API của mình. Đây là phương thức giao tiếp duy nhất trong Hybrid Push cho phép thực hiện các thao tác RESTful API.
Full Callback API + Full RESTful API (trong giới hạn của SDK)
b
DB Pull
Chỉ dữ liệu chấm công
Gateway đọc từ một cơ sở dữ liệu cục bộ mà phần mềm quản lý riêng của thiết bị ghi các bản ghi chấm công vào. Gateway theo dõi cơ sở dữ liệu này và đẩy các bản ghi mới đến callback URL của bạn theo thời gian thực. Không có giao tiếp trực tiếp với thiết bị, nghĩa là không thể gửi lệnh đến thiết bị. Các thao tác như thêm người dùng, xóa bản ghi hoặc tải nhật ký không khả dụng.
Callback API: chỉ chấm công và nhật ký ra vào. RESTful API: không hỗ trợ.
c
File Processing
Chỉ dữ liệu chấm công
Một tệp chấm công được chỉ định trên máy tính cục bộ được giám sát liên tục. Mỗi khi phần mềm thiết bị cập nhật tệp này với các bản ghi chấm công mới, Gateway phát hiện thay đổi, trích xuất các bản ghi mới và đẩy chúng đến callback URL của bạn theo thời gian thực. Giống như DB Pull, phương thức này chỉ đọc từ góc nhìn của thiết bị và có cùng những hạn chế về API.
Callback API: chỉ chấm công và nhật ký ra vào. RESTful API: không hỗ trợ.
Cách chọn phương thức giao tiếp

Nếu thiết bị của bạn có SDK của nhà sản xuất được Cams Gateway hỗ trợ, hãy chọn Device SDK (a). Đây là phương thức duy nhất mở khóa các thao tác RESTful API cho thiết bị Hybrid Push. Nếu SDK không được hỗ trợ hoặc không có sẵn, DB Pull (b) hoặc File Processing (c) vẫn sẽ gửi dữ liệu chấm công đến endpoint callback của bạn theo thời gian thực, đủ cho nhiều trường hợp sử dụng.

Tìm hiểu Hybrid Push: Hai cấu trúc triển khai

Sau khi đã chọn phương thức giao tiếp, quyết định thứ hai là nơi Gateway kết nối đến thiết bị, cơ sở dữ liệu hoặc tệp của bạn. Đây là quyết định về cấu trúc triển khai, và nó phụ thuộc vào môi trường mạng tại vị trí vật lý của thiết bị.

Topology X

Trực tiếp (Direct)
Máy tính tại địa điểm nơi thiết bị được kết nối, hoặc nơi phần mềm quản lý thiết bị chạy, có địa chỉ IP công cộng với chuyển tiếp cổng (port forwarding) được cấu hình đến mạng cục bộ. Biometric Gateway kết nối trực tiếp đến thiết bị, cơ sở dữ liệu hoặc tệp qua internet.
Yêu cầu: IP công cộng + port forwarding tại địa điểm
Topology Y

Gián tiếp (Indirect)
Ứng dụng Hybrid Connector được cài đặt trên máy tính tại địa điểm. Ứng dụng này đóng vai trò cầu nối gửi đi giữa máy cục bộ và Biometric Gateway, thiết lập kết nối từ bên trong thay vì yêu cầu kết nối đi vào. Không cần IP công cộng ở phía khách hàng.
Yêu cầu: Đã cài Hybrid Connector trên máy tính cục bộ. Không cần IP công cộng.
Khuyến nghị về cấu trúc triển khai

Nếu bạn không thể cấu hình IP công cộng hoặc port forwarding tại địa điểm, hãy chọn cấu trúc gián tiếp (Y) với Hybrid Connector. Đây là hướng triển khai đơn giản nhất và hoàn toàn tránh việc cấu hình mạng ở phía khách hàng. Nếu có sẵn và đã cấu hình IP công cộng, cấu trúc trực tiếp (X) cũng hoạt động và không cần cài đặt thêm phần mềm tại địa điểm.

Cây quyết định: Bạn nên chọn chế độ nào?

Hãy đi theo cây quyết định này từ trên xuống dưới. Dừng lại ở câu trả lời đầu tiên phù hợp với tình huống của bạn.

Cây quyết định, bắt đầu từ trên cùng
1. Thiết bị của bạn có phải là thiết bị Cams Biometrics, hoặc được liệt kê là đã xác minh tại developer.camsbiometrics.com?
Có Sử dụng Native Push. Truy cập đầy đủ API. Không cần quyết định nào thêm.
Không Tiếp tục với câu hỏi 2.
2. Cams Gateway có hỗ trợ SDK cho nhà sản xuất thiết bị của bạn không?
Có Sử dụng Hybrid Push, Device SDK (a). Truy cập đầy đủ Callback và RESTful API trong giới hạn của SDK. Tiếp tục với câu hỏi 3 để chọn cấu trúc triển khai.
Không Tiếp tục với câu hỏi 2b.
2b. Phần mềm quản lý thiết bị của bạn có ghi bản ghi chấm công vào cơ sở dữ liệu cục bộ không?
Có Sử dụng Hybrid Push, DB Pull (b). Chỉ Callback chấm công. Tiếp tục với câu hỏi 3 để chọn cấu trúc triển khai.
3. Máy tính tại địa điểm có địa chỉ IP công cộng và có thể cấu hình port forwarding không?
Có Sử dụng Cấu trúc trực tiếp (X). Không cần phần mềm bổ sung tại địa điểm.
Không Sử dụng Cấu trúc gián tiếp (Y). Cài đặt Hybrid Connector trên máy tính cục bộ tại địa điểm.

Ma trận khả năng sử dụng tính năng Hybrid Push

Bảng dưới đây thể hiện mọi tổ hợp của phương thức giao tiếp và cấu trúc triển khai, cùng với các tính năng API khả dụng trong từng trường hợp. Hãy sử dụng bảng này cùng với cây quyết định để xác nhận những gì cấu hình bạn đã chọn hỗ trợ.

Chế độ Giao tiếp Cấu trúc triển khai Callback API RESTful API
Direct Device (a) Device SDK (X) IP công cộng Đầy đủ Đầy đủ (áp dụng giới hạn SDK)
Indirect Device (a) Device SDK (Y) Hybrid Connector Đầy đủ Đầy đủ (áp dụng giới hạn SDK)
Direct DB (b) DB Pull (X) IP công cộng Chỉ chấm công Không hỗ trợ
Indirect DB (b) DB Pull (Y) Hybrid Connector Chỉ chấm công Không hỗ trợ
Direct File (c) File Processing (X) IP công cộng Chỉ chấm công Không hỗ trợ
Indirect File (c) File Processing (Y) Hybrid Connector Chỉ chấm công Không hỗ trợ
Lưu ý quan trọng về phần cứng

Các hạn chế của phần cứng có thể giới hạn thêm tính năng API ngay cả trong chế độ Device SDK. Một số API cụ thể có thể không hoạt động tùy thuộc vào phiên bản firmware của model thiết bị hoặc các khả năng mà SDK của nhà sản xuất cung cấp. Ma trận trên mô tả những gì kiến trúc Gateway hỗ trợ, chứ không đảm bảo rằng mọi model thiết bị cụ thể đều hỗ trợ đầy đủ. Luôn kiểm thử với phần cứng cụ thể của bạn và xác minh các trường hợp đặc biệt với đội ngũ hỗ trợ Cams trước khi triển khai thực tế.

Quyết định về cấu trúc triển khai ảnh hưởng và không ảnh hưởng đến điều gì

Một điểm dễ gây nhầm lẫn là mối quan hệ giữa cấu trúc triển khai và khả năng sử dụng API. Lựa chọn cấu trúc, trực tiếp (Direct) hay gián tiếp (Indirect), không ảnh hưởng đến các tính năng API khả dụng. Bộ tính năng API hoàn toàn do phương thức giao tiếp quyết định.

Điều mà cấu trúc triển khai ảnh hưởng là cách kết nối mạng giữa Gateway và môi trường cục bộ của bạn được thiết lập. Cấu trúc trực tiếp yêu cầu IP công cộng và port forwarding tại địa điểm. Cấu trúc gián tiếp yêu cầu cài đặt Hybrid Connector trên máy cục bộ. Các tính năng API bạn có thể sử dụng là giống hệt nhau đối với Direct Device SDK và Indirect Device SDK, cũng như giống hệt nhau đối với Direct DB Pull và Indirect DB Pull.

“Chọn phương thức giao tiếp dựa trên các tính năng API mà tích hợp của bạn cần. Chọn cấu trúc triển khai dựa trên những gì môi trường mạng của bạn hỗ trợ. Đây là hai quyết định độc lập với nhau.”

Câu hỏi thường gặp

Tôi có thể sử dụng DB Pull hoặc File Processing cùng với các lệnh RESTful API không?
Không. DB Pull và File Processing là các phương thức tích hợp chỉ đọc. Chúng cho phép Gateway quan sát dữ liệu chấm công do phần mềm của chính thiết bị tạo ra, nhưng không thiết lập kênh nào để gửi lệnh ngược lại thiết bị. Các thao tác RESTful API như thêm người dùng, xóa bản ghi hoặc tải nhật ký yêu cầu chế độ Device SDK, vì chế độ này tạo ra kênh giao tiếp hai chiều.
Hybrid Connector có cần được cài đặt trên cùng máy với phần mềm của thiết bị không?
Có. Hybrid Connector phải được cài đặt trên cùng máy tính cục bộ nơi thiết bị được kết nối hoặc nơi phần mềm quản lý thiết bị đang chạy. Điều này là do nó cần quyền truy cập cục bộ vào thiết bị, cơ sở dữ liệu cục bộ hoặc tệp chấm công, tùy thuộc vào phương thức giao tiếp bạn chọn. Sau đó, Connector tạo một đường hầm gửi đi đến Gateway, do đó không cần IP công cộng tại địa điểm đó.
Sự khác biệt về độ trễ giữa Native Push và Hybrid Push là gì?
Với Native Push, các sự kiện Callback API được gửi với độ trễ bằng không và các lệnh RESTful API thực thi trong khoảng 30 giây. Với Hybrid Push sử dụng Device SDK, độ trễ phụ thuộc vào chu kỳ giao tiếp của chính SDK và thay đổi tùy theo nhà sản xuất thiết bị. Độ trễ của DB Pull và File Processing phụ thuộc vào tần suất phần mềm cục bộ ghi các bản ghi mới và tốc độ Gateway phát hiện thay đổi, thường là trong vòng vài giây kể từ khi thiết bị ghi nhận sự kiện.

Kết luận: Chọn chế độ phù hợp với các ràng buộc của bạn

Quyết định về chế độ kết nối cho Cams Biometric Gateway không phải là câu hỏi về sở thích mà là câu hỏi về các ràng buộc. Native Push là lựa chọn đúng nếu thiết bị của bạn đủ điều kiện, vì nó mang lại nhiều khả năng nhất với cấu hình ít nhất. Hybrid Push là lựa chọn cho mọi trường hợp còn lại, và trong đó, chế độ Device SDK mang lại khả năng truy cập API gần tương đương nhất với Native Push.

Khi không thể truy cập SDK đầy đủ, DB Pull và File Processing là những hướng đi thực tế, vẫn gửi dữ liệu chấm công theo thời gian thực đến hệ thống của bạn. Khi đó, quyết định về cấu trúc triển khai là một lựa chọn riêng ở cấp độ hạ tầng và không làm thay đổi những gì API có thể thực hiện.

Hãy bắt đầu với cây quyết định, đối chiếu lựa chọn của bạn với ma trận tính năng, kiểm thử với phần cứng của bạn và xác minh mọi trường hợp đặc biệt với đội ngũ hỗ trợ Cams trước khi đưa vào sản xuất.

Was this article helpful?