Aller au contenu

Bundles chiffrés

GitHub

À partir de la version 4.15.0, le plugin vous permet d'envoyer des mises à jour chiffrées.

Créer une clé privée
npx @capgo/cli key create
Créer le zip du bundle avec checksum
npx @capgo/cli bundle zip [appId] --key-v2 --json

Le --key-v2 flag utilise le nouveau système de chiffrement avec de meilleurs checksums, et le --json flag affichera les informations du bundle, y compris le checksum nécessaire au chiffrement.

Chiffrer le zip du bundle avec checksum
npx @capgo/cli encrypt [path/to/zip] [checksum]

Le checksum paramètre est le checksum SHA256 généré par la commande zip à l'étape 2. La commande encrypt retournera un ivSessionKey et générera un checksum chiffré. N'oubliez pas de renommer ivSessionKey la clé en session_key dans le payload de la mise à jour.

{
"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"
}

Le session_key est le ivSessionKey retourné par la commande encrypt, et le checksum est le checksum chiffré généré lors du chiffrement (et non le checksum original de la commande zip).

Ensuite, votre application pourra utiliser la clé privée pour déchiffrer le session_key et utilisez le contenu décrypté session_key pour décrypter la mise à jour. Le checksum chiffré garantit la vérification de l'intégrité du bundle.

Si vous utilisez Bundles chiffrés pour planifier la sécurité et la conformité, connectez-l’à Utiliser @capgo/capacitor-updater pour la capacité native dans « Utiliser @capgo/capacitor-updater », Chiffrement pour les détails d'implémentation du chiffrement, Conformité pour les détails d'implémentation de la conformité, Scanner de sécurité Capgo pour le workflow produit dans Capgo Security Scanner, et Capgo et la sécurité pour le workflow produit dans Capgo Security.