Pengamanan

Capgo menyediakan enkripsi akhir-ke-akhir yang kuat untuk bundle aplikasi Anda, sehingga JavaScript code dan aset Anda dilindungi selama transmisi dan penyimpanan. Sistem enkripsi ini dirancang untuk memberikan Anda kendali penuh atas keamanan aplikasi Anda sambil mempertahankan kemudahan pembaruan hidup.

Ringkasan

Sistem enkripsi Capgo menggunakan metode kriptografi standar industri untuk melindungi bundle Anda dari akses tidak berwenang. Ketika enkripsi diaktifkan, bundle Anda dienkripsi sebelum meninggalkan lingkungan pengembangan Anda dan tetap dienkripsi sampai di-dekripsi oleh aplikasi Anda di perangkat pengguna.

Apa yang Dilindungi oleh Enkripsi: Berbeda dengan sistem OTA yang hanya menandatangani pembaruan, Capgo mengenkripsi bundle yang diunggah sebelum penyimpanan dan pengiriman. Ini melindungi isi bundle dari akses sembarangan dalam penyimpanan atau transit dan memastikan hanya orang dengan kunci pribadi Anda yang dapat menghasilkan pembaruan enkripsi yang valid. Ini tidak menghalangi aset web yang dikirimkan untuk dipecahkan: kunci publik yang digunakan oleh klien untuk memecahkan pembaruan didistribusikan dalam aplikasi, sehingga seorang penyerang yang berdedikasi masih dapat mengekstraknya dan memeriksa isi bundle dengan cukup usaha.

Kapan Anda Membutuhkan Enkripsi

Jika Anda mengunggah sebuah bundle tanpa enkripsi, gunakanlah sebagai aset publik. Saluran pribadi membatasi perangkat mana yang menerima pembaruan, namun tidak membuat bundle yang diunggah menjadi rahasia. Enkripsi berguna ketika Anda ingin melindungi lebih baik dalam penyimpanan dan transit serta ketika Anda ingin hanya pemilik kunci pribadi yang dapat menerbitkan pembaruan enkripsi yang valid. Namun, hal ini tidak menjamin bahwa JavaScript, HTML, atau CSS yang dikirimkan tidak dapat pernah diperiksa.

Model Ancaman

Capgo enkripsi melindungi terhadap pengungkapan bundle oleh Capgo, penyedia penyimpanan, CDN, atau siapa saja yang hanya melihat artefak pengiriman enkripsi. Hal ini juga mencegah pihak ketiga untuk menghasilkan pembaruan enkripsi yang valid tanpa kunci pribadi Anda. Karena kunci publik diintegrasikan ke dalam aplikasi yang didistribusikan, sehingga klien dapat memecahkan pembaruan, orang yang memiliki biner aplikasi Anda dan motivasi yang cukup masih dapat mengambil kembali bahan kunci yang diperlukan untuk memeriksa bundle.

Saran

Enkripsi sangat penting untuk:

• Aplikasi yang mengolah data sensitif atau logika bisnis
• Aplikasi perusahaan yang memiliki persyaratan kompatibilitas
• Aplikasi yang dijalankan di industri yang diatur
• Organisasi dengan kebijakan keamanan yang ketat

Bagaimana Enkripsi Berfungsi

Capgo menggunakan pendekatan enkripsi hibrid yang menggabungkan RSA dan AES untuk keamanan dan kinerja optimal:

1. Pembuatan Kunci

• Kunci Pribadi: Dibuat dan disimpan dengan aman di lingkungan pengembangan Anda (digunakan untuk enkripsi)
• Kunci Publik: Dihasilkan dari kunci pribadi Anda dan disimpan di konfigurasi Capacitor aplikasi Anda (digunakan untuk dekripsi)
• Kunci Sesi: Kunci AES acak yang dihasilkan untuk setiap unggahan bundle

2. Proses Enkripsi

1. Kunci sesi AES acak dibuat untuk setiap unggahan bundle
2. Bundle Anda dienkripsi menggunakan kunci sesi AES
3. Checksum bundle dihitung
4. Kedua kunci sesi AES dan checksum dienkripsi bersama menggunakan kunci pribadi RSA Anda (membuat “tanda tangan”)
5. Bundle yang dienkripsi dan tanda tangan yang dienkripsi disimpan

Checksum dienkripsi bersama kunci AES untuk mencegah perubahan. Karena hanya kunci pribadi RSA Anda yang dapat membuat tanda tangan ini, dan hanya kunci publik yang sesuai yang dapat memecahkannya, ini memastikan bahwa baik kunci sesi AES dan checksum yang diharapkan otentik dan tidak dimodifikasi oleh penyerang.

Judul Bagian 3. Proses Penguraian

1. Aplikasi Anda mengunduh bundle yang dienkripsi dan tanda tangan yang dienkripsi
2. Capgo SDK menggunakan kunci publik RSA Anda (yang disimpan di aplikasi) untuk memecahkan tanda tangan
3. Ini mengungkapkan kunci sesi AES dan checksum asli
4. Kunci sesi AES digunakan untuk membalikkan bundle
5. Diperoleh checksum dari bundle yang dibalikkan dan dibandingkan dengan checksum asli untuk verifikasi integritas

Proses ini memastikan bahwa bahkan jika penyerang mengintersepsi bundle yang dienkripsi, mereka tidak dapat memodifikasi kunci sesi AES atau menyediakan checksum palsu, karena mereka perlu kunci pribadi Anda untuk membuat tanda tangan yang valid yang dapat dienkripsi oleh kunci publik

Trik

RSA tidak dapat mengenkripsi jumlah data yang besar secara efisien, sehingga AES digunakan untuk enkripsi bundle yang sebenarnya sementara RSA menyediakan kunci AES dan verifikasi integritas melalui tanda tangan checksum

Capgo vs Platform Lain

Fitur	Capgo	Platform OTA Lain
Isi Bundle	Di enkripsi dalam penyimpanan/transit; masih dapat diperiksa oleh seorang insinyur balik yang berdedikasi dengan file biner aplikasi	Dapat dibaca secara publik
Metode Keamanan	Enkripsi akhir-ke-akhir yang sebenarnya	Code hanya tanda tangan
Level Privasi	Pelindungannya kuat; tidak melawan balik	Platform dapat mengakses code Anda
Pelindung	Konten + integritas + keaslian	Hanya integritas + keaslian

Mengapa Ini Penting:

• Code penandatangan hanya memastikan bahwa pembaruan tidak telah dimanipulasi dan berasal dari sumber yang tepat
• Capgo enkripsi melindungi bundle saat disimpan dan dikirimkan dan membuat pembaruan enkripsi palsu jauh lebih sulit karena penyerang perlu kunci pribadi Anda
• Reversi engineering masih mungkin setelah aplikasi rilis, karena klien mengandung kunci publik yang diperlukan untuk mendekripsi dan memuat pembaruan

Methode Enkripsi

Capgo menggunakan Methode Enkripsi V2 sebagai metode standar enkripsi:

Methode Enkripsi V2 (Standar Saat Ini)

• Menggunakan RSA-4096 untuk keamanan yang lebih tinggi
• Enkripsi AES-256-GCM untuk enkripsi yang terautentik
• Menghasilkan verifikasi integritas
• Kinerja dan keamanan yang lebih baik

Enkripsi V1 (Tidak Aktif)

• Menggunakan RSA-2048 untuk enkripsi kunci
• Enkripsi AES-256-CBC untuk enkripsi paket
• Tidak lagi tersedia dalam versi CLI saat ini
• Aplikasi lama yang menggunakan V1 harus beralih ke V2

Peringatan

Enkripsi V1 tidak lagi didukung dalam versi Capgo CLI saat ini. Jika Anda menggunakan enkripsi V1, Anda harus beralih ke V2. Lihat Petunjuk Migrasi Untuk instruksi yang lebih rinci.

Mengatur Pengaturan Enkripsi

Langkah 1: Membuat Kunci Enkripsi

Pertama, buatlah kunci enkripsi Anda menggunakan Capgo CLI:

# Generate new encryption keys (creates files in current directory)
npx @capgo/cli@latest key create

Ini menciptakan:

• .capgo_key_v2: Kunci pribadi Anda (jaga ini aman!)
• .capgo_key_v2.pub: Kunci publik Anda (digunakan oleh aplikasi Anda)

File-file ini dibuat di direktori saat ini di mana Anda menjalankan perintah.

Peringatan

Catatan Penting Penyimpanan:

• Kunci Pribadi (.capgo_key_v2): Jangan pernah memasukkan ini ke kontrol versi. File ini harus dijaga kerahasiaannya dan hanya digunakan untuk enkripsi selama unggahan bundle.
• Kunci Publik (.capgo_key_v2.pub): Ini aman untuk dimasukkan ke kontrol versi karena ini adalah salinan kunci publik Anda.
• Lokasi File: Kunci dibuat di direktori saat ini di mana Anda menjalankan key create perintah.
• Kunci Publik di KonfigurasiUntuk menggunakannya, Anda harus menjalankan key save untuk menyimpan kunci publik di konfigurasi Capacitor Anda agar aplikasi seluler dapat menggunakannya.

Untuk penggunaan produksi, simpan kunci pribadi dengan aman (variabel lingkungan, layanan manajemen kunci) dan hapusnya dari proyek lokal setelah pengaturan.

Langkah 2: Simpan Kunci Publik Anda ke Konfigurasi Capacitor (Wajib)

Kamu konteks: Fragment teks HTML dari string Capgo UI yang lebih panjang (kunci induk `you_definition`). Halaman/area: Situs web pemasaran Capgo. Peran: Paragraf pemasaran atau hukum yang panjang. Dilihat di: halaman disclaimer.astro, halaman return.astro. Kunci pesan `you_definition` (Kamu Definisi). save your public key to the Capacitor config so your mobile app can decrypt bundles:

# Save public key from file to Capacitor config (required)
npx @capgo/cli@latest key save --key ./.capgo_key_v2.pub

# Or save public key data directly
npx @capgo/cli@latest key save --key-data "$CAPGO_PUBLIC_KEY"

Step 3: Sync Capacitor Platform (Required)

Setelah menyimpan kunci publik, Anda wajib mengsinkronkan Capacitor platform untuk menyalin konfigurasi yang diperbarui ke layer native:

# Sync the platform to copy config to native
npx cap sync

Peringatan

Langkah-Langkah Wajib:

1. Command ini menyimpan kunci publik di konfigurasi __CAPGO_KEEP_0__ Anda key save command stores the public key in your Capacitor config
2. npx cap sync Tidak ada kedua langkah ini, aplikasi Anda tidak akan dapat mengenkripsi pembaruan yang dienkripsi
3. langkah ini

Enkripsi Paket

Methode 1: Enkripsi Saat Unggah

Cara termudah adalah dengan mengenkripsi selama proses unggah:

# Upload with automatic encryption
npx @capgo/cli@latest bundle upload --key-v2

# For external storage, you must encrypt first (see Manual Encryption Workflow below)

Methode 2: Alur Kerja Enkripsi Manual

Untuk kontrol yang lebih, Anda dapat mengenkripsi paket secara manual:

1. Buatlah paket zip:

   npx @capgo/cli@latest bundle zip com.example.app --path ./dist --key-v2

2. Enkripsi bundle:

   npx @capgo/cli@latest bundle encrypt ./com.example.app.zip CHECKSUM_FROM_STEP_1

3. Unggah ke penyimpanan Anda (misalnya, S3) dan daftarkan dengan Capgo:

   # First upload the encrypted bundle to your storage (e.g., AWS S3)
   aws s3 cp ./encrypted-bundle.zip s3://your-bucket/encrypted-bundle.zip
   
   # Then register with Capgo using the external URL
   npx @capgo/cli@latest bundle upload --external https://your-storage.com/encrypted-bundle.zip --iv-session-key IV_SESSION_KEY_FROM_STEP_2

Manajemen Kunci

Mengimpan Kunci dengan Aman

Opsi Kunci Pribadi:

1. File-based (pengembangan lokal):

   # Key stored as .capgo_key_v2 file in project root
   npx @capgo/cli@latest bundle upload --key-v2

2. Variabel lingkungan (CI/CD):

   # Store in environment variable for CI
   export CAPGO_PRIVATE_KEY="$(cat .capgo_key_v2)"
   npx @capgo/cli@latest bundle upload --key-data-v2 "$CAPGO_PRIVATE_KEY"

Konfigurasi Kunci Publik (Diperlukan):

# Must save public key to Capacitor config for mobile app
npx @capgo/cli@latest key save --key ./.capgo_key_v2.pub

Lingkungan Produksi:

• Simpan kunci pribadi di layanan manajemen kunci yang aman (AWS KMS, Azure Key Vault, dll.)
• Pakai manajemen rahasia CI/CD untuk kunci pribadi
• Jangan pernah memasukkan kunci pribadi ke dalam pengontrol versi

Penyebab Penggunaan:

• Kunci Pribadi: Digunakan oleh CLI untuk enkripsi selama unggahan bundle (tetap aman)
• Kunci Publik: Disimpan dalam konfigurasi aplikasi untuk dekripsi di perangkat (aman untuk dikomit)

Putuskan setelah kompromi kunci pribadi

Putuskan pasang kunci saat kunci pribadi dicurigai atau dikonfirmasi telah dicuri. Rotasi kalender rutin tidak diperlukan. Ini adalah migrasi kunci asli, bukan perubahan OTA saja.

1. Generate pasang kunci pengganti:

   npx @capgo/cli@latest key create

2. Simpan kunci publik pengganti ke konfigurasi Capacitor Anda:

   npx @capgo/cli@latest key save --key ./.capgo_key_v2.pub

3. Sinkronkan dan kirimkan rilis native yang telah diubah: Jalankan npx cap sync, kemudian distribusikan aplikasi native baru yang berisi kunci publik pengganti.

4. Targetkan versi native yang baru: Perangkat yang masih menjalankan binary native lama tidak dapat mengenkripsi pembaruan yang dienkripsi dengan kunci publik pengganti. Gunakan Target Versi context":"Page/area: Halaman Capgo solusi pemasaran. Peran: Judul bagian atau halaman. Dilihat di: halaman solusi/target-versi.astro. Pesan kunci `solutions_version_targeting_title` (Judul Target Versi Solusi). | Page/area: Halaman Capgo solusi pemasaran. Peran: Label UI singkat atau item navigasi. Dilihat di: halaman solusi/target-versi.astro. Pesan kunci `solutions_version_targeting` (Target Versi Solusi)."

5. Untuk membatasi paket kunci publik pengganti hanya ke versi native yang baru sementara flota lainnya mengupdate melalui toko atau MDM. Ganti rahasia unggah Anda:

Peringatan

Jika kunci pribadi terganggu, segera berhenti menggunakan kunci tersebut. Instalasi yang sudah ada dengan kunci publik lama memerlukan pembaruan native store atau MDM sebelum dapat menerima bundle yang dienkripsi dengan kunci pengganti.

Praktik Keamanan Terbaik

Keamanan Kunci

• Jangan pernah berbagi kunci pribadi antara lingkungan atau anggota tim
• Pakai kunci yang berbeda untuk lingkungan yang berbeda (dev, staging, produksi)
• Rotasi setelah gangguanGanti pasangan kunci ketika kunci pribadi dicurigai atau dikonfirmasi telah dibobol; rotasi kalender rutin tidak diperlukan
• Simpan kunci dengan aman Menggunakan sistem manajemen kunci yang tepat

Keamanan Paket

• Selalu verifikasi integritas paket setelah dekripsi
• Pantau untuk pola download yang tidak biasa atau gagal
• Pakai HTTPS untuk semua URL paket (diperlukan untuk aplikasi mobile)
• Implementasikan Pengaturan Error yang Tepat untuk Kegagalan Dekripsi

Kontrol Akses

• Pengaturan Akses Hanya Berikan Akses Kunci Enkripsi kepada Staf yang Berwenang
• Penggunaan Berbasis Peran untuk Operasi Pengelolaan Kunci Pengawasan
• Mengawasi Penggunaan dan Akses Kunci secara Teratur Mengimplementasikan
• Pengaturan Cadangan dan Pengembalian yang Tepat Pengaturan Masalah Enkripsi

Pengaturan Masalah Enkripsi

Masalah Umum

Gagal Dekripsi:

• Pastikan kunci pribadi sesuai dengan kunci publik yang digunakan untuk enkripsi
• Periksa bahwa ivSessionKey benar
• Pastikan Anda menggunakan Enkripsi V2 (V1 tidak lagi didukung)

Gagal Kunci:

• Konfirmasi format kunci pribadi benar (format PEM)
• Pastikan kunci tidak rusak selama penyimpanan/transfer
• Periksa bahwa kunci memiliki izin yang tepat dalam konfigurasi aplikasi Anda

Masalah kinerja:

• Bundle besar mungkin membutuhkan waktu lebih lama untuk dienkripsi/didekripsi
• Pertimbangkan menggunakan Delta (manifest) untuk mengurangi ukuran bundle
• Monitor kinerja perangkat selama proses dekripsi

Perintah Debug

Periksa status enkripsi:

npx @capgo/cli@latest app debug

Uji alur enkripsi/dekripsi:

# Test the complete workflow: zip → encrypt → decrypt → unzip
npx @capgo/cli@latest bundle zip com.example.app --key-v2
npx @capgo/cli@latest bundle encrypt ./com.example.app.zip CHECKSUM --json
npx @capgo/cli@latest bundle decrypt ./encrypted-bundle.zip IV_SESSION_KEY

Ketentuan dan Standar

Implementasi Capgo untuk enkripsi mengikuti standar industri:

• AES-256: Algoritma enkripsi yang disetujui FIPS 140-2
• RSA-4096: Enkripsi asimetris yang kuat untuk perlindungan kunci
• GCM Mode: Memberikan keamanan kekonfidenan dan keaslian
• Random yang Aman: Penghasilan angka acak yang aman secara kriptografi

Hal ini membuat Capgo cocok untuk aplikasi yang memerlukan keterlaksanaan dengan:

• Regulasi Perlindungan Data Umum (GDPR)
• Undang-Undang Kesehatan Asuransi Portabilitas dan Tanggung Jawab (HIPAA)
• Kontrol Layanan Organisasi 2 (SOC 2)
• Manajemen Keamanan Informasi (ISO 27001)

Pertimbangan Kinerja

Biaya Enkripsi

• Ukuran Paket: Paket yang dienkripsi sedikit lebih besar (~1-2% overhead)
• Waktu Proses: Enkripsi/pengekripsi menambahkan ketidakstabilan waktu yang minimal
• Kebutuhan Memori: Peningkatan sementara selama operasi enkripsi/dekripsi

Tips Optimasi

• Gunakan perbaruan Delta (manifest) untuk mengurangi transfer data yang dienkripsi
• Optimalkan ukuran bundle Anda dengan mengonversi gambar ke format WebP
• Minimalkan file JavaScript dan CSS sebelum bundling
• Hapus dependensi yang tidak digunakan dan code
• Monitor kinerja perangkat pada perangkat lama/lebih lambat

Langkah Selanjutnya

• Belajar tentang Penyimpanan Kustom untuk menggunakan enkripsi dengan infrastruktur sendiri Anda
• Explore Saluran context
• untuk mengelola bundle yang dienkripsi di berbagai lingkungan Set up Pengintegrasian CI/CD

context

Teruskan dari Enkripsi Teruskan dari Enkripsi (Judul Bagian) Untuk merencanakan keamanan dan kinerja, hubungkannya dengan Kinerja Untuk detail implementasi di Kinerja, Capgo Scanner Keamanan Untuk alur kerja produk di Capgo Scanner Keamanan, Capgo Keamanan Untuk alur kerja produk di Capgo Keamanan, Capgo Pusat Kepercayaan Untuk alur kerja produk di Capgo Pusat Kepercayaan, dan Keamanan Organisasi Untuk detail implementasi di Keamanan Organisasi.