Enkripsi

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

Ringkasan

Sistem enkripsi Capgo menggunakan metode kriptografi standar industri untuk melindungi bundle Anda dari akses tidak sah. Ketika enkripsi diaktifkan, bundle Anda dienkripsi sebelum meninggalkan lingkungan pengembangan Anda dan tetap dienkripsi hingga diuraikan 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 yang memiliki kunci pribadi Anda yang dapat menghasilkan pembaruan enkripsi yang valid. Ini tidak membuat aset web yang dikirimkan tidak mungkin direkayasa ulang: kunci publik yang digunakan oleh klien untuk menguraikan 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 bundle tanpa enkripsi, anggaplah sebagai aset publik. Saluran pribadi membatasi perangkat mana yang menerima pembaruan, tetapi tidak membuat bundle yang diunggah rahasia. Enkripsi berguna ketika Anda ingin melindungi lebih baik dalam penyimpanan dan transit dan ketika Anda ingin hanya pemegang kunci pribadi yang dapat menerbitkan pembaruan enkripsi yang valid. Ini tidak menjamin bahwa JavaScript, HTML, atau CSS yang dikirimkan tidak dapat diinspeksi.

Model Ancaman

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

Tip

__CAPGO_KEEP_0__ sangat penting untuk:

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

Bagaimana Pengenkripsi Bekerja

Capgo menggunakan pendekatan pengenkripsi hybrid yang menggabungkan RSA dan AES pengenkripsi 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 aplikasi Anda Capacitor (digunakan untuk dekripsi)
• Kunci Sesi: Kunci AES acak yang dihasilkan untuk setiap unggahan bundle

2. Proses Enkripsi

1. Kunci Sesi AES acak dihasilkan 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 adalah autentik dan belum diubah oleh penyerang.

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. Tanda tangan ini mengungkapkan kunci sesi AES dan checksum asli
4. Kunci sesi AES digunakan untuk memecahkan bundle
5. Checksum dari bundle yang diuraikan dihitung dan dibandingkan dengan checksum asli untuk verifikasi integritas

Proses ini memastikan bahwa bahkan jika penyerang menginterupsi bundle yang dienkripsi, mereka tidak dapat mengubah kunci sesi AES atau menyediakan checksum palsu, karena mereka memerlukan kunci pribadi untuk membuat tanda tangan yang valid yang dapat dipecahkan oleh kunci publik.

Tips

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

Capgo vs Other Platforms

Fitur	Capgo	Lainnya Platform OTA
Isi Bundle	Ditambahkan dalam penyimpanan/transit; masih dapat diperiksa oleh seorang pengekang balik dengan kode aplikasi	Akses Dapat Dilihat Publik
Metode Keamanan	Enkripsi akhir-ke-akhir yang benar	Code hanya tanda tangan
Level Privasi	Pelindungan pengiriman/simpanan yang kuat; bukan anti-reversi-engineering	Platform dapat mengakses code Anda
Pelindungan	Konten + integritas + keaslian	Hanya integritas + keaslian

Mengapa Ini Penting:

• Code hanya tanda tangan hanya memastikan bahwa pembaruan tidak telah dimanipulasi dan berasal dari sumber yang tepat
• Capgo enkripsi melindungi paket saat disimpan dan dikirimkan serta membuat pembaruan yang terenkripsi palsu menjadi lebih sulit karena penyerang memerlukan kunci pribadi Anda
• Reversi engineering masih mungkin setelah aplikasi dikirimkan, karena klien mengandung kunci publik yang diperlukan untuk mendekripsi dan memuat pembaruan

Metode Pengenkripsi

Capgo menggunakan Metode Pengenkripsi V2 sebagai metode pengenkripsi standar:

Metode Pengenkripsi V2 (Standar Saat Ini)

• Uses RSA-4096 for enhanced security
• AES-256-GCM untuk enkripsi yang terotentikasi
• Memberikan verifikasi integritas
• Kinerja yang lebih baik dan keamanan

Enkripsi V1 (Tidak Aktif)

• Menggunakan RSA-2048 untuk enkripsi kunci
• Menggunakan 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 panduan pemindahan untuk instruksi yang rinci. Pengaturan Enkripsi

Pengaturan Enkripsi

Langkah 1: Membuat Kunci Enkripsi

Pertama-tama, 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 keamanannya!)
• .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 Penyimpanan Penting:

• Kunci Pribadi (.capgo_key_v2): Jangan pernah memasukkannya ke dalam pengawasan 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 dalam pengawasan versi karena itu adalah salinan kunci publik Anda.
• Lokasi File: Kunci-kunci ini dibuat di direktori saat ini di mana Anda menjalankan key create Perintah.
• Kunci Publik di Konfigurasi: Anda harus menjalankan key save untuk menyimpan kunci publik di konfigurasi Capacitor Anda untuk aplikasi seluler dapat menggunakan.

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 Capacitor Konfigurasi (Wajib)

You must Simpan kunci publik Anda ke konfigurasi Capacitor agar aplikasi seluler dapat mendekripsi bundle.

# 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"

Langkah 3: Sinkronkan Platform Capacitor (Wajib)

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

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

Peringatan

Langkah-Langkah yang Diperlukan:

1. Perlu key save Perintah menyimpan kunci publik di konfigurasi Anda Capacitor
2. npx cap sync Menyalin konfigurasi ini ke lapisan native di mana aplikasi seluler dapat mengaksesnya
3. Tidak ada kedua langkah ini, aplikasi Anda tidak akan dapat mengenkripsi pembaruan yang dienkripsi

Pengenkapan Paket

Metode 1: Mengenkripsi Selama Unggahan

Metode 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)

Metode 2: Alur Enkripsi Manual

Untuk kontrol yang lebih baik, Anda dapat mengenkripsi bundle secara manual:

1. Buatlah bundle 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

Pengelolaan Kunci

Mengimpan Kunci dengan Aman

Pilihan Kunci Pribadi:

1. Berbasis File (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"

Pengaturan 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.)
• Gunakan manajemen rahasia CI/CD untuk kunci pribadi
• Jangan pernah komit kunci pribadi ke pengontrol versi

Penggunaan Kunci:

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

Putuskan Kunci Setelah Kompromi Kunci Pribadi

Putuskan pasang kunci ketika kunci pribadi dicurigai atau dikonfirmasi telah dikompromi. 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 kirim rilis native: Jalankan npx cap syncKunci pengganti dan distribusikan aplikasi native baru yang berisi kunci publik pengganti.

4. Targetkan versi native baru: Perangkat yang masih menjalankan biner native lama tidak dapat mengenkripsi pembaruan yang dienkripsi dengan kunci pengganti. Gunakan Target Versi Mengatur untuk membatasi penggantian kunci pengganti ke versi native baru sementara sisanya dari armada memperbarui melalui toko atau MDM.

5. Ganti rahasia unggah: Secepatnya, ganti kunci privat di CI dan unggah hanya paket yang ditargetkan ke versi native yang berisi kunci publik pengganti.

Peringatan

Jika kunci privat terkorbankan, berhentilah menggunakan kunci tersebut segera. Instalasi yang sudah ada dengan kunci publik lama memerlukan pembaruan native dari toko atau MDM sebelum mereka dapat menerima paket yang dienkripsi dengan kunci pengganti.

Praktik Keamanan Terbaik

Keamanan Utama

• Jangan pernah berbagi kunci pribadi antara lingkungan atau anggota tim
• Pakai kunci yang berbeda untuk lingkungan yang berbeda (dev, staging, produksi)
• Rotasi setelah kompromiGanti pasangannya kunci saat kunci pribadi dicurigai atau dikonfirmasi bocor; 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
• Gunakan HTTPS untuk semua URL paket (diperlukan untuk aplikasi mobile)
• Implementasikan pengelolaan kesalahan yang tepat untuk gagal dekripsi

Kontrol Akses

• Limits akses ke kunci enkripsi hanya untuk staf yang berwenang
• Pakai akses berdasarkan peran untuk operasi manajemen kunci
• Audit penggunaan dan akses kunci secara teratur
• Implementasikan prosedur backup dan pemulihan yang tepat

Pengaturan Enkripsi yang Tidak Berfungsi

Issues 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 terkait 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

Issue kinerja:

• Large bundles may take longer to encrypt/decrypt
• Consider menggunakan Delta update untuk mengurangi ukuran bundle
• Monitor kinerja perangkat selama proses dekripsi

Perintah Debug

Periksa status enkripsi:

npx @capgo/cli@latest app debug

Uji alur kerja 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

Capgo’s implementasi enkripsi mengikuti standar industri:

• AES-256: Algoritma enkripsi yang disetujui FIPS 140-2
• RSA-4096: Enkripsi asimetris yang kuat untuk perlindungan kunci
• Mode GCM: Menyediakan keamanan kepercayaan dan keaslian
• Angka Acak yang Aman: Penghasilan angka acak yang aman kriptografis

Ini membuat Capgo cocok untuk aplikasi yang memerlukan kinerja sesuai dengan:

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

Konsiderasi Kinerja

Biaya Enkripsi

• Ukuran Paket: Paket yang dienkripsi sedikit lebih besar (~1-2% overhead)
• Waktu Proses: Penambahan latensi yang minimal karena enkripsi/pengekripsi
• Penggunaan Memori: Peningkatan sementara selama operasi enkripsi/pengekripsi

Tips Optimalisasi

• Pilih Delta update untuk mengurangi transfer data yang terenkripsi
• Optimalkan ukuran bundle Anda dengan mengonversi gambar ke format WebP
• Minimalkan file JavaScript dan CSS sebelum melakukan bundling
• Hapus dependensi yang tidak digunakan dan code
• Periksa kinerja perangkat pada perangkat yang lebih tua/lambat

Next Steps

• Belajar tentang Penggunaan Penyimpanan Pribadi untuk menggunakan enkripsi dengan infrastruktur sendiri Anda
• Kunjungi Saluran Untuk mengelola paket yang dienkripsi di berbagai lingkungan
• Pasang Pengintegrasian CI/CD Untuk mengautomasi pengiriman yang dienkripsi

Teruskan dari Enkripsi

Jika Anda menggunakan Enkripsi untuk merencanakan keamanan dan ketercapaian, hubungkannya dengan Ketercapaian untuk detail implementasi di Ketercapaian, Keamanan Scanner Capgo untuk alur kerja produk di Keamanan Scanner Capgo Keamanan Capgo untuk alur kerja produk di Keamanan Capgo Pusat Kepercayaan Capgo untuk alur kerja produk di Pusat Kepercayaan Capgo, dan Keamanan Organisasi untuk detail implementasi di Keamanan Organisasi.