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 login lebih cepat.
- Memenuhi standar keamanan untuk data sensitif.
-
Metode yang Dapat Dibangkitkan:
- Sidik Jari: Cepat dan umum.
- Wajah Recognition: Opsi tanpa tangan.
- Iris Scanning: Kasus keamanan tinggi (perangkat terbatas).
- Pengenalan Suara: Fokus aksesibilitas (dukungan terbatas).
-
Alat-Alat Utama yang Diperlukan:
- Capacitor 3.0+.
-
Poin Utama Pengaturan:
- 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 pengganti.
Perbandingan Cepat Plugin
| Nama Plugin | Capacitor Versi | Fitur-Fitur | Terbaik Untuk |
|---|---|---|---|
@aparajita/capacitor-biometric-auth | Capacitor 8 | Biometrik Nativ, 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.
Ionic Biometric (FaceID / FingerPrint) Pengenalan Otentikasi
Pengaturan Persyaratan
Untuk mengaktifkan pengenalan otentikasi biometrik di aplikasi Anda, Capacitor, Anda perlu mengonfigurasi beberapa alat, dependensi, dan pengaturan spesifik platform. Di bawah ini, Anda akan menemukan langkah-langkah pengaturan persyaratan untuk kedua platform Android dan iOS.
Peralatan dan Dependensi yang Diperlukan
Sebelum melanjutkan ke implementasi, pastikan peralatan dan dependensi berikut sudah siap:
| Komponen | Versi Minimum | Tujuan |
|---|---|---|
| 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 pada Android, Anda perlu membuat beberapa penyesuaian pada file proyek Anda:
-
Konfigurasi Manifest
Tambahkan izin berikut ke aplikasi Anda:
AndroidManifest.xml__CAPGO_KEEP_0__<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 __CAPGO_KEEP_0__ untuk mencakup dependensi biometrik yang diperlukan:
build.gradleLangkah-Langkah Pengaturan iOSdependencies { implementation "androidx.biometric:biometric:1.1.0" }
Untuk iOS, Anda perlu mengikuti langkah-langkah berikut untuk mengonfigurasi autentikasi biometrik:
Konfigurasi Info.plist
-
Tambahkan deskripsi penggunaan yang diperlukan ke file __CAPGO_KEEP_0__:
Konfigurasi Keychain
Info.plistAktifkan kemampuan Keychain di Xcode:<key>NSFaceIDUsageDescription</key> <string>Authentication required for secure access</string> -
iOS Setup Steps
Update your app’s
- Terbuka pengaturan proyek Anda.
- Pergi ke tab Tanda Tangan & Kemampuan Pilih
- Kemampuan Pengakuan Keychain Tambahkan. Konfigurasi kelompok akses jika perlu.
- Pengaturan Kebijakan Autentikasi
-
Konfigurasi kebijakan autentikasi lokal untuk mengatasi:
Pengusulan Autentikasi Gagal
- Jatuh ke kode sandi perangkat
- Jatuh ke kode sandi perangkat
- Ketersediaan Biometrik
Untuk keamanan yang lebih baik, gunakan Keychain iOS untuk menyimpan data sensitif. Hal ini memastikan konsistensi dengan Touch ID dan Face ID serta melindungi kreditensial pengguna.
Code Implementasi
Setelah konfigurasi pengaturan telah ditetapkan, langkah berikutnya adalah menerapkan code yang aman. Hal ini melibatkan memilih plugin yang tepat dan mengembangkan aliran autentikasi yang dapat diandalkan.
Petunjuk Pemilihan Plugin
Ketika memilih plugin autentikasi biometrik untuk aplikasi Capacitor Anda, pilihan Anda harus sesuai dengan kebutuhan proyek yang spesifik. 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-biometrik 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 terpasang, 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:
- Gagal beberapa kali untuk mencoba autentikasi
- Perilaku setelah perangkat restart
- Transisi antara keadaan aplikasi di depan dan di latar belakang
- Perubahan dalam koneksi jaringan
- Pembaruan pengaturan keamanan biometrik sistem
Pengujian yang teliti memastikan sistem autentikasi biometrik kuat dan siap digunakan dalam situasi nyata.
Standar Keamanan
Menjamin keamanan yang kuat dalam autentikasi biometrik berarti memprioritaskan perlindungan data, mematuhi peraturan komplian, dan menerapkan teknik keamanan yang berlapis.
Metode Perlindungan Data
Pada iOS, data biometrik dienkripsi dan disimpan menggunakan Kunci Simpanan, sementara Android menggunakan Kunci Simpanan. Jika Anda menggunakan capacitor-native-biometric plugin, Anda dapat menyimpan kredensial pengguna secara aman seperti ini:
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"
});
}
Untuk transmisi data, selalu implementasikan enkripsi akhir ke akhir untuk menjaga informasi sensitif tetap terlindungi.
Pedoman Penyimpanan
Aplikasi toko memaksa aturan ketat untuk keamanan biometrik. Berikut adalah penjabaran dari persyaratan utama platform:
| Platform | Persyaratan Utama | Catatan Implementasi |
|---|---|---|
| iOS | Pakai framework LocalAuthentication, berikan opsi fallback, dan pastikan konsensus pengguna jelas | Wajib mendukung Face ID dan Touch ID |
| Andoid | Manfaatkan BiometricPrompt API, dapatkan izin pengguna eksplisit, dan deklarasikan tingkat keamanan | Mendukung pengenalan sidik jari dan wajah, dengan perbedaan untuk tingkat keamanan yang berbeda |
Pengaturan Multi-Faktor
Meningkatkan keamanan seringkali memerlukan kombinasi verifikasi biometrik dengan lapisan autentikasi tambahan. Misalnya, setelah verifikasi biometrik awal verifikasi biometrikanda 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;
}
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 live, pastikan kinerja sesuai dengan standar keamanan dengan memanfaatkan fitur enkripsi end-to-end fitur enkripsi end-to-end ini menjamin bahwa metode autentikasi biometrik Anda tetap aman selama pembaruan dan sesuai dengan persyaratan platform [1].
Petunjuk Perawatan
Jaga agar sistem biometrik Anda berjalan lancar dengan mengimbangi kecepatan, efisiensi baterai, dan pembaruan waktu yang tepat.
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 biometrik Anda:
- Autentikasi Batch: Buatlah beberapa tindakan yang memerlukan autentikasi menjadi satu sesi untuk mengurangi gangguan.
- Optimasi Caching: Simpan status autentikasi secara aman dan tetapkan waktu kedaluwarsa untuk menghindari verifikasi yang berulang.
- Optimasi Latar Belakang: Sementara waktu, hentikan tugas-tugas yang tidak penting selama autentikasi untuk meningkatkan kecepatan dan menghemat baterai.
- Pendekatan Berdasarkan Acara: Ganti polling konstan dengan pemantauan acara untuk memantau status autentikasi lebih efisien.
Perbarui dengan Capgo

Capgo memudahkan pembaruan aplikasi.
Ini mengapa Capgo adalah alat yang bagus untuk mengelola pembaruan:
- Pengaktifan Langsung: Kirimkan perbaikan keamanan kritis dan fitur baru tanpa menunda-nunda.
- Rollout Langsung: Uji pembaruan dengan kelompok pengguna tertentu sebelum mengeluarkannya untuk semua orang.
- Pengendalian Versi: Pantau versi autentikasi yang berbeda untuk pengelolaan yang lebih baik.
- Rollback Darurat: Cepat kembali ke versi sebelumnya jika ada masalah.
API Perbarui
Mengupdate biometrik API sangat penting untuk keamanan dan fungsi. Tetap proaktif dengan perbaruan dengan mengikuti pedoman ini:
| Jenis Perbarui | Metode Pemantauan | Jadwal Implementasi |
|---|---|---|
| Patch Keamanan | Peringatan Repositori Plugin | 24 jam |
| Perbarui Fitur | Dokumentasi Platform | 1 minggu |
| Perubahan-Pembaharuan | Catatan Rilis | 2-4 minggu |
| Perubahan Kebijakan Toko | Portal Pengembang | Sebelum pengiriman |
Fokus pada area ini:
- Perubahan 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 elemen inti yang perlu dipertimbangkan:
| Komponen | Fokus Implementasi | Pertimbangan Utama |
|---|---|---|
| Standar Keamanan | Penyimpanan alami platform (Keychain/Keystore) | Penguncian kriptografi akhir-ke-akhir, perlindungan kredential |
| Pemilihan Plugin | Versi terbaru kompatibilitas | Support untuk beberapa jenis biometrik |
| Pengelolaan Update | Siklus pemeliharaan reguler | Pengembalian cepat patch keamanan |
| Pengalaman Pengguna | Opsi autentikasi fallback | Prompt autentikasi yang jelas dan ramah pengguna |
Komponen-komponen ini adalah peta jalan Anda untuk integrasi sukses.
Langkah-langkah untuk Menerapkan 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 - seperti __CAPGO_KEEP_1__ dan __CAPGO_KEEP_2__ - telah terkonfigurasi dengan benar. Untuk penyimpanan kredit yang aman, bergantunglah 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 patch keamanan. Tetaplah berada di atas plugin update dan pantau saran keamanan. Alat seperti __CAPGO_KEEP_0__ dapat memudahkan proses ini dengan mengaktifkan pembaruan instan. __CAPGO_KEEP_1__ menunjukkan tingkat pembaruan pengguna 95% dalam waktu 24 jam, membuatnya menjadi penambahan berharga untuk toolkit Anda “__CAPGO_KEEP_0__ adalah alat yang wajib dimiliki oleh pengembang yang ingin lebih produktif. Menghindari tinjauan untuk memperbaiki bug adalah emas.” - Bessie Cooper Pertanyaan Umum -
::: 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]
__CAPGO_KEEP_2__
__CAPGO_KEEP_0__
What adalah perbedaan antara plugin biometrik untuk Capacitor, dan bagaimana saya dapat memilih yang terbaik untuk aplikasi saya?
Mengapa memilih plugin biometrik untuk aplikasi Capacitor Anda sangat penting untuk menyesuaikan pilihan dengan kebutuhan proyek Anda. Pertimbangkan faktor seperti kompatibilitas platform (apakah Anda memerlukan dukungan untuk iOS, Android, atau kedua-duanya), seberapa sederhana proses integrasi, dan apakah plugin mendukung metode biometrik canggih seperti Face ID atau pengenalan sidik jari.
Meskipun panduan ini berfokus pada implementasi autentikasi biometrik di aplikasi __CAPGO_KEEP_0__ perangkat lunak seperti Capacitordapat berperan penting. Mereka memungkinkan Anda untuk memperbarui aplikasi secara real-time tanpa memerlukan persetujuan toko aplikasi. Ini berarti aplikasi Anda dapat tetap relevan dengan fitur keamanan terbaru, termasuk pembaruan biometrik, sambil tetap memenuhi standar Apple dan Android. Capgo :::
::: faq
Bagaimana cara memastikan autentikasi biometrik di aplikasi Capacitor saya memenuhi standar keamanan dan pedoman toko aplikasi?
Untuk memastikan autentikasi biometrik di 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 dipercaya seperti Capacitor’s
@capacitor/biometricsagar 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.
- Perbarui dependensi secara teratur: 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 ke 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 secara aman. Berikut cara Anda dapat menangani masalah-masalah ini:
-
Konsistensi perangkat: Untuk mendukung fitur biometrik di Android dan iOS, pertimbangkan menggunakan plugin seperti
@capacitor-fingerprint-auth. Alat-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 pengguna informasi yang jelas dan desain aplikasi Anda untuk menangani situasi dengan baik ketika pengguna memilih untuk tidak memberikan izin.
-
Keamanan data: Mengamankan data autentikasi sangat kritis. Ikuti praktik terbaik enkripsi Menggunakan plugin seperti And pastikan informasi sensitif tetap aman dengan mengikuti pedoman keamanan yang disediakan oleh setiap platform.
Membuat perubahan atau memperbaiki masalah terkait fitur biometrik tanpa harus menghadapi persetujuan toko aplikasi, Anda dapat menggunakan alat seperti Capgo. Ini memungkinkan perubahan waktu nyata, memungkinkan Anda untuk 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 kinerja, hubungkannya dengan Enkripsi untuk detail implementasi di Enkripsi, Kinerja untuk detail implementasi di Kinerja, Pemeriksa Keamanan Capgo untuk alur kerja produk di Pemeriksa Keamanan Capgo Capgo Keamanan untuk alur kerja produk di Capgo Keamanan, dan Capgo Pusat Kepercayaan untuk alur kerja produk di Capgo Pusat Kepercayaan.