Support Hub/API & Integrations/Mode Native Push vs. Hybrid: Pohon Keputusan Teknis
Translated from the English article and reviewed by a person. Read the English original
Developer

Mode Native Push vs. Hybrid: Pohon Keputusan Teknis

Mode Native Push vs. Hybrid: Pohon Keputusan Teknis

Setiap perangkat biometrik yang terhubung ke Cams Biometric Gateway melakukannya melalui salah satu dari dua mode push. Mode yang digunakan perangkat Anda menentukan API mana yang tersedia, bagaimana event dikirimkan, dan bagaimana infrastruktur Anda perlu dikonfigurasi. Panduan ini membahas setiap variabel dalam keputusan tersebut, mulai dari jenis perangkat, metode komunikasi, hingga topologi penerapan, sehingga Anda dapat memilih jalur yang tepat sebelum mulai membangun sistem.

Pertanyaan Pertama: Jenis Perangkat Apa yang Akan Anda Hubungkan?

Sebelum memilih metode komunikasi atau topologi penerapan, ada pertanyaan yang lebih mendasar yang perlu dijawab: apakah perangkat Anda merupakan perangkat Cams Biometrics, atau perangkat yang telah diverifikasi di portal pengembang Cams?

Jawaban atas pertanyaan ini sepenuhnya menentukan mode push Anda. Jika jawabannya ya, Anda menggunakan Native Push dan tidak diperlukan keputusan lebih lanjut. Jika jawabannya tidak, Anda berada dalam ranah Hybrid Push, dan serangkaian keputusan tambahan akan mengikuti.

Mode 1
Native Push
Untuk semua mesin Cams Biometrics dan perangkat apa pun yang tercantum sebagai terverifikasi di developer.camsbiometrics.com. Perangkat berkomunikasi langsung dengan Biometric Gateway melalui internet tanpa memerlukan penyiapan tambahan.

Semua 38 operasi
Callback API penuh
RESTful API penuh

Mode 2
Hybrid Push
Untuk semua perangkat lain yang belum terverifikasi. Anda memilih metode komunikasi dan topologi penerapan yang sesuai dengan lingkungan Anda. Ketersediaan API bergantung pada kombinasi yang Anda pilih.

3 metode komunikasi
2 opsi topologi
Akses API bervariasi

Native Push: gambaran lengkap

Perangkat Native Push mendapatkan akses penuh ke semua 38 operasi Gateway tanpa konfigurasi apa pun selain menghubungkan perangkat ke internet. Callback API mengirimkan event tanpa latensi. Perintah RESTful API dieksekusi dalam waktu sekitar 15 detik. Tidak diperlukan SDK, perangkat lunak lokal, maupun keputusan topologi.

Memahami Hybrid Push: Tiga Metode Komunikasi

Jika perangkat Anda bukan perangkat Cams atau perangkat terverifikasi, keputusan berikutnya adalah bagaimana Gateway akan benar-benar berkomunikasi dengan perangkat keras Anda. Ada tiga metode komunikasi yang tersedia, dan masing-masing memiliki persyaratan berbeda serta implikasi yang berbeda terhadap fitur API yang dapat Anda gunakan.

Metode komunikasi tidak berkaitan dengan konfigurasi jaringan Anda. Metode ini berkaitan dengan mekanisme teknis yang digunakan Gateway untuk membaca data dari perangkat spesifik Anda dan mengirimkan perintah kepadanya. Pilihan ini dibatasi oleh apa yang didukung perangkat keras Anda.

a
Device SDK
Pilihan terbaik untuk akses API penuh
Gateway berkomunikasi dengan perangkat keras menggunakan SDK dari produsen perangkat. SDK menangani protokol perangkat tingkat rendah, dan Gateway menyediakan semua fitur yang didukung SDK melalui API-nya. Ini adalah satu-satunya metode komunikasi dalam Hybrid Push yang memungkinkan operasi RESTful API.
Callback API penuh + RESTful API penuh (dalam batas kemampuan SDK)
b
DB Pull
Hanya data kehadiran
Gateway membaca dari basis data lokal tempat perangkat lunak manajemen perangkat menuliskan catatan kehadiran. Gateway memantau basis data ini dan mengirimkan catatan baru ke URL callback Anda secara real time. Tidak ada komunikasi langsung dengan perangkat, sehingga tidak ada perintah yang dapat dikirim ke perangkat. Operasi seperti menambahkan pengguna, menghapus catatan, atau memuat log tidak tersedia.
Callback API: hanya catatan kehadiran dan log absensi. RESTful API: tidak didukung.
c
File Processing
Hanya data kehadiran
Sebuah file kehadiran tertentu di komputer lokal diawasi secara terus-menerus. Setiap kali perangkat lunak perangkat memperbarui file ini dengan catatan kehadiran baru, Gateway mendeteksi perubahan tersebut, mengekstrak catatan baru, dan mengirimkannya ke URL callback Anda secara real time. Seperti DB Pull, metode ini bersifat hanya-baca dari sisi perangkat dan memiliki batasan API yang sama.
Callback API: hanya catatan kehadiran dan log absensi. RESTful API: tidak didukung.
Cara memilih metode komunikasi

Jika perangkat Anda memiliki SDK produsen yang didukung oleh Cams Gateway, pilih Device SDK (a). Ini adalah satu-satunya metode yang membuka operasi RESTful API untuk perangkat Hybrid Push. Jika SDK tidak didukung atau tidak tersedia, DB Pull (b) atau File Processing (c) tetap dapat mengirimkan data kehadiran ke endpoint callback Anda secara real time, yang sudah memadai untuk banyak kasus penggunaan.

Memahami Hybrid Push: Dua Topologi Penerapan

Setelah Anda memilih metode komunikasi, keputusan kedua adalah di mana Gateway terhubung ke perangkat, basis data, atau file Anda. Ini adalah keputusan topologi, dan bergantung pada lingkungan jaringan Anda di lokasi fisik perangkat.

Topologi X

Langsung
Komputer lokasi tempat perangkat terhubung, atau tempat perangkat lunak manajemen perangkat berjalan, memiliki alamat IP publik dengan port forwarding yang dikonfigurasi ke jaringan lokal. Biometric Gateway terhubung langsung ke perangkat, basis data, atau file melalui internet.
Diperlukan: IP publik + port forwarding di lokasi
Topologi Y

Tidak Langsung
Aplikasi Hybrid Connector dipasang di komputer lokasi. Aplikasi ini berfungsi sebagai jembatan keluar antara mesin lokal dan Biometric Gateway, membangun koneksi dari dalam dan bukan memerlukan koneksi masuk. Tidak diperlukan IP publik di sisi pelanggan.
Diperlukan: Hybrid Connector terpasang di komputer lokal. Tidak perlu IP publik.
Rekomendasi topologi

Jika Anda tidak dapat mengonfigurasi IP publik atau port forwarding di lokasi, pilih topologi Tidak Langsung (Y) dengan Hybrid Connector. Ini adalah jalur penerapan yang paling sederhana dan sepenuhnya menghindari konfigurasi jaringan di sisi pelanggan. Jika IP publik tersedia dan telah dikonfigurasi, topologi Langsung (X) juga dapat digunakan dan tidak memerlukan instalasi perangkat lunak tambahan di lokasi.

Pohon Keputusan: Mode Mana yang Sebaiknya Anda Pilih?

Telusuri pohon keputusan ini dari atas ke bawah. Berhenti pada jawaban pertama yang sesuai dengan situasi Anda.

Pohon keputusan, mulai dari atas
1. Apakah perangkat Anda merupakan perangkat Cams Biometrics, atau tercantum sebagai terverifikasi di developer.camsbiometrics.com?
Ya Gunakan Native Push. Akses API penuh. Tidak diperlukan keputusan lebih lanjut.
Tidak Lanjut ke pertanyaan 2.
2. Apakah Cams Gateway mendukung SDK untuk produsen perangkat Anda?
Ya Gunakan Hybrid Push, Device SDK (a). Callback dan RESTful API penuh dalam batas SDK. Lanjut ke pertanyaan 3 untuk topologi.
Tidak Lanjut ke pertanyaan 2b.
2b. Apakah perangkat lunak manajemen perangkat Anda menuliskan catatan kehadiran ke basis data lokal?
Ya Gunakan Hybrid Push, DB Pull (b). Hanya Callback kehadiran. Lanjut ke pertanyaan 3 untuk topologi.
3. Apakah komputer lokasi memiliki alamat IP publik dengan port forwarding yang tersedia?
Ya Gunakan Topologi Langsung (X). Tidak diperlukan perangkat lunak tambahan di lokasi.
Tidak Gunakan Topologi Tidak Langsung (Y). Pasang Hybrid Connector di komputer lokasi.

Matriks Ketersediaan Fitur Hybrid Push

Tabel di bawah ini menunjukkan setiap kombinasi metode komunikasi dan topologi penerapan, serta fitur API yang tersedia di setiap kasus. Gunakan tabel ini bersama pohon keputusan untuk memastikan apa yang didukung oleh konfigurasi yang Anda pilih.

Mode Komunikasi Topologi Callback API RESTful API
Perangkat Langsung (a) Device SDK (X) IP Publik Penuh Penuh (berlaku batasan SDK)
Perangkat Tidak Langsung (a) Device SDK (Y) Hybrid Connector Penuh Penuh (berlaku batasan SDK)
DB Langsung (b) DB Pull (X) IP Publik Hanya kehadiran Tidak didukung
DB Tidak Langsung (b) DB Pull (Y) Hybrid Connector Hanya kehadiran Tidak didukung
File Langsung (c) File Processing (X) IP Publik Hanya kehadiran Tidak didukung
File Tidak Langsung (c) File Processing (Y) Hybrid Connector Hanya kehadiran Tidak didukung
Catatan penting tentang perangkat keras

Keterbatasan perangkat keras dapat membatasi fitur API lebih lanjut, bahkan dalam mode Device SDK. API tertentu mungkin tidak berfungsi tergantung pada versi firmware model perangkat atau kemampuan yang disediakan oleh SDK produsen. Matriks di atas menggambarkan apa yang didukung oleh arsitektur Gateway, bukan apa yang dijamin didukung oleh setiap model perangkat. Selalu lakukan pengujian dengan perangkat keras Anda dan verifikasi kasus khusus dengan tim dukungan Cams sebelum penerapan produksi.

Apa yang Dipengaruhi dan Tidak Dipengaruhi oleh Keputusan Topologi

Kebingungan yang umum terjadi adalah hubungan antara topologi dan ketersediaan API. Pilihan topologi, baik Langsung maupun Tidak Langsung, tidak memengaruhi fitur API mana yang tersedia. Kumpulan fitur API sepenuhnya ditentukan oleh metode komunikasi.

Yang dipengaruhi oleh topologi adalah cara koneksi jaringan antara Gateway dan lingkungan lokal Anda dibangun. Topologi Langsung memerlukan IP publik dan port forwarding di lokasi. Topologi Tidak Langsung memerlukan Hybrid Connector yang terpasang di mesin lokal. Fitur API yang tersedia bagi Anda identik untuk Device SDK Langsung dan Device SDK Tidak Langsung, serta identik untuk DB Pull Langsung dan DB Pull Tidak Langsung.

“Pilih metode komunikasi berdasarkan fitur API yang dibutuhkan integrasi Anda. Pilih topologi berdasarkan apa yang didukung lingkungan jaringan Anda. Ini adalah dua keputusan yang independen.”

Pertanyaan yang Sering Diajukan

Apakah saya dapat menggunakan DB Pull atau File Processing bersamaan dengan perintah RESTful API?
Tidak. DB Pull dan File Processing adalah metode integrasi yang bersifat hanya-baca. Keduanya memungkinkan Gateway mengamati data kehadiran yang dihasilkan oleh perangkat lunak perangkat itu sendiri, tetapi tidak membangun saluran yang dapat digunakan untuk mengirim perintah kembali ke perangkat. Operasi RESTful API seperti menambahkan pengguna, menghapus catatan, atau memuat log memerlukan mode Device SDK, yang membentuk saluran komunikasi dua arah.
Apakah Hybrid Connector perlu dipasang di mesin yang sama dengan perangkat lunak perangkat?
Ya. Hybrid Connector harus dipasang di komputer lokal yang sama tempat perangkat terhubung atau tempat perangkat lunak manajemen perangkat berjalan. Hal ini karena Connector memerlukan akses lokal ke perangkat, basis data lokal, atau file kehadiran, bergantung pada metode komunikasi Anda. Connector kemudian membuat terowongan keluar ke Gateway, sehingga tidak diperlukan IP publik di lokasi tersebut.
Berapa perbedaan latensi antara Native Push dan Hybrid Push?
Untuk Native Push, event Callback API dikirimkan tanpa latensi dan perintah RESTful API dieksekusi dalam waktu sekitar 30 detik. Untuk Hybrid Push menggunakan Device SDK, latensi bergantung pada siklus komunikasi SDK itu sendiri dan bervariasi tergantung produsen perangkat. Latensi DB Pull dan File Processing bergantung pada seberapa sering perangkat lunak lokal menulis catatan baru dan seberapa cepat Gateway mendeteksi perubahan tersebut, biasanya dalam beberapa detik setelah perangkat mencatat event.

Kesimpulan: Sesuaikan Mode Anda dengan Batasan Anda

Keputusan mode koneksi untuk Cams Biometric Gateway bukanlah soal preferensi. Ini adalah soal batasan. Native Push adalah jawaban yang tepat jika perangkat Anda memenuhi syarat, karena memberikan kemampuan paling besar dengan konfigurasi paling sedikit. Hybrid Push adalah jawaban untuk semua kondisi lainnya, dan di dalamnya, mode Device SDK memberikan kesetaraan terdekat dengan Native Push dalam hal akses API.

Ketika akses SDK penuh tidak tersedia, DB Pull dan File Processing merupakan jalur praktis yang tetap dapat mengirimkan data kehadiran secara real time ke sistem Anda. Keputusan topologi kemudian menjadi pilihan terpisah di tingkat infrastruktur yang tidak mengubah apa yang dapat dilakukan API.

Mulailah dengan pohon keputusan, pastikan pilihan Anda sesuai dengan matriks fitur, uji dengan perangkat keras Anda, dan verifikasi kasus khusus dengan tim dukungan Cams sebelum masuk ke tahap produksi.

Was this article helpful?