L'encryptione

Capgo fornisce una robusta crittografia end-to-end per i pacchetti dell'app, garantendo che il tuo JavaScript code e le tue risorse siano protetti durante la trasmissione e lo storage. Questo sistema di crittografia è progettato per darti il controllo completo sulla sicurezza dell'app mentre mantieni la comodità delle aggiornamenti in tempo reale.

Panoramica

Capgo utilizza metodi crittografici di standard industriale per proteggere i pacchetti da accessi non autorizzati. Quando abilitata la crittografia, i pacchetti vengono crittografati prima di lasciare l'ambiente di sviluppo e rimangono crittografati fino a quando non vengono decrittografati dall'app sul dispositivo dell'utente.

Cosa la Crittografia Protegge Effettivamente: A differenza dei sistemi OTA che firmano solo gli aggiornamenti, Capgo crittografa il pacchetto caricato prima dello storage e della consegna. Ciò protegge i contenuti del pacchetto da accessi casuali in storage o in transito e assicura che solo qualcuno con la tua chiave privata possa produrre un aggiornamento crittografato valido. Ciò non rende impossibile per gli attacchi di reverse engineering le risorse web distribuite: la chiave pubblica utilizzata dal client per decrittografare gli aggiornamenti è distribuita nell'app, quindi un attaccante determinato può ancora estrarla e ispezionare i contenuti del pacchetto con sufficiente sforzo.

Quando Hai Bisogno della Crittografia

If si carichi un bundle senza crittografia, trattalo come un bene pubblico. I canali privati limitano i dispositivi che ricevono un aggiornamento, ma non rendono il bundle caricato confidenziale. La crittografia è utile quando si desidera una protezione migliore in archiviazione e trasporto e quando si desidera che solo i detentori della chiave privata possano pubblicare aggiornamenti crittografati validi. Ciò non garantisce che il JavaScript, l'HTML o il CSS consegnato possa mai essere ispezionato.

Modello di minaccia

Capgo crittografia protegge contro la divulgazione del bundle da Capgo, fornitori di archiviazione, CDN o chiunque veda solo l'artefatto di consegna crittografato. Ciò impedisce anche a terze parti di generare aggiornamenti crittografati validi senza la tua chiave privata. Poiché la chiave pubblica è incorporata nell'applicazione distribuita, in modo che il client possa decrittografare gli aggiornamenti, qualcuno che ha il binario dell'app e abbastanza motivazione può ancora recuperare i materiali di chiave necessari per ispezionare il bundle.

Suggerimento

La crittografia è particolarmente importante per:

• Applicazioni che gestiscono dati sensibili o logica di business
• Applicazioni aziendali con requisiti di conformità
• Applicazioni distribuite in settori regolamentati
• Organizzazioni con politiche di sicurezza rigorose

Come Funziona la Crittografia

Capgo utilizza un approccio di crittografia ibrida che combina la crittografia RSA e AES per una sicurezza e prestazioni ottimali:

1. Generazione della Chiave

• Chiave Privata: Generata e memorizzata in modo sicuro nel tuo ambiente di sviluppo (utilizzata per la crittografia)
• Chiave Pubblica: Derivata dalla tua chiave privata e memorizzata nella configurazione del tuo app Capacitor (utilizzata per la decrittografia)
• Chiavi di Sessione: Chiavi AES casuali generate per ogni caricamento di bundle

2. Processo di Crittografia

1. Viene generato un chiave di sessione AES casuale per ogni caricamento di bundle
2. Il vostro bundle viene crittografato utilizzando la chiave di sessione AES
3. Viene calcolato il checksum del bundle
4. Entrambe la chiave di sessione AES e il checksum vengono crittografati insieme utilizzando la vostra chiave privata RSA (creando la “firma”)
5. Viene memorizzato il bundle crittografato e la firma crittografata

Il checksum viene crittografato insieme alla chiave AES per prevenire la manipolazione. Poiché solo la vostra chiave privata RSA può creare questa firma, e solo la chiave pubblica corrispondente può decrittificarla, ciò garantisce che sia la chiave di sessione AES e il checksum previsto siano autentici e non siano stati modificati da un attaccante.

3. Processo di decrittografia

1. La vostra app scarica il bundle crittografato e la firma crittografata
2. La Capgo SDK utilizza la vostra chiave pubblica RSA (memorizzata nell'app) per decrittografare la firma
3. Questa rivela la chiave di sessione AES e il checksum originale
4. La chiave di sessione AES viene utilizzata per decrittare il pacchetto
5. Si calcola e si confronta un checksum del pacchetto decrittato con il checksum originale per la verifica dell'integrità

Questo processo garantisce che anche se un attaccante intercetta il pacchetto crittografato, non può modificare la chiave di sessione AES o fornire un checksum falso, perché dovrebbe avere la tua chiave privata per creare una firma valida che la chiave pubblica può decrittare

Consiglio

Il RSA non crittografa in modo efficiente grandi quantità di dati, quindi si utilizza l'AES per la crittografia effettiva del pacchetto mentre il RSA protegge la chiave AES e fornisce la verifica dell'integrità attraverso la firma del checksum

Capgo vs Altre Piattaforme

__CAPGO_KEEP_0__	Capgo	Contenuto del pacchetto
__CAPGO_KEEP_0__ vs Altre Piattaforme	Criptato in archiviazione/trasito; ancora esaminabile da un ingegnere di reverse engineering determinato con il binario dell'applicazione	Pubblicamente leggibile
Metodo di Sicurezza	Verifica crittografica end-to-end	Code firma solo
Livello di Privacy	Protezione forte di consegna/archiviazione; non antiriciclaggio	La piattaforma può accedere al tuo code
Protezione	Contenuto + integrità + autenticità	Integrità + autenticità solo

Perché Questo è Importante:

• Code firma verifica solo che gli aggiornamenti non siano stati alterati e provengano dalla fonte giusta
• Capgo crittografia proteggono il bundle mentre è archiviato e distribuito e rendono molto più difficile la creazione di aggiornamenti criptati falsificati, poiché l'attaccante dovrebbe avere la tua chiave privata
• La reverse engineering è ancora possibile dopo che l'app è stata rilasciata, perché il client contiene la chiave pubblica necessaria per decrittare e caricare l'aggiornamento

Metodi di crittografia

Capgo utilizza il metodo di crittografia Encryption V2 come metodo di crittografia standard:

Crittografia V2 (Metodo standard attuale)

• Utilizza RSA-4096 per una maggiore sicurezza
• AES-256-GCM per l'encryptione autenticata
• Fornisce la verifica dell'integrità
• Miglior prestazioni e sicurezza

Encryptione V1 (Deprecated)

• Utilizza RSA-2048 per l'encryptione delle chiavi
• AES-256-CBC per l'encryptione dei bundle
• Non più disponibile nella versione corrente CLI
• Gli app legacy che utilizzano V1 devono migrare a V2

Pericolo

L'encryptione V1 non è più supportata nella versione corrente Capgo CLI. Se stai utilizzando l'encryptione V1, devi migrare a V2. Vedi il Guida di migrazione per istruzioni dettagliate.

Configurazione della crittografia

Passo 1: Genera le chiavi di crittografia

Prima di tutto, genera le tue chiavi di crittografia utilizzando il Capgo CLI:

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

Questo crea:

• .capgo_key_v2: La tua chiave privata (tienila sicura!)
• .capgo_key_v2.pub: La tua chiave pubblica (utilizzata dal tuo app)

Ecco i file creati nella directory corrente in cui esegui il comando.

Attenzione

Note importanti di archiviazione:

• Chiave Privata (.capgo_key_v2): Mai commettere questo in controllo di versione. Questo file dovrebbe essere mantenuto sicuro e utilizzato solo per la crittografia durante gli upload dei pacchetti.
• Chiave Pubblica (.capgo_key_v2.pub): Questo è sicuro da commettere in controllo di versione poiché è un backup della tua chiave pubblica.
• Posizione del File: Le chiavi vengono create nella directory corrente in cui esegui il key create comando.
• Chiave Pubblica nella Config: Deve eseguire key save per memorizzare la chiave pubblica nel suo Capacitor config affinché l'app mobile possa utilizzarla.

Per l'uso di produzione, memorizza la chiave privata in modo sicuro (variabili di ambiente, servizi di gestione delle chiavi) e rimuovila dal tuo progetto locale dopo la configurazione.

Passo 2: Salva la tua chiave pubblica nel Capacitor Config (Obbligatorio)

Lei context 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)

Dopo aver salvato la chiave pubblica, tu devi sync il piattaforma Capacitor per copiare la configurazione aggiornata al layer nativo:

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

Attenzione

Passaggi richiesti:

1. Il key save il comando memorizza la chiave pubblica nella tua configurazione Capacitor
2. npx cap sync copia questa configurazione al layer nativo dove l'app mobile può accedervi
3. Senza entrambi i passaggi, la tua app non potrà decrittare gli aggiornamenti crittografati

Criptando Pacchetti

Metodo 1: Criptare durante l'upload

La via più semplice è quella di criptare durante il processo di upload:

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

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

Metodo 2: Flusso di lavoro di crittografia manuale

Per avere più controllo, puoi criptare manualmente i pacchetti:

1. Creare un pacchetto zip:

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

2. Criptare il bundle:

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

3. Carica nel tuo storage (ad esempio, S3) e registra con 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

Gestione delle chiavi

Archiviazione sicura delle chiavi

Opzioni per la chiave privata:

1. File-based (sviluppo locale):

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

2. Variabile di ambiente (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"

Configurazione della chiave pubblica (obbligatoria):

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

Ambiente di produzione:

• Conserva le chiavi private in servizi di gestione delle chiavi sicure (AWS KMS, Azure Key Vault, ecc.)
• Utilizza la gestione dei segreti CI/CD per le chiavi private
• Non commettere mai le chiavi private nel controllo delle versioni

Utilizzo della chiave:

• Chiave privata: Utilizzata da CLI per l'encryption durante l'upload del pacchetto (mantenere sicuro)
• Chiave pubblica: Memorizzata nella configurazione dell'applicazione per la decrittazione sul dispositivo (sicuro da committare)

Rotare dopo un compromesso della chiave privata

Rotare il coppia di chiavi quando la chiave privata è sospettata o confermata compromessa. Non è richiesta una rotazione calendario regolare. Si tratta di una migrazione della chiave nativa, non di un cambiamento OTA solo.

1. Generare una nuova coppia di chiavi:

   npx @capgo/cli@latest key create

2. Salva la chiave pubblica di sostituzione nel tuo Capacitor config:

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

3. Sincronizza e distribuisci una versione nativa: Esegui npx cap sync, quindi distribuisci una nuova versione di app nativa contenente la chiave pubblica di sostituzione.

4. Seleziona la nuova versione nativa: I dispositivi che ancora eseguono la versione binaria nativa vecchia non possono decrittografare gli aggiornamenti crittografati con la chiave di sostituzione. Utilizza Targeting della versione context

5. Utilizza il Targeting della versione per limitare i pacchetti con la chiave di sostituzione alla nuova versione nativa mentre il resto della flotta si aggiorna attraverso la store o MDM. Sostituisci il segreto di caricamento:

Attenzione

Se la chiave privata è compromessa, smettete di utilizzarla immediatamente. Le installazioni esistenti con la vecchia chiave pubblica necessitano di un aggiornamento del magazzino nativo o MDM prima di poter ricevere pacchetti crittografati con la chiave di sostituzione.

Pratiche di Sicurezza

Sicurezza delle Chiavi

• Non condividere mai le chiavi private tra ambienti o membri del team
• Utilizzare chiavi diverse per ambienti diversi (dev, staging, production)
• Rimuovere dopo un compromesso: sostituisci la coppia di chiavi quando la chiave privata è sospettata o confermata compromessa; non è richiesta una routine di rotazione del calendario;
• Conserva le chiavi in modo sicuro utilizzando sistemi di gestione delle chiavi adeguati

Sicurezza del Bundle

• Verifica sempre l'integrità del bundle dopo la decrittografia
• Monitora per i pattern di download insoliti o gli errori
• Usa HTTPS per tutte le URL del bundle (richiesto per le app mobili)
• Implementa gestione degli errori corretta per le fallite di decrittazione

Controllo dell'accesso

• Limitare l'accesso ai chiavi di crittografia solo ai personale autorizzato
• Utilizzare il controllo dei ruoli per le operazioni di gestione delle chiavi
• Monitoraggio l'uso e l'accesso alle chiavi regolarmente
• Implementare procedure di backup e ripristino corrette

Risolvere i problemi di crittografia

Issue comuni

Fallimenti di decrittazione:

• Verifica che la chiave privata corrisponda alla chiave pubblica utilizzata per la crittografia
• Controlla che il ivSessionKey è corretto
• Assicurati di utilizzare la crittografia V2 (V1 non è più supportata)

Errori legati alla chiave:

• Conferma che il formato della chiave privata è corretto (formato PEM)
• Verifica che la chiave non sia stata corrotta durante lo storage o la trasferimento
• Controlla che la chiave abbia le autorizzazioni corrette nella configurazione del tuo app

Problemi di prestazioni:

• I pacchetti grandi possono richiedere più tempo per l'encryptazione/decrittazione
• Considera l'utilizzo delle aggiornamenti Delta (manifest) per ridurre le dimensioni dei pacchetti
• Monitorare le prestazioni del dispositivo durante la decrittazione

Comandi di debug

Verifica lo stato di crittografia:

npx @capgo/cli@latest app debug

Testa il flusso di crittografia/decrittazione:

# 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

Conformità e Standard

L'implementazione di Capgo di crittografia segue gli standard dell'industria:

• AES-256: Algoritmo di crittografia approvato da FIPS 140-2
• RSA-4096: Crittografia asimmetrica forte per la protezione delle chiavi
• Modalità GCM: Fornisce sia la confidenzialità che l'autenticità
• Casuale Sicuro: Generazione di numeri casuali criptograficamente sicuri

Ciò rende Capgo adatto per le applicazioni che richiedono la conformità con:

• Regolamento generale sulla protezione dei dati (GDPR)
• Legge sulla portabilità e sulla responsabilità assicurativa per la salute (HIPAA)
• Controllo SOC 2 (Service Organization Control 2)
• ISO 27001 (Gestione della sicurezza dell'informazione)

Considerazioni di prestazioni

Carico di crittografia

• Dimensione del pacchetto: I pacchetti crittografati sono leggermente più grandi (~1-2% di sovraccarico)
• Tempo di elaborazione: La crittografia/decriptazione aggiunge una latenza minima
• Utilizzo della memoria: Aumento temporaneo durante le operazioni di cifratura/decifratura

Consigli di ottimizzazione

• Utilizza gli aggiornamenti Delta (manifesto) per ridurre il trasferimento di dati cifrati
• Optimizza il tuo bundle di dimensioni convertendo le immagini in formato WebP
• Minimizza i file JavaScript e CSS prima di compilarli
• Elimina le dipendenze non utilizzate e code
• Monitora le prestazioni del dispositivo su dispositivi più vecchi/lenti

Passaggi successivi

• Scopri Storage personalizzato per utilizzare l'encryption con la tua infrastruttura
• Esplora Canali context:Canali del rilascio Capgo. Pagina/Area: Pagina di marketing delle soluzioni Capgo. Ruolo: Etichetta UI breve o elemento di navigazione. Visto in: pagina soluzioni/white-label.astro. Chiave messaggio `solutions_white_label_visual_cell2_value` (Valore cella visiva White Label Solutions).
• per gestire i pacchetti crittografati all'interno di ambienti diversi Configura Integrazione CI/CD

context:Pagina/Area: Pagina del prodotto Capgo Builder / prodotto di costruzione nativa cloud. Ruolo: Etichetta UI breve o elemento di navigazione. Chiave messaggio `native_build_feature_ci_cd` (Funzione di costruzione nativa Ci Cd).

Continua da qui dall'Encryption Sottosezione intitolata “Continua da qui dall'Encryption” (Keep going from Encryption). per pianificare la sicurezza e la conformità, connettilo con Conformità per i dettagli di implementazione in Conformità Capgo Scansionatore di Sicurezza per il flusso di lavoro del prodotto in Capgo Scansionatore di Sicurezza Capgo Sicurezza per il flusso di lavoro del prodotto in Capgo Sicurezza Capgo Centro di fiducia per il flusso di lavoro del prodotto in Capgo Centro di fiducia, e Sicurezza dell'Organizzazione per i dettagli di implementazione in Sicurezza dell'Organizzazione