API autentikasi wajah untuk aplikasi web

Integrasikan autentikasi wajah FACEIO dengan fio.js. Buat aplikasi di Console, muat widget, lalu panggil enroll() dan authenticate(), lalu petakan Facial ID yang dikembalikan ke logika sesi backend Anda.

BUKA FACEIO Console

Hubungkan ke FACEIO Console untuk membuat aplikasi, mengelola API, dan mengonfigurasi webhook untuk peristiwa pendaftaran, autentikasi, dan Facial ID.

Mengapa Tim Memilih FACEIO daripada Membangun Sendiri

Tambahkan autentikasi wajah tanpa membangun sendiri infrastruktur kamera, pemeriksaan liveness, atau pencocokan dari awal.

Membangun autentikasi wajah dari awal berarti menangani pemeriksaan liveness, anti-spoofing, perilaku mesin pengenalan, kualitas pencocokan, dan pengambilan kamera lintas browser sebelum merilis alur produk yang sebenarnya. Ini adalah pekerjaan infrastruktur dengan konsekuensi keamanan dan privasi.

FACEIO mengemas lapisan tersebut dalam API terkelola dan SDK browser. Aplikasi Anda menerima Facial ID dan hasil autentikasi, sementara backend bertanggung jawab atas pemetaan pengguna, pembuatan sesi, otorisasi, dan kebijakan pemulihan akun. Tim sering memasangkannya dengan layanan autentikasi wajah terkelola untuk rollout yang lebih cepat.

Membangun Sendiri

  • Berbulan-bulan waktu pengembangan
  • Evaluasi dan penyetelan mesin pengenalan
  • Pemeliharaan berkelanjutan untuk perbedaan perilaku browser
  • Pekerjaan terkait persetujuan, retensi, penghapusan, dan kebijakan regional

Menggunakan API FACEIO

  • Integrasi SDK browser yang ringkas
  • Pemeriksaan liveness termasuk dalam alur pengambilan
  • SDK menangani kamera dan kompatibilitas lintas perangkat
  • Pemetaan Facial ID dan payload yang sesuai untuk backend

Intinya: FACEIO menangani pengambilan di browser dan alur autentikasi wajah, sementara aplikasi Anda mengelola logika sesi dan otorisasi. Untuk gambaran arsitektur yang lebih luas, lihat autentikasi biometrik untuk aplikasi web.

Kemampuan Inti API

API FACEIO dan fio.js SDK menyediakan dua metode inti yang mencakup seluruh siklus autentikasi. Untuk kontrol tingkat endpoint, lihat referensi REST API.

  • enroll()

    Memulai alur pendaftaran di widget FACEIO. Setelah persetujuan eksplisit pengguna, mesin pengenalan wajah yang dikonfigurasi membuat hash biometrik yang tidak dapat dibalik atau entri indeks aplikasi, lalu FACEIO mengembalikan Facial ID. Backend Anda menyimpan Facial ID tersebut pada data pengguna.

  • authenticate()

    Memulai alur autentikasi, memeriksa liveness, dan mengembalikan Facial ID beserta payload terkait setelah pencocokan berhasil. Backend Anda kemudian dapat memvalidasi hasil dan membuat sesi, termasuk alur login tanpa kata sandi yang dijelaskan dalam Login biometrik untuk aplikasi web.

Payload dan Penanganan Sesi

Anda dapat melampirkan payload yang ditentukan developer (misalnya, { user_id: "abc123" }) saat pendaftaran. Payload yang sama dikembalikan setelah autentikasi berhasil, sehingga Anda dapat memetakan peristiwa autentikasi ke data pengguna internal tanpa pencarian tambahan, lalu mengirimkan peristiwa audit lanjutan melalui webhook.

Mengintegrasikan API autentikasi wajah dalam Empat Langkah

Integrasi frontend sengaja dibuat ringkas. Widget SDK menangani izin kamera, UI pengambilan, dan pemeriksaan liveness secara langsung, sehingga aplikasi Anda tidak perlu menerapkan lapisan tersebut sendiri.

// Langkah 1 - sematkan SDK di halaman Anda
<script src="https://cdn.faceio.net/fio.js"></script>

// Langkah 2 - inisialisasi dengan App ID publik Anda
const faceio = new faceIO('YOUR_APP_ID');

// Langkah 3 - daftarkan pengguna baru
faceio.enroll({ locale: 'auto', payload: { userId: 'abc123' } });

// Langkah 4 - autentikasi saat kunjungan berikutnya
faceio.authenticate({ locale: 'auto' })
  .then((data) => sendToBackend(data.facialId, data.payload))
  .catch((err) => handleError(err));

Setelah pemanggilan authenticate() , kirimkan facialId dan payload ke server Anda untuk membuat sesi tepercaya. Untuk panduan lengkap, lihat panduan integrasi, dokumentasi webhook, dan praktik keamanan terbaik.

Keamanan & Deteksi Liveness Bawaan

API FACEIO menerapkan lapisan keamanan lengkap pada setiap peristiwa autentikasi. Kontrol ini aktif secara default tanpa konfigurasi tambahan. Untuk detail postur platform, lihat Pusat Kepercayaan.

  • Liveness dan Anti-Spoofing

    Setiap pengambilan diperiksa untuk memastikan kehadiran manusia secara langsung dan dirancang untuk menolak serangan presentasi umum, termasuk foto, gambar cetak, video yang direkam sebelumnya, replay layar, media sintetis, dan upaya menggunakan topeng.

  • Validasi Kunci API Privat

    Backend Anda memvalidasi peristiwa autentikasi menggunakan kunci REST API privat. Simpan kunci tersebut di server agar respons frontend yang dipalsukan atau diputar ulang tidak dianggap sebagai sesi yang valid.

  • Facial ID Terlingkup Aplikasi

    Setiap App ID terisolasi. Facial ID, payload, dan indeks mesin pengenalan dibatasi pada aplikasi, sementara pembatasan laju tingkat platform membantu mengurangi upaya brute-force.

Praktik terbaik: Jangan paparkan kunci API privat di kode sisi klien. Simpan validasi sesi dan pemetaan Facial ID di server Anda. Lihat Praktik Keamanan Terbaik dan Praktik Privasi Terbaik untuk panduan implementasi.

Memilih Pola Implementasi

Sebagian besar integrasi FACEIO menggunakan salah satu dari dua pola, tergantung kebutuhan kepercayaan dan kepatuhan:

Pola Frontend Saja

Cocok untuk alur berisiko lebih rendah dan prototipe. enroll() dan authenticate() dijalankan di browser, dan Facial ID yang dikembalikan digunakan langsung untuk mengidentifikasi pengguna dan memulai sesi sisi klien.

Cepat dirilis, tetapi kepercayaan sesi tetap berada di sisi klien.

Verifikasi Frontend + Backend Direkomendasikan

Setelah authenticate() mengembalikan Facial ID di frontend, aplikasi Anda mengirimkannya ke backend melalui panggilan API terautentikasi. Server memvalidasi hasil dengan kunci privat Anda, menemukan pengguna melalui pemetaan payload, dan menerbitkan token sesi bertanda tangan. Pola ini sesuai dengan deployment autentikasi tanpa kata sandi.

  • Menjaga batas kepercayaan di sisi server
  • Mendukung pencatatan audit melalui webhook
  • Mengaktifkan verifikasi step-up untuk operasi sensitif (lihat pola login biometrik)

Kesimpulan

FACEIO menyediakan alur pengambilan gambar dan autentikasi wajah di browser tanpa mengharuskan Anda membangun stack pengenalan sendiri. Integrasi standar menggunakan satu tag script, metode SDK enroll() dan authenticate(), serta validasi hasil di backend. Lanjutkan dengan Mulai dan Panduan Integrasi.

Panduan Terkait

Sumber daya implementasi

Bangun dengan API Autentikasi Wajah

Gunakan sumber daya API FACEIO untuk membuat aplikasi, mengintegrasikan SDK JavaScript, memvalidasi hasil autentikasi di sisi server, dan mengarahkan peristiwa autentikasi tepercaya ke sistem backend Anda.

Mulai Buat aplikasi FACEIO dan siapkan App ID untuk integrasi klien. Panduan Integrasi Hubungkan pemanggilan enroll dan authenticate ke aplikasi web Anda. Pusat developer Pelajari validasi API, pemetaan sesi, dan pola keamanan. Webhook Kirim peristiwa autentikasi ke pipeline audit, peringatan, dan risiko. FACEIO Console Buat aplikasi, kelola pengaturan API, dan mulai menguji autentikasi.

Hubungkan FACEIO ke Alur Login Anda

Buat aplikasi FACEIO, salin App ID publik, muat fio.js, lalu hubungkan hasil pendaftaran dan autentikasi ke alur sesi backend Anda.

Buka FACEIO Console → Panduan Integrasi
Penyiapan App ID Publik
SDK lintas framework
Validasi sisi server