Almacenamiento Personalizado

Capgo admite soluciones de almacenamiento personalizadas para sus paquetes de la aplicación, lo que le permite alojar sus actualizaciones en su propia infraestructura o servicios de almacenamiento de terceros. Esto es particularmente útil para organizaciones con requisitos de seguridad específicos, necesidades de cumplimiento o infraestructura de almacenamiento existente.

Resumen

El almacenamiento personalizado en Capgo funciona subiendo tu paquete a una ubicación externa y proporcionando a Capgo la URL para acceder a él. El Capgo SDK descargará actualizaciones directamente desde tu ubicación de almacenamiento personalizado en lugar de la almacenamiento en la nube predeterminada de Capgo.

Consejo

El almacenamiento personalizado es ideal para:

• Organizaciones con requisitos de residencia de datos estrictos
• Equipos con infraestructura de CDN o almacenamiento existente
• Aplicaciones que requieren capas de seguridad adicionales
• Optimización de costos para tamaños de paquetes grandes

Subida de URL externa

La forma más sencilla de utilizar almacenamiento personalizado es subiendo tu paquete a cualquier URL accesible públicamente y proporcionando esa URL a Capgo.

Subida de URL externa básica

npx @capgo/cli@latest bundle upload --external https://your-domain.com/bundles/v1.2.3.zip

Este comando le dice a Capgo que refiera el paquete en la URL especificada en lugar de subirlo a la almacenamiento en la nube de Capgo.

Con cifrado

Para almacenamiento externo seguro, puede cifrar su paquete y proporcionar las claves de descifrado:

npx @capgo/cli@latest bundle upload --external https://your-domain.com/bundles/v1.2.3.zip --iv-session-key YOUR_IV_SESSION_KEY

Integración de S3

Capgo ofrece soporte integrado para Amazon S3 y servicios de almacenamiento S3 compatibles. El CLI puede subir automáticamente su paquete a S3 y configurar Capgo para utilizar la URL de S3.

S3 Opciones de subida

npx @capgo/cli@latest bundle upload \
  --s3-region us-east-1 \
  --s3-apikey YOUR_ACCESS_KEY \
  --s3-apisecret YOUR_SECRET_KEY \
  --s3-bucket-name your-bucket-name

Configuración S3 completa

Para servicios compatibles con S3 o puntos finales personalizados:

npx @capgo/cli@latest bundle upload \
  --s3-region us-east-1 \
  --s3-apikey YOUR_ACCESS_KEY \
  --s3-apisecret YOUR_SECRET_KEY \
  --s3-endpoint https://s3.your-provider.com \
  --s3-bucket-name your-bucket-name \
  --s3-port 443 \
  --no-s3-ssl  # Only if your endpoint doesn't support SSL

Parámetros de configuración S3

Parámetro	Descripción	Requerido
--s3-region	Región de AWS para tu contenedor S3	Sí
--s3-apikey	ID de clave de acceso de S3	Sí
--s3-apisecret	Clave secreta de acceso de S3	Sí
--s3-bucket-name	Nombre de tu contenedor S3	Sí
--s3-endpoint	URL personalizada de tu contenedor S3	No
--s3-port	Puerto para el punto final de S3	No
--no-s3-ssl	Deshabilitar SSL para la carga de S3	No

Preparación y cifrado del paquete

Al utilizar almacenamiento personalizado, especialmente con cifrado, es necesario preparar adecuadamente sus paquetes. Esto implica crear un archivo zip y cifrarlo opcionalmente.

Paso 1: Crear un paquete Zip

Primero, cree un archivo zip de su paquete de la aplicación:

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

El comando zip devolverá el checksum del archivo zip. Puede utilizar este checksum para cifrar el archivo zip si es necesario. Utilice la --json opción para obtener un resultado estructurado que incluya el checksum.

Opciones del comando Zip

npx @capgo/cli@latest bundle zip [appId] \
  --path ./dist \
  --bundle 1.2.3 \
  --name myapp-v1.2.3 \
  --json \
  --no-code-check \
  --key-v2 \
  --package-json ../../package.json,./package.json

Opción	Descripción
--path	Ruta al folder a zip (por defecto es webDir de capacitor.config)
--bundle	Número de versión del paquete para nombrar el archivo zip
--name	Nombre personalizado para el archivo zip
--json	Los resultados se muestran en formato JSON (incluye checksum)
--no-code-check	Saltar la comprobación de la llamada a notifyAppReady() y el archivo de índice
--key-v2	Usar cifrado v2
--package-json	Rutas a archivos package.json para proyectos monorepos (separadas por comas)

Paso 2: Cifrar el Bundle (opcional)

Para una mayor seguridad, cifre su archivo zip antes de subirlo:

# Using default local key
npx @capgo/cli@latest bundle encrypt ./myapp.zip CHECKSUM

# Using custom key file
npx @capgo/cli@latest bundle encrypt ./myapp.zip CHECKSUM --key ./path/to/.capgo_key_v2

# Using key data directly
npx @capgo/cli@latest bundle encrypt ./myapp.zip CHECKSUM --key-data "PRIVATE_KEY_CONTENT"

El CHECKSUM El parámetro es obligatorio y debe ser el checksum de su archivo zip. Puede obtener el checksum del comando zip (use --json opción para salida estructurada)

Por defecto, el comando de cifrado utilizará su clave de firma privada local. Puede especificar una clave personalizada utilizando el --key o --key-data o

El comando de cifrado devolverá los ivSessionKey necesarios para la subida o la desifrado.

Opciones del comando de cifrado

Opción	Descripción
zipPath	Ruta del archivo zip a cifrar (obligatorio)
checksum	Checksum del archivo zip (obligatorio) - obténlo del comando zip
--key	Ruta personalizada para la clave de firma privada (opcional, utiliza la clave local por defecto)
--key-data	Datos de clave de firma privada directamente (opcional)
--json	Los resultados se muestran en formato JSON

Advertencia

El comando de cifrado emitirá un ivSessionKey que necesitarás proporcionar al subir con la --iv-session-key Opción

Ejemplos de flujo de trabajo completos

Ejemplo 1: URL externa con cifrado

1. Construye tu aplicación:

   npm run build

2. Crear un paquete zip:

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

   Nota el checksum devuelto por este comando.

3. Cifrar el paquete:

   npx @capgo/cli@latest bundle encrypt ./com.example.app-1.2.3.zip CHECKSUM_FROM_STEP_2

   Nota el ivSessionKey desde la salida.

4. Subir a tu almacenamiento: Subir el archivo zip cifrado a su servicio de alojamiento.

5. Registrese con Capgo:

   npx @capgo/cli@latest bundle upload \
     --external https://your-cdn.com/bundles/com.example.app-1.2.3.zip \
     --iv-session-key IV_SESSION_KEY_FROM_STEP_3

Ejemplo 2: Carga directa a S3

1. Construya su aplicación:

   npm run build

2. Cargar directamente a S3:

   npx @capgo/cli@latest bundle upload \
     --s3-region us-west-2 \
     --s3-apikey YOUR_ACCESS_KEY \
     --s3-apisecret YOUR_SECRET_KEY \
     --s3-bucket-name your-app-bundles \
     --channel Production

Exampleo 3: S3 con cifrado

1. Construye y comprime:

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

2. Cifra el paquete:

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

3. Subir a S3 con cifrado:

   npx @capgo/cli@latest bundle upload \
     --s3-region us-west-2 \
     --s3-apikey YOUR_ACCESS_KEY \
     --s3-apisecret YOUR_SECRET_KEY \
     --s3-bucket-name your-app-bundles \
     --iv-session-key IV_SESSION_KEY_FROM_STEP_2 \
     --channel Production

Consideraciones de seguridad

Cuando utilices almacenamiento personalizado, considera estas mejores prácticas de seguridad:

Control de acceso

• Asegúrate de que las URL de almacenamiento sean accesibles para los usuarios de tu aplicación, pero no descubribles públicamente
• Utiliza URLs firmadas o autenticación basada en tokens cuando sea posible
• Implementa encabezados CORS adecuados para aplicaciones web

Cifrado

• Siempre cifra paquetes sensibles utilizando las herramientas de cifrado Capgo
• Almacena claves de cifrado de manera segura y rotarlas regularmente
• Utiliza HTTPS para todas las URL de paquetes (requerido para aplicaciones móviles y Electron)

Monitoreo

• Monitoree los registros de acceso para detectar patrones de descarga inusuales
• Configura alertas para descargas de paquetes fallidas
• Realiza auditorías periódicas de permisos de almacenamiento

Solución de problemas

Problemas comunes

No se está descargando el paquete:

• Verifica que la URL sea accesible públicamente y utilice HTTPS (requerido para aplicaciones móviles y Electron)
• Verifica los encabezados CORS para aplicaciones web
• Asegúrese de que el formato del paquete sea correcto

Errores de cifrado:

• Verifique el ivSessionKey coincide con el paquete cifrado
• Verifique que el paquete se cifró con la clave correcta
• Asegúrese de que se utilice cifrado v2 para nuevos paquetes

Fallas de carga en S3:

• Verifique sus credenciales y permisos de S3
• Verifique las políticas de contenedor y la configuración de CORS
• Asegúrese de que la región especificada sea correcta

Comandos de depuración

Ver el estado del paquete:

npx @capgo/cli@latest app debug

Verificar la integridad del paquete:

npx @capgo/cli@latest bundle list

Pasos siguientes

• Aprende sobre Canales para gestionar diferentes entornos de despliegue
• Explora Comportamiento de Actualización para personalizar cómo se aplican las actualizaciones
• Configura Integración CI/CD contexto: Página/área: Capgo Builder / producto de construcción nativa de la nube. Rol: Etiqueta de IU breve o elemento de navegación. Clave de mensaje `native_build_feature_ci_cd` (Native Build Feature Ci Cd).

para automatizar tu flujo de trabajo de almacenamiento personalizado

Título de sección “Sigue adelante desde Almacenamiento Personalizado” Si estás utilizando Almacenamiento Personalizado para planificar la seguridad y la conformidad, conecta con Cifrado de datos (Encryption de datos) para los detalles de implementación en Cifrado de datos (Encryption de datos), Compliance para los detalles de implementación en Compliance Capgo Escáner de Seguridad para el flujo de trabajo del producto en Capgo Escáner de Seguridad Capgo Seguridad para el flujo de trabajo del producto en Capgo Seguridad, y Capgo Centro de Confianza para el flujo de trabajo del producto en Capgo Centro de Confianza.