Archiviazione Personalizzata

Capgo supports custom storage solutions for your app bundles, allowing you to host your updates on your own infrastructure or third-party storage services. This is particularly useful for organizations with specific security requirements, compliance needs, or existing storage infrastructure.

Overview

La memorizzazione personalizzata in Capgo funziona caricando il tuo bundle in un'ubicazione esterna e fornendo a Capgo l'URL per accedervi. Il Capgo SDK scaricherà quindi gli aggiornamenti direttamente dalla tua posizione di memorizzazione personalizzata anziché dalla memorizzazione cloud di Capgo per impostazione predefinita.

Consiglio

La memorizzazione personalizzata è ideale per:

• Organizzazioni con requisiti di residenza dei dati rigorosi
• Team con infrastruttura CDN o di archiviazione esistente
• Applicazioni che richiedono strati di sicurezza aggiuntivi
• Optimizzazione dei costi per dimensioni di bundle elevate

Caricamento di URL esterno

La via più semplice per utilizzare la memorizzazione personalizzata è caricare il tuo bundle in qualsiasi URL accessibile pubblicamente e fornire quell'URL a Capgo.

Caricamento URL Esterno Base

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

Questo comando dice a Capgo di riferirsi al bundle al URL specificato invece di caricarlo nel cloud storage di Capgo’.

Con Crittografia

Per un storage esterno sicuro, puoi crittografare il tuo bundle e fornire le chiavi di decrittografia:

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

Integrazione S3

Capgo fornisce supporto integrato per Amazon S3 e servizi di archiviazione S3 compatibili. Il CLI può caricare automaticamente il tuo bundle su S3 e configurare Capgo per utilizzare l'URL di S3.

S3 Upload Options

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

Configurazione S3 completa

Per servizi di archiviazione S3 compatibili o endpoint personalizzati:

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

Parametri di configurazione S3

Parametro	Descrizione	Richiesto
--s3-region	Regione AWS per il tuo bucket S3	Sì
--s3-apikey	ID chiave di accesso S3	Sì
--s3-apisecret	Chiave segreta di accesso S3	Sì
--s3-bucket-name	Nome del tuo bucket S3	Sì
--s3-endpoint	URL personalizzato del tuo endpoint S3	No
--s3-port	Porta per endpoint S3	No
--no-s3-ssl	Disabilita SSL per caricamento S3	No

Preparazione e crittografia del pacchetto

Quando si utilizza un archivio di storage personalizzato, soprattutto con crittografia, è necessario preparare correttamente i pacchetti. Ciò comporta la creazione di un file zip e la crittografia facoltativa.

Passo 1: Crea un pacchetto Zip

In primo luogo, crea un file zip del tuo bundle di app:

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

Il comando zip restituirà il checksum del file zip. Puoi utilizzare questo checksum per cifrare il file zip se necessario. Utilizza l' --json opzione per ottenere un output strutturato che include il checksum.

Opzioni 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

Opzione	Descrizione
--path	Percorso del folder da zip (predefinito a webDir da capacitor.config)
--bundle	Numero di versione del bundle per denominare il file zip
--name	Nome personalizzato per il file zip
--json	I risultati di output sono in formato JSON (incluso checksum)
--no-code-check	Saltare la verifica della chiamata a notifyAppReady() e dell'indice del file
--key-v2	Usare l'encryption v2
--package-json	Periferiche per file package.json per progetti monorepo (separate da virgola)

Passo 2: Criptare il Bundle (Facoltativo)

Per una maggiore sicurezza, criptate il vostro bundle zip prima di caricarlo:

# 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"

Il CHECKSUM il parametro è richiesto e dovrebbe essere il checksum del vostro file zip. Potete ottenere il checksum dalla output del comando zip (utilizzare l'opzione per output strutturato). --json Output results in JSON format (includes checksum)

By default, the encrypt command will use your local private signing key. You can specify a custom key using the --key o --key-data o

o ivSessionKey o

o

o	o
zipPath	o
checksum	o
--key	o
--key-data	Dati di chiave di firma privata direttamente (facoltativo)
--json	I risultati vengono visualizzati in formato JSON

Attenzione

Il comando di crittografia produrrà un ivSessionKey che dovrai fornire quando carichi con l' --iv-session-key Esempi di Flussi di Lavoro Completi

Sezione intitolata “Esempi di Flussi di Lavoro Completi”

Sezione intitolata “Esempio 1: URL esterno con crittografia”

1. Esempio 1: URL esterno con crittografia

   npm run build

2. Crea un bundle zip:

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

   Nota il checksum restituito da questo comando.

3. Crittografa il bundle:

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

   Nota il ivSessionKey dalla finestra di output.

4. Carica sul tuo storage: Carica il file zip cifrato sul tuo servizio di hosting.

5. Registra 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

Esempio 2: Carica direttamente su S3

1. Costruisci il tuo app:

   npm run build

2. Carica direttamente su 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

Esempio 3: S3 con crittografia

1. Costruisci e zip:

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

2. Crittografa il bundle:

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

3. Carica su S3 con crittografia:

   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

Considerazioni di sicurezza

Quando si utilizza lo storage personalizzato, considerare queste migliori pratiche di sicurezza:

Controllo degli accessi

• Assicurarsi che le URL di storage siano accessibili agli utenti dell'applicazione ma non scopribili pubblicamente
• Utilizzare URL firmati o autenticazione basata su token quando possibile
• Implementare i header CORS appropriati per le app basate su web

Crittografia

• Assicurarsi sempre di crittografare i pacchetti sensibili utilizzando gli strumenti di crittografia Capgo
• Memorizzare le chiavi di crittografia in modo sicuro e rotarle regolarmente
• Utilizzare HTTPS per tutte le URL dei pacchetti (richiesto per le app mobili e Electron)

Monitoraggio

• Monitorare i log di accesso per rilevare modelli di download anomali
• Configura gli avvisi per i download di bundle falliti
• Verifica regolarmente le autorizzazioni di archiviazione

Risoluzione dei problemi

Issue comuni

Il bundle non si sta scaricando:

• Verifica che l'URL sia accessibile pubblicamente e utilizza HTTPS (richiesto per le app mobili e Electron)
• Controlla i header CORS per le app web
• Assicurarsi che il formato del bundle sia corretto

Errori di crittografia:

• Verifica il ivSessionKey corrisponde al bundle crittografato
• Verifica che il bundle sia stato crittografato con la chiave corretta
• Assicurarsi che venga utilizzata la crittografia v2 per i nuovi bundle

Fallimenti nell'upload su S3:

• Verifica le tue credenziali e le autorizzazioni S3
• Verifica le politiche del bucket e la configurazione CORS
• Assicurarsi che la regione specificata sia corretta

Comandi di debug

Controlla lo stato del pacchetto:

npx @capgo/cli@latest app debug

Verifica l'integrità del pacchetto:

npx @capgo/cli@latest bundle list

Passaggi successivi

• Scopri Canali per gestire diversi ambienti di distribuzione
• Esegui l'indagine Comportamento dell'aggiornamento per personalizzare come vengono applicate le aggiornamenti
• Configura Integrazione CI/CD context: Pagina/Area: Capgo Builder / prodotto di costruzione nativa cloud. Ruolo: Etichetta UI breve o elemento di navigazione. Chiave di messaggio `native_build_feature_ci_cd` (Native Build Feature Ci Cd).

per automatizzare il tuo flusso di lavoro di archiviazione personalizzata

Sottosezione intitolata “Continua da Archiviazione Personalizzata” Se stai utilizzando Archiviazione Personalizzata per pianificare la sicurezza e la conformità, connettila con Crittografia Conformità per il dettaglio 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, e Capgo Centro di Trust per il flusso di lavoro del prodotto in Capgo Centro di Trust