Vai al contenuto

Bundle criptati

GitHub

Dalla versione 4.15.0, il plugin permette di inviare aggiornamenti crittografati.

Crea una chiave privata
npx @capgo/cli key create
Crea il bundle zip con checksum
npx @capgo/cli bundle zip [appId] --key-v2 --json

Il --key-v2 flag utilizza il nuovo sistema di crittografia con checksum migliori, e il --json flag restituirà le informazioni del bundle, incluso il checksum necessario per la crittografia.

Crittografa il bundle zip con checksum
npx @capgo/cli encrypt [path/to/zip] [checksum]

Il checksum il parametro è il checksum SHA256 generato dal comando zip al punto 2. Il comando encrypt restituirà un ivSessionKey e genererà un checksum criptato. Ricordati di rinominare ivSessionKey la chiave come session_key nel payload dell'update.

Passaggio 4: Usalo nel payload dell'update

Sezione intitolata “Step 4: Use in your update payload”
{
"version": "1.2.3",
"url": "https://myserver.com/app/updates/my-new-app-2.0.0.zip",
"session_key": "encrypted_session_key",
"checksum": "encrypted_checksum_from_encrypt_command"
}

Il session_key è il ivSessionKey restituito dal comando encrypt, e il checksum è il checksum criptato generato durante la cifratura (non il checksum originale del comando zip).

In questo modo, la tua app potrà usare la chiave privata per decriptare il session_key e usare il contenuto decriptato session_key per decriptare l'update. Il checksum criptato garantisce la verifica dell'integrità del bundle.

Se stai usando Bundle criptati per pianificare sicurezza e compliance, collegalo a Usando @capgo/capacitor-updater per la funzionalità nativa in Usando @capgo/capacitor-updater, Crittografia per i dettagli di implementazione della crittografia, Conformità per i dettagli di implementazione in Compliance, Security Scanner di Capgo per il workflow di prodotto in Capgo Security Scanner, e Sicurezza Capgo per il workflow di prodotto in Capgo Security.