Saltar al contenido

Bundles cifrados

GitHub

A partir de la versión 4.15.0, el plugin permite enviar actualizaciones cifradas.

Crear una clave privada
npx @capgo/cli key create
Crear el zip del bundle con checksum
npx @capgo/cli bundle zip [appId] --key-v2 --json

El --key-v2 flag usa el nuevo sistema de cifrado con mejores checksums, y el --json flag mostrará la información del bundle, incluyendo el checksum necesario para el cifrado.

Cifrar el zip del bundle con checksum
npx @capgo/cli encrypt [path/to/zip] [checksum]

El checksum parámetro es el checksum SHA256 generado por el comando zip en el paso 2. El comando encrypt devolverá un ivSessionKey y generará un checksum cifrado. Recuerda renombrar la ivSessionKey key como session_key en el payload de la actualización.

Paso 4: Úsalo en el payload de tu actualización

Sección titulada “Paso 4: Úsalo en tu payload de actualización”
{
"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"
}

El session_key es el ivSessionKey devuelto por el comando encrypt, y el checksum es el checksum cifrado generado durante el cifrado (no el checksum original del comando zip).

Luego, tu app podrá usar la clave privada para descifrar el session_key y usar el contenido descifrado session_key para descifrar la actualización. El checksum cifrado garantiza la verificación de integridad del bundle.

Si estás usando Bundles cifrados para planificar la seguridad y el cumplimiento, conéctalo con Al usar @capgo/capacitor-updater para la funcionalidad nativa al usar @capgo/capacitor-updater, Cifrado para los detalles de implementación en Cifrado, Cumplimiento para los detalles de implementación en Cumplimiento, Escáner de seguridad de Capgo para el flujo de trabajo del producto en Capgo Security Scanner, y Seguridad de Capgo para el flujo de trabajo del producto en Capgo Security.