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.
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.
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.
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.
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.
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
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.