Panduan Referensi Facial ID

FACEIO menyediakan Facial ID melalui Promise yang diselesaikan dan dikembalikan oleh metode sisi klien fio.js . Objek lengkapnya berisi lebih banyak field, tetapi nilai penting untuk menghubungkan akun adalah facialId.

Jika Anda mengirimkan payload saat enroll(), FACEIO dapat mengembalikan payload tersebut pada autentikasi berikutnya. Batasi payload pada nilai yang dibutuhkan aplikasi dan jangan gunakan data payload sisi klien sebagai satu-satunya pemeriksaan otorisasi.

1. 1. Buat aplikasi FACEIO. Gunakan panduan Mulai dan FACEIO Console ↗ untuk mengonfigurasi aplikasi, pengaturan widget, dan opsi keamanan.
2. 2. Daftarkan pengguna. Ikuti Panduan Integrasi, lalu panggil enroll() setelah pengguna memilih mengaktifkan autentikasi wajah dan memberikan izin browser yang diperlukan.
3. 3. Simpan facialId. Simpan di backend jika perlu memetakan autentikasi FACEIO ke model akun lokal.
4. 4. Autentikasi pengguna yang kembali. Panggil authenticate() dan bandingkan facialId dengan akun atau sesi yang diharapkan aplikasi Anda.
5. 5. Sinkronkan backend. Gunakan webhooks saat peristiwa pendaftaran, autentikasi, atau penghapusan Facial ID perlu memperbarui status akun, log audit, atau kontrol risiko.
6. 6. Hapus bila diperlukan. Gunakan /deletefacialid saat pengguna mencabut persetujuan, menghapus akun, menonaktifkan login biometrik, atau meminta penghapusan.

Mesin pengenalan wajah yang dipilih memetakan wajah pengguna terdaftar menjadi vektor fitur matematis untuk pencocokan berikutnya. FACEIO mengembalikan Facial ID agar aplikasi Anda dapat merujuk pada data pendaftaran dalam alur akun sendiri.

FACEIO sendiri, termasuk fio.js, widget tertanam, REST API, dan Console, tidak menyimpan, menangani, atau memiliki akses ke hash biometrik. Mesin pengenalan wajah yang dipilih pemilik aplikasi mengelola hash tersebut sesuai pilihan mesin, wilayah, alur persetujuan, dan kebijakan penghapusan.

Gunakan FACEIO Console ↗ untuk membuat aplikasi pengujian dan memvalidasi mesin serta pengaturan keamanan yang sesuai dengan pengalaman pengguna, alur akun, dan persyaratan deployment.

Vektor wajah, yang juga disebut hash biometrik, berupa array nilai floating-point yang dihasilkan mesin pengenalan terpilih saat pendaftaran. FACEIO tidak mengekspos hash biometrik tersebut ke aplikasi Anda melalui fio.js; aplikasi Anda menerima Facial ID dan field respons terkait.

Jangan perlakukan Facial ID sebagai pengenal profil publik atau mengeksposnya di log browser, peristiwa analitik, forum dukungan publik, atau URL. Jika menyimpannya secara lokal, simpan di sisi server dengan perlindungan yang sama seperti data akun terkait autentikasi.

Untuk merencanakan privasi, gabungkan referensi ini dengan Praktik Privasi Terbaik, Praktik keamanan terbaik, dan Pusat Kepercayaan.

• Simpan bersama data akun. Simpan facialId di backend Anda saat perlu menghubungkan FACEIO ke data pengguna lokal.
• Lakukan Pemeriksaan Sisi Server. Gunakan Facial ID yang dikembalikan sebagai input logika otorisasi, bukan sebagai pemberian sesi mandiri.
• Jaga payload tetap minimal. Jika Anda melampirkan payload saat pendaftaran, sertakan hanya data yang benar-benar dibutuhkan alur autentikasi Anda.
• Sinkronkan dengan webhook. Gunakan peristiwa webhook saat perubahan status pendaftaran atau penghapusan harus diteruskan ke backend Anda.
• Sediakan Kontrol Pengguna. Berikan pengguna terdaftar jalur untuk menonaktifkan login biometrik atau meminta penghapusan Facial ID.
• Dokumentasikan Retensi. Tentukan kapan Facial ID disimpan, dihapus, atau dilepas tautannya dalam produk dan pemberitahuan privasi Anda.

Penghapusan Facial ID dilakukan melalui endpoint /deletefacialid pada REST API FACEIO. Kirim Facial ID yang ingin dihapus dari aplikasi tujuan menggunakan format permintaan yang didokumentasikan dalam referensi REST API.

Setelah berhasil dihapus, Facial ID terdaftar tersebut tidak dapat lagi digunakan untuk mengautentikasi pengguna. Jika pengguna yang sama mendaftar lagi, FACEIO membuat data pendaftaran baru dan mengembalikan Facial ID baru.