Autentikasi Biometrik mengizinkan pengguna untuk mengakses aplikasi dengan aman menggunakan sidik jari, wajah, atau fitur biologis lainnya daripada kata sandi. Untuk pengembang yang bekerja dengan Capacitor, mengimplementasikan fitur ini relatif sederhana dan berfungsi pada baik iOS dan Android. Berikut adalah ringkasan singkat:
-
Mengapa Menggunakan Autentikasi Biometrik?
- Lebih aman daripada kata sandi.
- Meningkatkan pengalaman pengguna dengan membuat proses login lebih cepat.
- Memenuhi standar keamanan untuk data sensitif.
-
Metode yang Dapat Dibantu:
- Sidik Jari: Cepat dan umum.
- Rekognisi Wajah: Opsi tanpa tangan.
- Pemindaian Iris: Kasus keamanan tinggi (perangkat terbatas).
- Pengenalan Suara: Fokus aksesibilitas (dukungan terbatas).
-
Alat Utama yang Diperlukan:
- Capacitor 3.0+.
-
Spotlight Pemasangan:
- Tambahkan izin ke AndroidManifest dan Info.plist.
- Gunakan Keychain (iOS) atau Keystore (Android) untuk penyimpanan yang aman.
- Uji coba secara menyeluruh untuk konsistensi dan opsi fallback.
Perbandingan Cepat Plugin
| Nama Plugin | Capacitor Versi | Fitur-Fitur | Terbaik Untuk |
|---|---|---|---|
@aparajita/capacitor-biometric-auth | Capacitor 8 | Biometrik Asli, Kredensial Perangkat | Proyek Baru Menggunakan Capacitor 8 |
capacitor-native-biometric | Capacitor 3, 4 | Penyimpanan Kredensial yang Aman, Keychain/Keystore | Pengelolaan Kredensial |
| Semua Versi | Dukungan Biometrik dan Kredensial Perangkat | Opsi Autentikasi yang Fleksibel |
Autentikasi Biometrik di Aplikasi Capacitor adalah cara yang aman dan ramah pengguna untuk melindungi data sensitif. Artikel lengkap menjelaskan langkah-langkah pengaturan, code contoh, strategi pengujian, dan standar keamanan.
Autentikasi Biometrik (FaceID / FingerPrint) Ionic
Persyaratan Pengaturan
Untuk mengaktifkan autentikasi biometrik di aplikasi Anda, Anda perlu mengonfigurasi beberapa alat, dependensi, dan pengaturan spesifik platform. Capacitor appSebelum memasuki implementasi, pastikan alat dan dependensi berikut sudah siap:
Komponen
Versi Minimum
| Tujuan | __CAPGO_KEEP_0__ | __CAPGO_KEEP_0__ |
|---|---|---|
| Capacitor | 3.0 atau lebih tinggi | Framewok inti |
| Node.js | LTS terbaru | Pengelolaan Paket |
| Xcode | Versi terbaru | Pengembangan iOS |
| Android Studio | Versi terbaru | Pengembangan Android |
| Perangkat Fisik | iOS 13+ / Android API 23+ | Menguji fitur biometrik |
Pilih plugin biometrik berdasarkan versi Capacitor Anda:
- @aparajita/capacitor-autentikasi-biometrik untuk Capacitor 8
- capacitor-biometrik-asli untuk Capacitor 3 dan 4
Langkah-Langkah Pengaturan Android
Untuk mengonfigurasi autentikasi biometrik di Android, Anda perlu membuat beberapa perubahan pada file proyek Anda:
-
Konfigurasi Manifest
Tambahkan izin berikut ke file Anda:
AndroidManifest.xmlfile:<uses-permission android:name="android.permission.USE_BIOMETRIC" /> <!-- For Android 9 (API 28) or lower --> <uses-permission android:name="android.permission.USE_FINGERPRINT" /> -
Pengaturan Gradle
Perbarui file Anda untuk mencakup dependensi biometrik yang diperlukan:
build.gradlePanduan Pengaturan iOSdependencies { implementation "androidx.biometric:biometric:1.1.0" }
Untuk iOS, Anda perlu mengikuti langkah-langkah ini untuk mengonfigurasi autentikasi biometrik:
Pengaturan Info.plist
-
Tambahkan deskripsi penggunaan yang diperlukan ke file Anda:
Pengaturan Keychain
Info.plistAktifkan kemampuan Keychain di Xcode:<key>NSFaceIDUsageDescription</key> <string>Authentication required for secure access</string> -
file:
Pengaturan Gradle
- Terbuka pengaturan proyek Anda.
- Pergi ke tab Tanda Tangan & Kemampuan Tambahkan kemampuan
- Pengaturan Akses Kelompok Konfigurasi kelompok akses jika perlu. Pengaturan Kebijakan Autentikasi
- Konfigurasi kebijakan autentikasi lokal untuk mengatasi:
-
Pengaturan Autentikasi Gagal
Jatuh kembali ke kode sandi perangkat
- Konfigurasi kebijakan autentikasi lokal untuk mengatasi: Pengaturan Autentikasi Gagal Jatuh kembali ke kode sandi perangkat
- Konfigurasi kebijakan autentikasi lokal untuk mengatasi: Pengaturan Autentikasi Gagal Jatuh kembali ke kode sandi perangkat
- Ketersediaan biometrik pengecekan
Untuk keamanan yang lebih baik, gunakan Keychain iOS untuk menyimpan data sensitif. Ini memastikan kompatibilitas dengan Touch ID dan Face ID serta menjaga kredensial pengguna.
Code Implementasi
Setelah konfigurasi pengaturan sudah ada, langkah berikutnya adalah menerapkan code yang aman. Ini melibatkan memilih plugin yang tepat dan membuat aliran autentikasi yang dapat diandalkan.
Petunjuk Pemilihan Plugin
Ketika memilih plugin autentikasi biometrik untuk aplikasi Capacitor Anda, pilihan Anda harus sesuai dengan kebutuhan proyek khusus. Berikut beberapa pilihan populer:
| Nama Plugin | Versi Capacitor | Ciri-Ciri Utama | Terbaik Untuk |
|---|---|---|---|
| @aparajita/capacitor-biometric-auth | Versi Capacitor 8 | Biometri asli, kreditur perangkat, API yang komprehensif | Proyek baru yang dimulai dengan Capacitor 8 |
| capacitor-biometrik-asli | Capacitor 3, 4 | Penyimpanan kreditur yang aman, integrasi Keychain/Keystore | Proyek yang sudah ada yang membutuhkan manajemen kreditur |
| Semua versi | Autentikasi biometrik dan kreditur perangkat, API yang bersih | Proyek yang membutuhkan opsi autentikasi yang fleksibel |
Autentikasi Code Contoh
Berikut cara menggunakan @capgo/capacitor-biometrik-asli plugin untuk autentikasi biometrik:
import { Biometrics } from '@capgo/capacitor-native-biometric';
async function setupBiometricAuth() {
try {
const { isAvailable } = await Biometrics.isBiometricsAvailable();
if (!isAvailable) {
return {
success: false,
message: "Biometric authentication not available"
};
}
const result = await Biometrics.authenticate({
reason: "Access your secure data",
title: "Verify Identity",
subtitle: "Use biometrics to authenticate",
cancelTitle: "Use Password Instead"
});
return {
success: true,
data: result
};
} catch (error) {
return {
success: false,
error: error.message
};
}
}
Untuk mengelola kreditur yang aman, capacitor-native-biometric plugin menawarkan pendekatan yang sederhana:
import { NativeBiometric } from '@capgo/capacitor-native-biometric';
async function secureCredentialStorage(credentials) {
try {
await NativeBiometric.setCredentials({
username: credentials.username,
password: credentials.password,
server: "api.yourserver.com"
});
// Verify storage by retrieving the credentials
const stored = await NativeBiometric.getCredentials({
server: "api.yourserver.com"
});
return stored.username === credentials.username;
} catch (error) {
console.error("Credential storage failed:", error);
return false;
}
}
Setelah code diinstal, sangat penting untuk memvalidasi fungsinya melalui tes yang tepat.
Metode Pengujian
Untuk memastikan autentikasi biometrik Anda dapat diandalkan dan aman, pertimbangkan strategi pengujian berikut:
-
Pengujian Kompabilitas Perangkat
Periksa apakah autentikasi bekerja di berbagai perangkat dan kondisi:
async function runCompatibilityTests() { const tests = { biometricAvailable: await Biometrics.isBiometricsAvailable(), credentialStorage: await testCredentialStorage(), authenticationFlow: await testAuthFlow(), fallbackMechanism: await testFallbackAuth() }; return tests; } -
Pengelolaan Kesalahan dan Skenario Umum
Simulasikan kesalahan dan uji mekanisme fallback:
async function validateErrorHandling() { try { await Promise.race([ Biometrics.authenticate(), new Promise((_, reject) => setTimeout(() => reject(new Error("Timeout")), 30000) ) ]); } catch (error) { return implementFallbackAuth(); } } -
Validasi Keamanan
Pastikan implementasi Anda memenuhi standar keamanan:
async function validateSecurityMeasures() { const validations = { keychain: await validateKeychainAccess(), biometricStrength: await checkBiometricStrength(), encryptionStatus: await verifyEncryption() }; return validations.keychain && validations.biometricStrength && validations.encryptionStatus; }
Selain itu, lakukan tes untuk skenario seperti:
- Pengulangan usaha autentikasi gagal
- Perilaku setelah perangkat restart
- Transisi antara keadaan aplikasi di depan dan di latar belakang
- Perubahan koneksi jaringan
- Pengaturan ulang pengaturan biometrik sistem
Pengujian yang teliti memastikan sistem autentikasi biometrik kuat dan siap digunakan dalam situasi nyata.
Standar Keamanan
Menggunakan keamanan yang kuat dalam autentikasi biometrik berarti memprioritaskan perlindungan data, mematuhi peraturan kompatibilitas, dan menerapkan teknik keamanan yang berlapis.
Metode Keamanan Data
Pada iOS, data biometrik dienkripsi dan disimpan menggunakan [__CAPGO_KEEP_0__]Sementara itu Android menggunakan [__CAPGO_KEEP_1__]. Jika Anda menggunakan plugin ini, Anda dapat menyimpan kredensial pengguna dengan aman seperti ini: capacitor-native-biometric Untuk transmisi data, selalu implementasikan
import { NativeBiometric } from '@capgo/capacitor-native-biometric';
async function securelyStoreCredentials(username, password) {
const server = "api.yourapp.com";
// Use the highest available encryption
await NativeBiometric.setCredentials({
username,
password,
server,
authenticationType: "biometricAndDevice",
accessControl: "biometryAny"
});
}
enkripsi akhir ke akhir untuk menjaga informasi sensitif tetap terlindungi. Pedoman Penyimpanan
Toko aplikasi mengenakan aturan ketat untuk
keamanan biometrik . Berikut adalah penjabaran persyaratan utama platform:[__CAPGO_KEEP_2__]
| Platform | Persyaratan Utama | Catatan Implementasi |
|---|---|---|
| iOS | Gunakan framework LocalAuthentication, berikan opsi fallback, dan pastikan konsen user jelas | Harus mendukung baik Face ID dan Touch ID |
| Android | Manfaatkan BiometricPrompt API, dapatkan izin user eksplisit, dan deklarasikan tingkat keamanan | Support pengenalan sidik jari dan wajah, dengan perbedaan untuk tingkat keamanan yang berbeda |
Pengaturan Multi-Faktor
Meningkatkan keamanan seringkali memerlukan kombinasi verifikasi biometrik bersama dengan lapisan autentikasi tambahan. Misalnya, setelah verifikasi biometrik awal verifikasi biometrik, Anda dapat menambahkan langkah sekunder untuk memastikan identitas pengguna:
async function setupMultiFactorAuth() {
// First factor: Biometric verification
const biometricResult = await Biometrics.authenticate({
reason: "Verify your identity",
title: "Authentication Required"
});
if (biometricResult.verified) {
// Second factor: Time-based OTP or similar mechanism
const totpResult = await verifyTOTP();
return totpResult.success;
}
return false;
}
A pendekatan multi-faktor biasanya mencakup:
- Autentikasi biometrik utama
- Verifikasi sekunder (misalnya, SMS code atau aplikasi autentikator)
- Konfirmasi transaksi khusus untuk keamanan tambahan
Jika Anda menggunakan alat seperti Capgo untuk pembaruan langsung, pastikan kinerja sesuai dengan standar keamanan dengan memanfaatkan fitur enkripsi end-to-end fitur ini menjamin bahwa metode autentikasi biometrik Anda tetap aman selama pembaruan dan sesuai dengan persyaratan platform fitur ini menjamin bahwa metode autentikasi biometrik Anda tetap aman selama pembaruan dan sesuai dengan persyaratan platform [1].
Petunjuk Perawatan
Jaga agar sistem kebiologis Anda berjalan lancar dengan mengimbangi kecepatan, efisiensi baterai, dan pembaruan waktu.
Tips Kecepatan dan Baterai
Berikut adalah contoh kode code untuk menerapkan autentikasi biometrik yang efisien:
// Efficient authentication implementation
async function optimizedBiometricCheck() {
const authResult = await NativeBiometric.isAvailable();
if (!authResult.isAvailable) {
return handleFallback();
}
// Cache authentication state to avoid unnecessary re-checks
if (this.cachedAuthState && !this.isAuthExpired()) {
return this.cachedAuthState;
}
return NativeBiometric.verifyIdentity({
reason: "Verify your identity",
title: "Authentication Required",
maxAttempts: 3
});
}
Untuk mendapatkan hasil yang optimal dari kinerja sistem kebiologis Anda:
- Autentikasi Batch: Buatlah beberapa permintaan autentikasi menjadi satu sesi untuk mengurangi gangguan.
- Optimasi Caching: Simpan status autentikasi dengan aman dan tetapkan waktu kedaluwarsa untuk menghindari verifikasi ulang.
- Optimasi Latar Belakang: Sementara waktu, hentikan tugas-tugas yang tidak penting selama proses autentikasi untuk meningkatkan kecepatan dan menghemat baterai.
- Pendekatan Berdasarkan Acara: Ganti polling konstan dengan pendengar acara untuk memantau status autentikasi lebih efisien.
Updates dengan Capgo

Capgo memudahkan pembaruan aplikasi.
Berikut adalah alasan mengapa Capgo adalah alat yang bagus untuk mengelola pembaruan:
- Instant Deployment: Segera keluarkan perbaikan keamanan kritis dan fitur baru tanpa menunda.
- Staged Rollouts: Uji pembaruan dengan kelompok pengguna tertentu sebelum mengeluarkannya untuk semua.
- Version Control: Pantau versi autentikasi yang berbeda untuk manajemen yang lebih baik.
- Rollback Darurat: Cepat kembali ke versi sebelumnya jika ada masalah yang timbul.
API Perbaruan
Mengupdate API Anda secara berkala sangat penting untuk keamanan dan kinerja. Tetaplah proaktif dengan perbaruan dengan mengikuti pedoman berikut:
| Jenis Perbaruan | Metode Pemantauan | Jadwal Implementasi |
|---|---|---|
| Pembaruan Keamanan | Pemberitahuan Repositori Plugin | 24 jam |
| Pembaruan Fitur | Dokumentasi Platform | 1 minggu |
| Pembaharuan Perubahan | Catatan Rilis | 2-4 minggu |
| Pembaharuan Kebijakan Toko | Portal Pengembang | Sebelum pengiriman |
Fokus pada area ini:
- Pembaharuan Platform: Ikuti pembaruan pada API LocalAuthentication iOS dan BiometricPrompt Android.
- Standar Keamanan: Tetap terintegrasi dengan persyaratan keamanan biometrik terbaru.
- Pedoman Toko: Pastikan konsistensi dengan kebijakan App Store Apple dan Google Play untuk menghindari masalah pengajuan.
Kesimpulan
Poin Utama
Menambahkan autentikasi biometrik ke aplikasi Capacitor Anda melibatkan keseimbangan keamanan, kinerja, dan pengalaman pengguna. Berikut adalah ringkasan singkat dari elemen inti yang perlu dipertimbangkan:
| Komponen | Fokus Implementasi | Pertimbangan Utama |
|---|---|---|
| Batasan Keamanan | Penggunaan penyimpanan native platform (Keychain/Keystore) | Penguncian kriptografi akhir-ke-akhir, perlindungan kredit |
| Pemilihan Plugin | Kompatibilitas versi terbaru | Support untuk beberapa jenis biometrik |
| Pengelolaan Update | Siklus pemeliharaan reguler | Penyebaran cepat patch keamanan |
| Pengalaman Pengguna | Opsi autentikasi fallback | Prompt autentikasi yang jelas dan mudah digunakan |
Ini adalah komponen jalan menuju integrasi sukses.
Langkah-langkah untuk Mengimplementasikan Autentikasi Biometrik
Ikuti langkah-langkah ini untuk mengintegrasikan autentikasi biometrik ke dalam aplikasi Anda:
-
Integrasi Plugin
Mulai dengan memilih plugin biometrik yang sesuai dengan versi Capacitor Anda. Pastikan file konfigurasi Anda - seperti __CAPGO_KEEP_1__ dan __CAPGO_KEEP_2__ - telah terkonfigurasi dengan benar. Untuk penyimpanan kredit yang aman, bergantung pada solusi native seperti Keychain atau Keystore.AndroidManifest.xmlKonfigurasi KeamananInfo.plistLindungi data pengguna dengan mengaktifkan enkripsi akhir-ke-akhir untuk semua transmisi kredit. Jika perlu, tambahkan autentikasi multi-faktor untuk menambahkan lapisan keamanan tambahan. Rencanakan penanganan kesalahan yang kuat dan opsi fallback untuk mempertahankan fungsi dalam kasus gagal. -
Pemeliharaan Berkelanjutan
Lindungi aplikasi Anda dengan mengatur pipeline pembaruan reguler untuk memperbarui patch keamanan. Tetaplah terus menerus memantau update plugin dan advisories keamanan. Alat seperti __CAPGO_KEEP_0__ dapat memudahkan proses ini dengan mengaktifkan pembaruan instan. __CAPGO_KEEP_1__ menunjukkan tingkat pembaruan pengguna sebesar 95% dalam waktu 24 jam, membuatnya menjadi penambahan yang berharga untuk toolkit Anda “__CAPGO_KEEP_0__ adalah alat yang wajib dimiliki oleh para pengembang yang ingin lebih produktif. Menghindari tinjauan untuk memperbaiki bug adalah emas.” - Bessie Cooper FAQs -
::: faq
Keep your app secure by setting up a regular update pipeline for security patches. Stay on top of plugin updates and monitor security advisories. Tools like Capgo can simplify this process by enabling instant updates. Capgo boasts an impressive 95% user update rate within 24 hours, making it a valuable addition to your toolkit [2].
“Capgo is a must-have tool for developers who want to be more productive. Avoiding review for bug fixes is golden.” - Bessie Cooper [2]
FAQs
::: faq
Apa perbedaan antara plugin biometrik untuk Capacitor, dan bagaimana saya dapat memilih yang terbaik untuk aplikasi saya?
Ketika memilih plugin biometrik untuk aplikasi Capacitor Anda, sangat penting untuk menyesuaikan pilihan dengan kebutuhan proyek Anda yang spesifik. Pertimbangkan faktor-faktor seperti kompatibilitas platform (apakah Anda memerlukan dukungan untuk iOS, Android, atau keduanya), seberapa sederhana proses integrasi, dan apakah plugin tersebut mendukung metode biometrik canggih seperti Face ID atau pengenalan sidik jari.
Meskipun panduan ini berfokus pada implementasi autentikasi biometrik dalam aplikasi __CAPGO_KEEP_0__ Capacitor apps__CAPGO_KEEP_0__ Capgo :::
::: faq
Bagaimana cara memastikan autentikasi biometrik aplikasi Capacitor saya memenuhi standar keamanan dan pedoman toko aplikasi?
Untuk memastikan autentikasi biometrik aplikasi Capacitor Anda memenuhi standar keamanan saat ini dan aturan toko aplikasi, ikuti praktek-praktek utama berikut:
- Pilih plugin yang dapat diandalkan: Gunakan plugin autentikasi biometrik yang dapat diandalkan seperti Capacitor’s
@capacitor/biometricsuntuk memastikan aplikasi Anda aman dan berfungsi dengan lancar di berbagai perangkat. - Patuhi aturan platform: Patuhi pedoman Apple dan Android, termasuk memperoleh persetujuan pengguna, menggunakan penyimpanan yang aman, dan menawarkan opsi cadangan seperti PIN atau kata sandi.
- Pelihara dependensi yang diperbarui: Perbarui aplikasi dan library Anda secara teratur untuk memperbaiki kelemahan dan tetap sejalan dengan standar yang berubah-ubah.
Menggunakan layanan pembaruan hidup seperti Capgo Memungkinkan Anda untuk memperbarui keamanan atau perbaikan aplikasi secara instan, menghindari penundaan persetujuan toko aplikasi. Ini menjaga aplikasi Anda aman, kompatibel, dan terupdate dengan kebijakan Apple dan Android. :::
::: faq
Apa tantangan yang mungkin dihadapi pengembang ketika mengintegrasikan autentikasi biometrik ke dalam aplikasi Capacitor dan bagaimana mereka dapat mengatasi masalah tersebut?
Mengimplementasikan autentikasi biometrik di aplikasi Capacitor memiliki tantangannya sendiri. Tantangan ini dapat mencakup memastikan konsistensi kompatibilitas perangkat, mengelola izin pengguna secara efektif, dan mengelola data sensitif dengan aman. Berikut adalah cara Anda dapat mengatasi masalah ini:
-
Konsistensi perangkat: Untuk mendukung fitur biometrik di Android dan iOS, pertimbangkan menggunakan plugin seperti
@capacitor-fingerprint-auth. Alat ini membantu menghubungkan celah antar platform, sehingga aplikasi Anda dapat berjalan dengan lancar di berbagai perangkat. -
Izin pengguna: Penting untuk menjelaskan dengan transparan mengapa aplikasi Anda membutuhkan akses biometrik. Berikan informasi yang jelas kepada pengguna dan desain aplikasi Anda untuk menangani situasi dengan baik ketika pengguna memilih untuk tidak memberikan izin.
-
Keamanan data: Mengamankan data autentikasi sangat penting. Ikuti praktik terbaik enkripsi Menggunakan plugin seperti dan tetap mengikuti pedoman keamanan yang disediakan oleh setiap platform untuk memastikan informasi sensitif tetap aman.
Untuk melakukan pembaruan atau memperbaiki masalah terkait fitur biometrik tanpa harus menghadapi persetujuan toko aplikasi, Anda dapat menggunakan alat seperti Capgo. Ini memungkinkan pembaruan waktu nyata, sehingga Anda dapat menangani bug atau meningkatkan fungsi dengan cepat sambil tetap memenuhi kebijakan Apple dan Android. :::
Teruskan dari Autentikasi Biometrik di Aplikasi Capacitor
Jika Anda menggunakan Autentikasi Biometrik di Aplikasi Capacitor untuk merencanakan keamanan dan kewenangan, hubungkannya dengan Enkripsi untuk detail implementasi di Enkripsi, Kewenangan untuk detail implementasi di Kewenangan, Scanner Keamanan Capgo untuk alur kerja produk di Scanner Keamanan Capgo, Keamanan Capgo untuk alur kerja produk di Keamanan Capgo dan Tengah Kepercayaan Capgo untuk alur kerja produk di Tengah Kepercayaan Capgo.